About This Guide
Prev |  | Next

## About This Guide

Indigo2 IMPACT Video™ is a video option that provides a Silicon Graphics® Indigo2 IMPACT™ workstation with the ability to input and output graphic and video images and record them to disk or videotape.

Indigo2 IMPACT fully utilizes all calls and controls in the Silicon Graphics Digital Media library, such as the Video Library, as well as controls that are native to Indigo2 IMPACT Video only.

This guide explains features of the Video Library™ (VL) and gives step-by-step instructions for creating VL programs that make use of the Indigo2 IMPACT Video capabilities.

## Audience

This guide is written for the sophisticated video user with a background in C programming who wishes to develop video programs for Indigo2 IMPACT Video capabilities.

## Structure of This Document

This guide contains the following chapters and appendixes:

- Chapter 1, “Features of Indigo2 IMPACT Video,” introduces the features and capabilities of the Indigo2 Video board for Indigo2 IMPACT Video. 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 Indigo2 IMPACT Video 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 Indigo2 IMPACT Video programs by specifying connectivity and avoiding dynamic switching problems. It explains connectivity for Indigo2 IMPACT Video 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 Indigo2 IMPACT Video.

- Chapter 8, “Using Optional Color-Space Conversion,” describes features of the color-space conversion node (available if the color-space conversion option board is installed) and explains how to perform standard and nonstandard color-space conversions.

- Chapter 9, “Using Optional Video Texture Mapping,” describes features of the texture nodes (available if the color-space conversion option board is installed) and explains how to capture video fields into the Indigo2 IMPACT graphics texture memory, from where they can be used as textures, just like images loaded into texture memory.

- Appendix A, “Video Basics,” introduces basic video concepts.

- Appendix B, “Return Codes,” lists and explains VL return messages for Indigo2 IMPACT Video.

- Appendix C, “Indigo2 IMPACT Video Nodes and Their Controls,” gives information on the Indigo2 IMPACT Video nodes and their controls.

- Appendix D, “Indigo2 IMPACT Video Color-Space Conversions,” explains Indigo2 IMPACT Video color spaces, mathematical operations performed during conversions, and implications of color-space conversions.

A glossary and an index complete this guide.

## Conventions

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` |  | Error messages, prompts, and onscreen text
`Bold fixed-width type` |  | User input, including keyboard keys (printing and nonprinting); literals supplied by the user in examples, code, and syntax statements (see also <>)
“” |  | (Double quotation marks) Onscreen menu items and references in text to document section titles
[] |  | (Brackets) Surrounding optional syntax statement arguments
<> |  | (Angle brackets) Surrounding nonprinting keyboard keys, for example, `<Esc>`, `<Ctrl-D>`

Prev | Table of Contents | Next
Indigo2 IMPACT Video™ Programmer's Guide |  | Chapter 1. Features of Indigo2 IMPACT Video