NVIDIA Corporation
76  Quadro FX 4800/5800 and Quadro CX SDI User’s Guide– Version 1.0
C
HAPTER 5
API Control
FRAMELOCK).
IfyouspecifyGENLOCKorFRAMELOCK,youshouldalsospecify
NV_CTRL_GVO_SYNC_SOU RCE.
• UseNV_CTRL_GVO_SYNC_INPUT_DETECTEDand
NV_CTRL_GVO_SDI_SYNC _INPU T_DETECTED todetectwhatinputsyncsare
present.
Ifnoanalogsyncisdetectedbutitisknownthatavalidbi‐levelortri‐levelsyncis
connected,setNV_CTRL_GVO_COMPOSITE_SYNC_INPUT_DETECT_MODE
appropriatelyandretestwith
NV_CTRL_GVO_COMPOSITE_ SYNC_INPUT_DETECTED
.
• Ifsyncingtoinputsync,querytheNV_CTRL_GVO_INPUT_VIDEO_FORMAT
attribute.
TheinputvideoformatcanonlybequeriedafterSYNC_SOURCEisspecified.
• SpecifytheNV_CTRL_GVO_OUTPUT_VIDEO_FORMAT.
• SpecifytheNV_CTRL_GVO_DATA_FORMAT.
• SpecifyanycustomColorSpaceConversion(CSC)matrix,offset,andscalewith
XNVCTRLSetGvoColorConversion().
• IfusingtheGLX_NV_video_outextensiontodisplayoneor
morepbuffers,call
glXGetVideoDeviceNV()tolocktheGVOoutputforusebytheGLXclient,then
bindthepbuffer(s)totheGVOoutputwithglXBindVideoImageNV()andsend
pbufferstotheGVOoutputwithglXSendPbufferToVideoNV().
SeetheGLX_NV_video_outspecformoredetails.
• If,ratherthanusingtheGLX _NV_video_outextensiontodisplayGLX
pbufferson
theGVOoutput,youwishdisplaytheXscreenontheGVOoutput,set
NV_CTRL_GVO_DISPLAY_X_SCREENto
NV_CTRL_GVO_DISPLAY_X_SCREEN_ENABLE.
• SettingmostGVOattributesonlycausesthevaluetobecachedintheXserver.
Thevalueswillbeflushedtothehardwareeitherwhen
NV_CTRL_GVO_DISPLAY_X_SCREENisenabled,orwhen
aGLXpbufferisboundto
theGVOoutput(withglXBindVideoImageNV()).
• GLX_NV_video_outandNV_CTRL_GVO_DISPLAY_X_SCREENaremutually
exclusive.
IfNV_CTRL_GVO_DISPLAY_X_SCREENisenabled,thenglXGetVideoDeviceNVwill
fail.Similarly,ifaGLXclienthaslockedtheGVOoutput(viaglXGetVideoDeviceNV),
thenNV_CTRL_GVO_DISPLAY_X_SCREENwillfail.The
NV_CTRL_GVO_GLX_LOCKEDeventwillbesentwhenaGLXclient
lockstheGVO
output.