The SunVideo(TM) subsystem is a real-time video capture and compression
subsystem. It consists of an SBus card for Sun
Along with the XIL Imaging Library, the SunVideo subsystem is a key component in a range of video conferencing and multimedia applications. The XIL library is a foundation library that supports a range of video and imaging requirements. The XIL Imaging library provides functions that support the SunVideo subsystem's video capture and compression operations. The SunVideo release includes prototype programs that use the XIL Imaging Library to demonstrate the capabilities of the SunVideo subsystem. The XIL packages required to use the SunVideo subsystem are discussed in Chapter 2, "Software Installation."
This book, the SunVideo User's Guide, provides an introduction to the SunVideo subsystem, software and hardware installation instructions, and instructions for running the SunVideo demonstration software. Following that is information about how to use XIL functions to access and control the video capture and compression facilities of the SunVideo subsystem. Samples of code are provided, along with descriptions of the SunVideo subsystem's XIL attributes.
This book contains information for SunVideo end users and for software developers who are using the XIL Imaging Library to develop applications that take advantage of the SunVideo subsystem.
If you're using a SunVideo subsystem in conjunction with a third-party software package, you need to read only the first four chapters of this book. Chapter 1 introduces the SunVideo subsystem. Chapter 2 provides instructions for installing the XIL and SunVideo software. Chapter 3 provides instructions for installing the SunVideo card and shows you how to connect video devices, such as video cameras, to the card. Chapter 4 tells you how to run the window- based SunVideo demonstration program that's included with the release.
For software developers, the book provides information about how to use XIL functions with the SunVideo subsystem. As a software developer, you can focus on Chapters 5 through 10, which tell you how to run the example software and describe how XIL works with the SunVideo subsystem. We assume that you are familiar with the XIL video capture and compression concepts, functions, and programming techniques that are described in the XIL Programmer's Guide.
This manual is organized as follows:
For complete information about installing the SunVideo card, you should refer to the Installation Guide or the Hardware Owner's Guide that is shipped with your system unit. These books contain a chapter that tells you how to install SBus cards.
For information about XIL, refer to the XIL Programmer's Guide, which is provided with the AnswerBook online documentation. This book explains how to use XIL functions to develop application programming interfaces (APIs) and end-user applications.
A companion to the XIL Programmer's Guide is the XIL Reference Manual, which is also provided on AnswerBook. The reference manual contains man pages for all of the functions in the XIL library.
For information about the XIL device driver for the SunVideo card, refer to the SUNWrtvc(3) man page that is included with the SunVideo release.
Because programming with the XIL library can be closely tied to programming with the X library, you may also find it useful to consult the Xlib Programming Manual and the Xlib Reference Manual.
The following table describes the type changes and symbols used in this book.
Table P-1 Typographic Conventions
---------------------------------------------------------------------------------------------------------------------------------------------
Typeface or Meaning Example Symbol ---------------------------------------------------------------------------------------------------------------------------------------------
AaBbCc123 The names of commands, files, Edit your .login file.
and directories; on-screen
computer output Use ls -a to list all files.
system% You have mail.
AaBbCc123 What you type, contrasted with system% su
on-screen computer output
Password:
AaBbCc123 Command-line placeholder: To delete a file, type rm filename.
replace with a real name or
value
AaBbCc123 Book titles, new words or terms, Read Chapter 6 in User's Guide.
or words to be emphasize These are called class options.
You must be root to do this.
Code samples are included in boxes and may display the following:
% UNIX C shell prompt system%
$ UNIX Bourne and Korn shell system$
prompt
# Superuser prompt, all shells system#
---------------------------------------------------------------------------------------------------------------------------------------------
When procedures requiring special care or proximity to electrical currents must be performed, the following international symbols appear in this book:
Caution -
