Nvidia Quadro FX 5500 - Manual (Page 70)

NVIDIA Corporation
66 Quadro FX 4500/5500 SDI User’s Guide– Version 2.0
C HAPTER 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 the NV_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.