The OCTANE™ Digital Video option board lets a Silicon Graphics® O2™ (OCTANE) workstation input and output graphic and video images and record them to disk or videotape.
The OCTANE Digital 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 Digital Video option and gives step-by-step instructions for creating VL programs that make use of the OCTANE Digital Video capabilities.
This guide is written for the sophisticated video user with a background in C programming who wishes to develop video programs for OCTANE Digital Video capabilities.
This guide contains the following chapters and appendixes:
Chapter 1, “Features of the OCTANE Digital Video Option,” introduces the features and capabilities of the OCTANE Digital Video board. It explains VL features and architecture, and presents the VL programming model.
Chapter 2, “Creating Video Programs With the Video Library,” explains how to open a connection to the video daemon and set up a data path, how to set data transfer parameters, how to display video data onscreen, how to transfer video data, and how to end data transfer by presenting an annotated sample program that displays live video input in a graphics window.
Chapter 3, “Using VL Controls,” explains VL control type and values, VL control fraction ranges, VL control classes, and VL control groupings.
Chapter 4, “Event Handling,” presents the VL events for the OCTANE Digital Video option and details querying VL events, creating a VL event loop, and creating a main loop with callbacks.
Chapter 5, “Managing Connections,” explains how to set up more complex paths in OCTANE Digital Video programs by specifying connectivity and avoiding dynamic switching problems. It explains connectivity for the OCTANE Digital Video option by presenting details of board and software architecture.
Chapter 6, “Video Real-Time Capture and Playback,” gives guidelines for optimizing capture or playback to system memory or disk.
Chapter 7, “Blending, Keying, and Transitions,” explains how to use VL to perform chroma keying, luma keying, alpha keying, and transitions. It explains the blend node, keying, the keyer, and blending controls for the OCTANE Digital Video option.
Chapter 8, “Using Color-Space Conversion,” describes features of the color-space conversion node and explains how to perform standard and nonstandard color-space conversions.
Chapter 9, “Using Video Texture Mapping,” describes features of the texture nodes and explains how to capture video fields into the O2 graphics texture memory, from where they can be used as textures, just like images loaded into texture memory.
Appendix A, “Return Codes,” lists and explains VL return messages for the OCTANE Digital Video board.
Appendix B, “OCTANE Digital Video Nodes and Their Controls,” gives information on the OCTANE Digital Video nodes and their controls.
Appendix C, “OCTANE Digital Video Color-Space Conversions,” explains OCTANE Digital Video color spaces, mathematical operations performed during conversions, and implications of color-space conversions.
A glossary and an index complete this guide.
The following documents are also included with the OCTANE Digital Video option:
OCTANE Digital Video and OCTANE Compression Owner's Guide (007-3466-001)
Digital Media Programming Guide (007-1799-060) (online only)
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 |