The OCTANE XIO Personal Video option board enables a Silicon Graphics OCTANE workstation to input and output graphic and video images and record them to disk or videotape.
The OCTANE Personal Video option utilizes calls and controls in the Silicon Graphics Digital Media library, such as the Video Library. This guide explains features of the Video Library (VL) that pertain to the OCTANE Personal Video option and gives step-by-step instructions for creating VL programs that make use of OCTANE Personal Video capabilities.
This guide is written for the sophisticated video user with a background in C programming who wishes to develop video programs for the OCTANE Personal Video option board.
This guide contains the following chapters and appendixes:
Chapter 1, “Features of the OCTANE Personal Video Option,” introduces the features and capabilities of the OCTANE Personal Video board. It explains VL features and architecture, and presents the VL programming model.
Chapter 2, “Setting Up Your VL Application,” explains how to open a connection to the video daemon, specify nodes, and set up a data path. It also summarizes the VL programming model.
Chapter 3, “Setting Parameters for Data Transfer,” explains how to use controls for defining frame data size, video format and timing, color space, scaling, and other basic parameters.
Chapter 4, “Synchronizing Data Streams and Signals,” gives instructions for using special signals—unadjusted system time (UST), media stream count (MSC), and Internal Video Sync signal—for refining synchronization in your application.
Chapter 5, “Transferring Video Data and Ending Data Transfer,” explains using buffers for transferring video data, gives the steps for ending data transfer, and summarizes example programs that illustrate how to create simple video applications included in the software.
Chapter 6, “Using VL Controls,” explains the VL control type and values, VL control fraction ranges, VL control classes, and VL control groupings.
Chapter 7, “Event Handling,” presents the VL events for the OCTANE Personal Video option and details querying VL events, creating a VL event loop, and creating a main loop with callbacks.
Chapter 8, “Video Real-Time Capture and Playback,” gives guidelines for optimizing capture or playback to system memory or disk.
Appendix A, “Return Codes,” lists and explains VL return messages for the OCTANE Personal Video board.
Appendix B, “OCTANE Personal Video Nodes and Their Controls,” summarizes the OCTANE Personal Video nodes and their controls.
Appendix C, “Pixel Packings and Color Spaces,” sets forth all packing formats used by the OCTANE Personal Video option and includes information on sampling patterns.
Appendix D, “OCTANE Personal Video Color-Space Conversions,” explains color spaces, mathematical operations performed during conversions, and implications of color-space conversions.
An index completes this guide.
The Digital Media Programming Guide (007-1799-060; online only) is available with the IRIX digital media development environment software (dmedia_dev). This guide is also online in the following locations:
IRIS InSight Library: from the Toolchest, choose Help > Online Books > SGI EndUser or SGI Admin, and select the applicable owner's or hardware guide.
Once you are in the library, choose Catalogs > Hardware Catalog > and look under the Owner's Guides for the applicable owner's guide.
Technical Publications Library: if you have access to the Internet, enter the following URL in your Web browser location window:
http://techpubs.sgi.com/library/
These type conventions and symbols are used in this guide:
| Helvetica Bold | Hardware labels | |
| Italics | Executable names, filenames, IRIX commands, manual or book titles, new terms, program variables, tools, utilities, variable command-line arguments, variable coordinates, and variables to be supplied by the user in examples, code, and syntax statements | |
| Bold | Function names | |
| Fixed-width type |
| |
| Bold fixed-width type |
| |
| “” | (Double quotation marks) Onscreen menu items and references in text to document section titles | |
| [] | (Brackets) Surrounding optional syntax statement arguments |