This chapter describes how to use the SunVideo Plus subsystem with existing software applications that use the Sun Microsystems XIL library and the SBus SunVideo card. This enables you to use a SunVideo Plus card to run SunVideo demonstration programs and applications such as Sun's ShowMe desktop videoconferencing products and ShowMe TV audio/video broadcasting product.
For using your Sun applications, refer to the user's guide provided with your Sun application product. For example, refer to the SunVideo User's Guide for using the SunVideo Demonstration Programs, or ShowMe TV User's Guide for use of the ShowMe TV program.
Sun PCI desktop workstation
XIL Imaging Library installed on your workstation
SunVideo Plus does not provide hardware-based MPEG1 I-B-P compression and XIL does not provide a software-based compressor, Therefore, programs relying on these capabilities will fail. Also, SunVideo Plus MPEG1 encodes non-square-pixel video, so applications expecting MPEG1 in square-pixel format will fail.
Error messages for SunVideo Plus are slightly different from SunVideo, so a program relying on trapping a particular error may not work.
SunVideo Plus's XIL compatibility is the same as that of the XIL library. Applications that make calls directly to the SunVideo driver may not work correctly.
If SunVideo Plus does not provide hardware acceleration for a given XIL molecule, the operation may be performed partly in software. This is currently true for some compression/resolution combinations.
SunVideo Plus supports the JPEG, CellB, and MPEG-1 (I frame) codes under compatibility mode. It also supports the uncompressed formats. SunVideo Plus does NOT support H.261 or MPEG1 (IPB frame) in compatibility mode.
In SunVideo Compatibility (SVC) mode, you can also use the record and playback features of the SunVideo Tool demonstration program that is included in Solaris 2.5.1 and Solaris 2.6.
To set the SunVideo Plus card into SunVideo Compatibility mode:
Install the SunVideo Plus card in your workstation.
Install the SunVideo Plus software.
Run the SunVideo Plus Compatibility mode setup scripts.
For Solaris 2.5.1 only, set the XILHOME and LD_LIBRARY_PATH environment variables.
See "Setting SVC Environment Variables (Solaris 2.5.1 only)".
After installing the SunVideo Plus card and software, do the following to run SunVideo Compatibility (SVC) mode setup scripts:
Log in as superuser.
hostname# svc_install hostname# svc_devices (install or remove)
The following table describes the setup scripts.
Table 3-1 SunVideo Plus Setup Scripts
Setup Script |
Description |
---|---|
svc_install |
This script creates the SunVideo Compatibility mode XIL pipeline hierarchy for the SunVideo Plus card. |
svc_devices |
This script creates (svc_devices install) or removes (svc_devices remove) SunVideo Compatibility mode pseudo devices. Pseudo devices are symbolic links from rtvc (SunVideo) devices to o1k (SunVideo Plus) devices. The script places the links into /dev. |
svc_uninstall |
Solaris 2.6 only. Use this script on Solaris 2.6 to remove the svc hierarchy. |
The svc_install script creates the XIL pipeline hierarchy. The default location for the svc_install script is /opt/SUNWo1kp/bin. The syntax is:
hostname% svc_install options
The following table lists and describes the svc_install options and defaults.
Table 3-2 svc_install Options and Defaults
svc_install Options |
Description |
---|---|
-s O1KHOME |
This is the location of the SunVideo Plus source directory. The default location is /opt/SUNWo1kp. |
-t DESTDIR |
This is the destination for the SunVideo Compatibility mode pipeline hierarchy. The default location is /opt/SUNWo1kp/svc. DESTDIR does not need to exist. The hierarchy requires approximately 360 Kbytes. |
-v |
This is Verbose mode which displays status information on stdout. The default does not display information. |
-x XILHOME |
This is the location of the XIL Imaging Library source directory. The default location is /opt/SUNWits/Graphics-sw/xil. |
Typically, you can run the script without any options. You must be logged in as superuser if you do not have write permissions to the DESTDIR directory.
If the svc mode is already installed when svc_install is run, then the previous SVC hierarchy will be removed and then replaced.
You should re-run svc_install any time packages, patches, and so on, are applied to your system that change XIL components.
In Solaris 2.5.1, the SVC hierarchy is a separate entity that is enabled/disabled by the user by setting environment variables. In Solaris 2.6, however, the SVC hierarchy is not a separate entity. Installing the SVC mode in Solaris 2.6 replaces the existing XIL 1.3 directory containing device handlers (XIL 1.3 libraries) with a SVC mode one. Therefore, once the svc_install script is run on Solaris 2.6, SVC mode is enabled and is not controlled by setting environment variables. To disable the SVC mode under Solaris 2.6, use the svc_uninstall script.
hostname% svc_install options
The following table lists and describes the svc_install options and defaults.
Table 3-3 svc_install Options and Defaults
svc_install Options |
Description |
---|---|
-v |
This is Verbose mode which displays status information on stdout. |
Typically, you run the script without any options. You must be logged in as superuser. The script modifies /usr/openwin/xil/lib. You should not run this script if this is an NFS mounted directory.
The svc_uninstall script removes the SVC mode installed by svc_install and puts back the original XIL device handler directory.
Since the SVC mode replaces the standard XIL 1.3 device handler directory, it is VERY important to run svc_uninstall before any updates (that is, patches, upgrades, or new package installations) are applied to your workstation which will change or add XIL components.
hostname% svc_uninstall options
The following table lists and describes the svc_uninstall options and defaults.
Table 3-4 svc_install Options and Defaults
svc_install Options |
Description |
---|---|
-v |
This is Verbose mode which displays status information on stdout. |
Typically, you run the script without any options. You must be logged in as superuser. The script modifies /usr/openwin/xil/lib. You should not run this script if this is an NFS mounted directory.
The svc_devices script creates and removes SunVideo compatibility mode pseudo devices in /dev. The default location for the svc_devices script is /opt/SUNWo1kp/bin. The install script syntax is:
hostname% svc_devices install
hostname% svc_devices remove
Use svc_devices install to install SunVideo Compatibility mode pseudo devices. Use svc_devices remove to remove SunVideo pseudo devices from the /dev directory.
To select a SunVideo Plus card from a SunVideo application program, use the rtvc pseudo device name, typically /dev/rtvc0.
If you use pkgrm to remove the SunVideo Plus software, you do not need to first run the svc_devices remove script. The pkgrm script removes all pseudo devices.
If you move the SunVideo Plus card to a different slot, you must first run svc_devices remove and then run svc_devices install.
Use the special XIL pipelines and SunVideo Plus compatibility features, you must set the XILHOME environment variable to /opt/SUNWo1kp/svc.
You must include DESTDIR/lib in the LD_LIBRARY_PATH environmental variable, where DESTDIR is the destination location for the SunVideo compatibility mode pipeline hierarchy. This is the location specified when the svc_install script was run. The default location for DESTDIR is /opt/SUNWo1kp/svc.
If the XIL library is already in your LD_LIBRARY_PATH, then either DESTDIR/lib must precede LD_LIBRARY_PATH, or the XIL library path must be removed from your LD_LIBRARY_PATH before you attach the new path to LD_LIBRARY_PATH.
The following is an example of attaching DESTDIR/lib using csh shell:
hostname% setenv O1KHOME /opt/SUNWo1kp hostname% setenv LD_LIBRARY_PATH /opt/SUNWo1kp/lib:$LD_LIBRARY_PATH hostname% setenv LD_LIBRARY_PATH /opt/SUNWits/Graphics-sw/lib:$LD_LIBRARY_PATH hostname% setenv XILHOME /opt/SUNWo1kp/svc