NVIDIA FX5500 User Guide - Page 70

CHAPTER 5 API Control Linux CONTROL X Extension API This section describes the NvGvo APIs inthe following sections: • "Using the NV-CTRL X APIs" on page 66 • "NV_CTRL_GVO Attributes" on page 67 • "NV-Control X Functions" on page 76 Using the NV-CTRL X APIs The NV_CTRL_GVO* integer attributes are used to configure GVO (graphics to video out) functionality on the Quadro FX 4500 SDI graphics board. The following is a typical usage pattern for the GVO attributes: • Query NV_CTRL_GVO_SUPPORTED to determine if the X screen supports GV0. • Specify NV_CTRL_GVO_SYNC_MODE (either FREE_RUNNING, GENLOCK, or FRAMELOCK). If you specify GENLOCK or FRAMELOCK, you should also specify NV_CTRL_GVO_SYNC_SOURCE. • Use NV_CTRL_GVO_SYNC_INPUT_DETECTED and NV_CTRL_GVO_SDI_SYNC_INPUT_DETECTED to detect what input syncs are present. If no analog sync is detected but it is known that a valid bi-level or tri-level sync is connected, set NV_CTRL_GVO_COMPOSITE_SYNC_INPUT_DETECT_MODE appropriately and retest with NV_CTRL_GVO_COMPOSITE_SYNC_INPUT_DETECTED. • If syncing to input sync, query theNV_CTRL_GVO_INPUT_VIDEO_FORMAT attribute. The input video format can only be queried after SYNC_SOURCE is specified. • Specify the NV_CTRL_GVO_OUTPUT_VIDEO_FORMAT. • Specify the NV_CTRL_GVO_DATA_FORMAT. • Specify any custom Color Space Conversion (CSC) matrix, offset, and scale with XNVCTRLSetGvoColorConversion(). • If using the GLX_NV_video_out extension to display one or more pbuffers, call glXGetVideoDeviceNV() to lock the GVO output for use by the GLX client, then bind the pbuffer(s) to the GVO output with glXBindVideoImageNV() and send pbuffers to the GVO output with glXSendPbufferToVideoNV(). See the GLX_NV_video_out spec for more details. NVIDIA Corporation 66 Quadro FX 4500/5500 SDI User's Guide- Version 2.0