Nvidia 4500, 5500 API C

NVIDIA Corporation

Quadro FX 4500/5500 SDI User’s Guide – Version 2.0 43

CHAPTER 5

API Control

CHAPTER

API CONTROL

The SDI application programming interface allows OpenGL or Direct3D applications to

have full and exclusive control of the SDI output. This method of controlling the SDI

output is also known as extended mode.

This chapter gives a brief introduction to this method of implementing graphics to SDI,

and includes the following sections:

•“SDI Application Programming Overview” on page44

•“Windows XP NvGvo API Description” on page45

•“Linux CONTROL X Extension API” on page66

Refer to the following documents for additional information on using the APIs:

•Programming the NVIDA Quadro FX 4000/4500 SDI

•The NVGVOSDK , which can be obtained from NVIDIA.

Contents

Main Page Table of Contents 3.WindowsUsing the Graphics to SDI Control Panel . . . . . . . . . . . . . . . . . . . . . 15 4.LinuxUsing the Graphics to Video Out Control Panel . . . . . . . . . . . . . . . . . . 31 Page ABOUT NVIDIA GRAPHICS TO SDI About This Document Other Documents Quadro Workstation Users Guide. System Requirements Revision History NVIDIA GRAPHICS-TO-SDI Feature Overview Output Connections Supported SDI Signal Formats Supported SDI Color Formats Page Installing and Preparing the NVIDIA Quadro FX SDI About Your NVIDIA Quadro FX SDI Cards Cables Cable Bands Kit Installing the NVIDIA Quadro FX SDI Step 1: Install the NVIDIA Quadro FX SDI Step 2: Connect the Auxiliary Cabling and Monitor Step 3: Install the NVIDIA ForceWare Graphics Drivers Operating NVIDIA SDI Understanding the Connections V1 OUTV2 OUTS SYNCC SYNC Connecting the SDI Video Output Connecting to an External Sync Source About the Software Using the SDI APIs SDI Using the Control Panel Recommended Operating Practices Initial On-Air Broadcast Changing Applications Changing Video Formats When Using the Control Panel Running Multiple OpenGL Applications WINDOWSUSING THE GRAPHICS TO SDI C How to Set Up the SDI Output Basic SDI Setup Step 1: Enable the Graphics to SDI Property Page Step 2: Choose a Synchronization Method Step 3: Specify the SDI Signal Format Step 4: Specify the SDI Output Format Step 5: Apply and Verify the Changes Page Advanced Adjustments Adjusting the Desktop Area Page Applying Gamma Correction Synchronizing the SDI Output to an External Source Genlock Versus Frame Lock Using Genlock Using Frame Lock Supported Synchronization Signals Synchronization Instructions Basic Setup Summary Detecting the External Sync Signal Source If you have both SDI and Composite signals connected - If the software fails to automatically detect the signal - Adding a Delay to the Signal Viewing System Information Using SDI Under Dualview About Dualview Mode How to Enable Dualview Mode Changing SDI Settings Under Dualview Page LINUXUSING THE GRAPHICS TO VIDEO OUT CONTROL PANEL How to Set Up the SDI Output Basic SDI Setup Step 1: Open the NVIDIA Graphics to Video Out Property Page Step 2: Choose a Synchronization Method Step 3: Choose the Output Options Step 4: Verify the Changes Page Advanced Adjustments Adjusting the Desktop Area Customizing the Color Space Conversion Synchronizing the SDI Output to an External Source Genlock Versus Frame Lock Using Genlock Using Frame Lock Supported Synchronization Signals Synchronization Instructions Basic Setup Summary Detecting the External Sync Signal Source If you have both SDI and Composite signals connected - If the software fails to automatically detect the signal - Adding a Delay to the Signal Page API C SDI Application Programming Overview Windows XP NvGvo API Description Viewing the SDI Hardware Status NvGvo Function Description NvGvoCaps() NvGvo Function Index Call Description NvGvoOpen() NvGvoClose() NvGvoDesktopOpen() NvGvoDesktopClose() NvGvoStatus() NvGvoSyncFormatDetect() NvGvoConfigGet() NvGvoConfigSet() NvGvoIsRunning() NvGvoStart() NvGvoStop() NvGvoEnumSignalFormats() NvGvoIsFrameLockModeCompatible() NvGvoEnumDataFormats() NvGvo Structures, Enumerations, and Defines Miscellaneous Defines Video Signal Format and Resolution Enumeration Page SMPTE Standards Format Enumeration HD or SD Video Type Enumeration Interlace Mode Enumeration Video Data Format Enumeration Video Output Area Enumeration Synchronization Source Enumeration Composite Synchronization Type Enumeration Video Output Status Enumeration Synchronization Input Status Enumeration Device Capabilities Defines Device Capabilities Structure Device Status Structure Output Region Structure Gamma Ramp (8-bit Index) Structure Gamma Ramp (10-bit Index) Structure Sync Delay Structure Video Mode Information Structure Signal Format Details Structure P-Buffer Format Defines Data Format Details Structure Device Configuration Defines masks indicating NVGVOCONFIG fields to use for dwFields These are NvGvoGet/Set/ Test/CreateDefaultConfig() . Device Configuration Structure Device ConfigurationRevision 0 Structure Page Linux CONTROL X Extension API Using the NV-CTRL X APIs NV_CTRL_GVO Attributes NV_CTRL_GVO_SUPPORTED NV_CTRL_GVO_SYNC_MODE NV_CTRL_GVO_SYNC_SOURCE NV_CTRL_GVO_OUTPUT_VIDEO_FORMAT Page NV_CTRL_GVO_INPUT_VIDEO_FORMAT NV_CTRL_GVO_DATA_FORMAT NV_CTRL_GVO_DISPLAY_X_SCREEN NV_CTRL_GVO_COMPOSITE_SYNC_INPUT_DETECTED NV_CTRL_GVO_COMPOSITE_SYNC_INPUT_DETECT_MODE NV_CTRL_GVO_SYNC_INPUT_DETECTED NV_CTRL_GVO_VIDEO_OUTPUTS NV_CTRL_GVO_FPGA_VERSION NV_CTRL_GVO_SYNC_DELAY_PIXELS NV_CTRL_GVO_SYNC_DELAY_LINES NV_CTRL_GVO_INPUT_VIDEO_FORMAT_REACQUIRE NV_CTRL_GVO_LOCKED NV_CTRL_GVO_VIDEO_FORMAT_{WIDTH,HEIGHT,REFRESH_RATE} NV_CTRL_GVO_X_SCREEN_PAN_[XY] NV-Control X Functions XNVCTRLQueryExtension() XNVCTRLQueryVersion() XNVCTRLIsNvScreen() XNVCTRLSetAttribute() XNVCTRLSetAttributeAndGetStatus() XNVCTRLQueryAttribute() XNVCTRLQueryStringAttribute() XNVCTRLSetStringAttribute() XNVCTRLQueryValidAttributeValues() XNVCTRLSetGvoColorConversion() XNVCTRLQueryGvoColorConversion() Page A O DIP S OARD B N