Picolo HD. MultiCam for Picolo HD Driver Picolo HD 3G DVI. EURESYS s.a Document version built on

Transcription

1 HANDBOOK Picolo HD MultiCam for Picolo HD Driver Picolo HD 3G DVI EURESYS s.a Document version built on

2 EURESYS s.a. shall retain all property rights, title and interest of the documentation of the hardware and the so ware, and of the trademarks of EURESYS s.a. All the names of companies and products mentioned in the documentation may be the trademarks of their respective owners. The licensing, use, leasing, loaning, translation, reproduction, copying or modification of the hardware or the so ware, brands or documentation of EURESYS s.a. contained in this book, is not allowed without prior notice. EURESYS s.a. may modify the product specification or change the information given in this documentation at any time, at its discretion, and without prior notice. EURESYS s.a. shall not be liable for any loss of or damage to revenues, profits, goodwill, data, information systems or other special, incidental, indirect, consequential or punitive damages of any kind arising in connection with the use of the hardware or the so ware of EURESYS s.a. or resulting of omissions or errors in this documentation.

3 Contents 1843 Picolo HD 3G DVI Handbook Contents Product Composition... 8 System Requirements... 8 Mechanical Specification Product Pictures Dimensions and Weight Connectors Connectors Location Electrical Specification Power Requirements Audio/Video Inputs DVI-D Digital Video Input DVI-A Analog Video Inputs YPbPr Analog Video Inputs S-Video and CVBS Analog Video Inputs Analog Audio Inputs General Purpose I/O Watchdog Switch Environmental Specification...24 Storage Conditions Operating Conditions Compliance Functional Specification...26 Audio/Video Source Selection Audio/Video Interfaces DVI-D Video Interface...27 DVI-A Video Interface...28 YPbPr Analog Video Interface S-Video and CVBS Analog Video Interface Analog Audio Interface...29 Audio/Video Delivery iii

4 1843 Picolo HD 3G DVI Handbook Contents I/O Functional Specifications...31 Watchdog So ware Specification MultiCam for Picolo HD Driver...33 MultiCam for Picolo HD API MCHD C API s Initialize/terminate MchdInitialize() MchdTerminate()...35 Board MchdCreateBoard()...35 MchdDeleteBoard() MchdGetBoardType()...37 MchdSetOemKey() MchdCheckOemKey() Video Acquisition MchdCreateVideoChannel()...39 MchdCreateSogVideoChannel...40 MchdCreateSdVideoChannel() MchdDeleteVideoChannel()...42 MchdRegisterVideoChannelCallback() MchdGetVideoChannelResolution()...44 MchdGetVideoChannelColorFormat() MchdGetVideoChannelInput()...45 MchdGetVideoChannelSignalState...46 MchdGetVideoChannelSyncOnGreenState MchdGetVideoChannelFrameRate() MchdSetVideoChannelHue() MchdGetVideoChannelHue()...48 MchdSetVideoChannelSaturation() MchdGetVideoChannelSaturation()...49 MchdSetVideoChannelGamma()...50 MchdGetVideoChannelGamma() MchdSetVideoChannelContrast()...51 MchdGetVideoChannelContrast() MchdSetVideoChannelBrightness() MchdGetVideoChannelGamma() MchdSetVideoChannelSharpness() MchdGetVideoChannelSharpness() MchdGetVideoChannelVideoPresence MchdStartVideoChannel() MchdStopVideoChannel()...56 MchdSaveSurfaceToJpegFile() iv

5 Contents 1843 Picolo HD 3G DVI Handbook Audio Acquisition...57 MchdCreateAudioChannel() MchdDeleteAudioChannel() MchdRegisterAudioChannelCallback() MchdGetAudioChannelInput() MchdGetAudioChannelSampleRate() MchdStartAudioChannel()...61 MchdStopAudioChannel() I/O MchdGetIoDirection() MchdSetIoDirection()...63 MchdGetIoState() MchdSetIoState() Types Definitions MCHD_AUDIO_CALLBACK...65 MCHD_AUDIO_CALLBACK_INFO MCHD_AUDIO_CHANNEL...66 MCHD_AUDIO_FRAME...66 MCHD_AUDIO_INPUT MCHD_AUDIO_SAMPLE_RATE MCHD_BOARD MCHD_BOARD_TYPE...67 MCHD_IO_DIRECTION...67 MCHD_IO_STATE MCHD_STATUS MCHD_VIDEO_CALLBACK MCHD_VIDEO_CALLBACK_INFO MCHD_VIDEO_CHANNEL MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE MCHD_VIDEO_COLOR_FORMAT MCHD_VIDEO_INPUT MCHD_VIDEO_PRESENCE...71 MCHD_VIDEO_RESOLUTION...71 MCHD_VIDEO_SIGNAL_STATE MCHD_VIDEO_STANDARD MCHD_VIDEO_SURFACE MCHD_VIDEO_SYNC_ON_GREEN_STATE Kernel Streaming API...74 Board Identifiers Property Access Procedure Custom Property Identifiers...75 De-interlacing...75 Video Input...75 Frame Rate Resolution v

6 1843 Picolo HD 3G DVI Handbook Contents Denoising...77 Video Flexible Resolution...77 Sync On Green Analog Audio Input Type H.264 Encoder Bit Rate H.264 Encoder Bit Rate Mode...79 H.264 Encoder Profile...79 Privacy Mask H.264 OSD Text Path I/O Direction...81 I/O State Appendix MultiCam for Picolo HD Driver Installation...83 DirectShow Filter Graph Setup Example Precautions for Use of Board Products vi

7 1843 Picolo HD 3G DVI Handbook Picolo HD Cards Overview The Picolo HD cards, namely Picolo HD One, Picolo HD 3G, Picolo HD H.264 and Picolo HD 3G DVI, are PCI Express capture cards capable of acquiring audio and video from one audio/video source using various types of audio/video interfaces. Picolo HD One, Picolo HD 3G, and Picolo HD H.264 offer the following audio/video interfaces: SDI and HDMI for connecting a high-definition digital audio/video source DVI-D for connecting a high-definition digital video source DVI-A and Y/Pb/Pr for connecting a high-definition analog video source L/R for connecting a line-level analog stereo audio source Picolo HD 3G DVI offers the following audio/video interfaces: DVI-D for connecting a high-definition digital video source DVI-A and Y/Pb/Pr for connecting a high-definition analog video source S-Video for connecting a standard-definition analog Y/C video source CVBS for connecting a standard-definition analog composite video source L/R for connecting a line-level analog stereo audio source The Picolo HD cards support the following image resolutions and frame rates: HD 1080p up to 30fps HD 1080i up to 60 fps HD 1080p up to 60fps (for Picolo HD 3G and Picolo HD 3G DVI only) HD 720p up to 60 fps SD 525i60 and 625i50 (for Picolo HD 3G DVI only) Picolo HD H.264 implements the following exclusive features: H.264 Baseline and Main Profile video compression Multi-stream video delivery: 2 compressed video streams + 1 uncompressed video Video de-interlacing and de-noising On-screen display The Picolo HD cards also feature: Two-channel high-quality (16-bit, 32/44.1/48 khz) audio capture. 16 general purpose I/O lines A watchdog reset switch The Picolo HD cards come with a Microso Windows driver named MultiCam for Picolo HD. It provides: A DirectShow API offering compatibility with third-party applications based on DirectShow. An easy-to-use proprietary C API 7

8 1843 Picolo HD 3G DVI Handbook Product Composition The product is commercially referenced as: Product Code 1843 Product Designation Picolo HD 3G DVI Deliverables The product is delivered in a single carton box including the following elements: Quantity Short 1 Picolo HD 3G DVI card 1 Bypass plug-in module Bracket set including: 1 2 Single-slot standard profile brackets 2 Single-slot low profile brackets Cable set including: Y/Pb/Pr/L+R analog audio/video cables 2 S-Video/CVBS/L/R analog audio/video cables 1 Watchdog cable Picolo HD Series Installation Guide System Requirements Software requirements Picolo HD Product MCHD Driver Version PC1840 Picolo HD One (S/N up to PHO01435) 1.0 or higher PC1840 Picolo HD One (S/N PHO01436 and higher) 3.0 or higher PC1841 Picolo HD 3G 1.0 or higher PC1842 Picolo HD H or higher PC1843 Picolo HD 3G DVI 3.0 or higher Hardware Requirements Processors 8 Minimum Recommended Core 2 Duo or better Intel 2nd/ 3rd Generation Core i3/i5/i7 processors

9 1843 Picolo HD 3G DVI Handbook Minimum Recommended System Memory 2GB DDR3 4GB DDR3 (dual channel) or better Graphic Card Supports DirectX 9 or higher Intel HD2000/2500/3000/4000 or better PCI Interface PCIe 2.0 Operating Systems Operating System Version / Service Pack Processor Architecture MCHD Driver Version Microso Windows XP / SP3 x86 (32-bit) 1.0 or higher Microso Windows 7 / SP1 x86 (32-bit) 1.0 or higher Microso Windows 7 / SP1 x86-64 (64-bit) 1.0 or higher Microso Windows Server 2008 R2 / SP1 x86-64 (64-bit) 1.0 or higher Microso Windows 8 x86 (32-bit) 2.0 or higher Microso Windows 8 x86-64 (64-bit) 2.0 or higher Microso Windows Server 2012 x86-64 (64-bit) 2.0 or higher Note: Refer to the MultiCam for Picolo HD Release Notes for an up-to-date list of supported operated systems. 9

10 1843 Picolo HD 3G DVI Handbook Mechanical Specification Mechanical Specification Product Pictures This section shows the 4 physical configurations of Picolo HD 3G DVI: Picolo HD 3G DVI with standard bracket Picolo HD 3G DVI with standard brackets and bypass plug-in module Picolo HD 3G DVI with low-profile bracket Picolo HD 3G DVI with low-profile brackets and bypass plug-in module Figure 1: Picolo HD 3G DVI with standard bracket 10

11 Mechanical Specification 1843 Picolo HD 3G DVI Handbook Figure 2: Picolo HD 3G DVI with standard brackets and bypass plug-in module Figure 3: Picolo HD 3G DVI with low-profile bracket 11

12 1843 Picolo HD 3G DVI Handbook Mechanical Specification Figure 4: Picolo HD 3G DVI with lowprofile brackets and bypass plug-in module Dimensions and Weight Dimensions Value [mm] Value [inches] Card length (excluding bracket and bracket connectors) Card height (including PCI Express connector) Y/Pb/Pr/L/R component cable length S-Video/CVBS/L/R component cable length Watchdog cable length Value [g] Value [lb] Picolo HD 3G DVI weight Bypass module weight Y/Pb/Pr/L/R component cable weight S-Video/CVBS/L/R component cable weight Watchdog cable weight Characteristic Weight Characteristic 12

13 Mechanical Specification 1843 Picolo HD 3G DVI Handbook Connectors Y/Pb/Pr/L+R analog audio/video cable: Y Input Connector Figure 5: Green 2-pin female receptacle, cable-mount, RCA connector Pin Signal Usage Center Y IN Y component analog video input Outer GND Signal ground Y/Pb/Pr/L+R analog audio/video cable: Pb Input Connector Figure 6: Blue 2-pin female receptacle, cable-mount, RCA connector Pin Signal Usage Center Pb IN Pb component analog video input Outer GND Signal ground Y/Pb/Pr/L+R analog audio/video cable: Pr Input Connector Figure 7: Red 2-pin female receptacle, cable-mount, RCA connector Pin Signal Usage Center Pr IN Pr component analog video input Outer GND Signal ground Y/Pb/Pr/L/R Components Cable: Audio Left + Right Inputs Connector Figure 8: Twin white and red 2-pin female receptacle, cable-mount, RCA connectors Pin Signal Usage White Center L IN Le channel analog audio input White Outer GND Signal ground Red Center R IN Right channel analog audio input Red Outer GND Signal ground 13

14 1843 Picolo HD 3G DVI Handbook Mechanical Specification S-Video/CVBS/L/R analog audio/video cable: S-Video Input Connector Figure 9: 4-pin female receptacle, right-angled PCB-mount, shielded Mini-DIN connector connector Pin Signal Usage 1 GND Signal ground 2 GND Signal ground 3 Y IN Y component analog video input 4 C IN C component analog video input S-Video/CVBS/L/R analog audio/video cable: CVBS Input Connector Figure 10: Yellow 2-pin female receptacle, cable-mount, RCA connector Pin Signal Usage Center CVBS IN Analog composite video input Outer GND Signal ground S-Video/CVBS/L/R analog audio/video cable: Left Audio Input Connector Figure 11: White 2-pin female receptacle, cable-mount, RCA connector Pin Signal Usage Center L IN Le channel analog audio input Outer GND Signal ground S-Video/CVBS/L/R analog audio/video cable: Right Audio Input Connector Figure 12: Red 2-pin female receptacle, cable-mount, RCA connector 14 Pin Signal Usage Center R IN Right channel analog audio input Outer GND Signal ground

15 Mechanical Specification 1843 Picolo HD 3G DVI Handbook DVI-I Input Connector Figure 13: DVI-I socket(female) connector Pin Signal Usage 1 TMDS Data2- Digital red video input 2 TMDS Data2+ Digital red video input 3 TMDS Data 2/4 Shield 4 TMDS Data4- Digital green video input (link 2) 5 TMDS Data4+ Digital green video input (link 2) 6 SCL DDC serial clock 7 SDA DDC serial data 8 VSYNC Analog vertical sync input 9 TMDS Data1- Digital green video input 10 TMDS Data1+ Digital green video input 11 TMDS Data 1/3 Shield 12 TMDS Data3- Digital blue video input (link 2) 13 TMDS Data3+ Digital blue video input (link 2) Ground 16 HPD 17 TMDS Data0- Digital blue video input and digital sync 18 TMDS Data0+ Digital blue video input and digital sync 19 TMDS Data 0/5 Shield 20 TMDS Data5- Digital red video input (link 2) 21 TMDS Data5+ Digital red video input (link 2) 22 TMDS Clock Shield 23 TMDS Clock+ Digital video clock 24 TMDS Clock- Digital video clock C1 R Analog red video input C2 G Analog green video input C3 B Analog blue video input C4 HSYNC Analog horizontal sync Shield Shield Ground Hot Plug Detect Shield 15

16 1843 Picolo HD 3G DVI Handbook Mechanical Specification Pin Signal C5 AGND Shell Chassis ground Usage Analog Ground Shield I/O Connector Figure 14: 20-pin dual-row 0.1" pitch pin header without shrouding 16 Pin Signal Usage 1 GND Signal ground 2 GND Signal ground 3 IO09 General Purpose I/O 4 IO01 General Purpose I/O 5 IO10 General Purpose I/O 6 IO02 General Purpose I/O 7 IO11 General Purpose I/O 8 IO03 General Purpose I/O 9 IO12 General Purpose I/O 10 IO04 General Purpose I/O 11 IO13 General Purpose I/O 12 IO05 General Purpose I/O 13 IO14 General Purpose I/O 14 IO06 General Purpose I/O 15 IO15 General Purpose I/O 16 IO07 General Purpose I/O 17 IO16 General Purpose I/O 18 IO08 General Purpose I/O 19 GND Signal ground 20 GND Signal ground

17 Mechanical Specification 1843 Picolo HD 3G DVI Handbook WATCHDOG-1 Connector 2 1 Figure 15: 2-pin 0.1" pitch pin header without shrouding Pin Signal Usage 1 WATCHDOG RESET A Watchdog reset switch 2 WATCHDOG RESET B Watchdog reset switch WATCHDOG-2 Connector 2 1 Figure 16: 2-pin 0.1" pitch pin header without shrouding Pin Signal Usage 1 WATCHDOG RESET A Watchdog reset switch 2 WATCHDOG RESET B Watchdog reset switch Connectors Location Standard Profile Bracket Low Profile Bracket Bypass module sockets I/O WATCHDOG DVI-I Input YCbCr/AVS Inputs PCIe Figure 17: Main board connectors location 17

18 1843 Picolo HD 3G DVI Handbook Mechanical Specification Standard Profile Bracket Low Profile Bracket Bypass module plugs DVI-I Output YCbCr/AVS Outputs Figure 18: Bypass module connectors location 18

19 Electrical Specification 1843 Picolo HD 3G DVI Handbook Electrical Specification Power Requirements The card draws power from the +3V3 and the +12V power rails of the PCI Express connector. Operating characteristics PCI Express +3.3 V supply voltage Min. Typ. Max. Unit V PCI Express +3.3 V supply current PCI Express +12 V supply voltage PCI Express +12 V supply current 12 A 13 V PCI Express power rail requirement 3.4 A 4.1 W Audio/Video Inputs Audio/video inputs electrical specification topics DVI-D Digital Video Input on page 19 DVI-A Analog Video Inputs on page 20 YPbPr Analog Video Inputs on page 20 S-Video and CVBS Analog Video Inputs on page 21 Analog Audio Inputs on page 21 DVI-D Digital Video Input The DVI-D video input provides a single TMDS link complying with the TMDS electrical specifications of the Digital Visual Interface 1.0. Operating characteristics Min. TMDS Clock Rate Typ. Max. Unit 165 MHz Functional description topic(s) HDMI Audio/Video Interface Functional description topic(s) DVI-D Video Interface on page 27 19

20 1843 Picolo HD 3G DVI Handbook Electrical Specification DVI-A Analog Video Inputs Operating Characteristics Operating characteristics Min. Typ. Max. Unit Signal amplitude (R, G, B inputs) V Signal amplitude (Hsync) 1.5 V Signal amplitude (Vsync) 1.5 V Input impedance 75 Ohm Pixel sampling rate MHz Max. Unit +2.0 V Note: Sync on green is supported since version 3.3 of MultiCam for Picolo HD. Absolute Maximum Ratings Absolute maximum ratings Min. DC voltage -2.0 Typ. Note: Exceeding the above limits may irreversibly damage the product. Functional description topic(s) DVI-A Video Interface on page 28 YPbPr Analog Video Inputs Operating characteristics Min. Typ. Max. Unit Signal amplitude (Y input) See note V Signal amplitude (Pb, Pr inputs) V Input impedance Pixel sampling rate Ohm 150 MHz Max. Unit +2.0 V Note: The signal applied on the Y input is composed of: a 700 mv Y (luminance) analog video component and, a 300 mv analog composite sync. Absolute maximum ratings Min. DC voltage -2.0 Typ. Note: Exceeding the above limits may irreversibly damage the product. 20

21 Electrical Specification 1843 Picolo HD 3G DVI Handbook Functional description topic(s) YPbPr Analog Video Interface on page 28 S-Video and CVBS Analog Video Inputs Operating characteristics Min. Typ. Max. Unit Signal amplitude (S-Video Y, CVBS inputs) See note V Signal amplitude (S-Video C input) V Input impedance 75 Ohm Pixel sampling rate 13.5 MHz Note: The signal applied on the S-Video Y and CVBS inputs is composed of: a 700 mv Y (luminance) analog video component and, a 300 mv analog composite sync. Absolute maximum ratings Min. DC voltage -2.0 Typ. Max. Unit +2.0 V Note: Exceeding the above limits may irreversibly damage the product. Analog Audio Inputs The analog audio inputs are electrically compatible with line-level analog audio sources. Operating characteristics Min. Typ. Max. Unit Full-scale input voltage 1.0 Vrms Full-scale input voltage 2.8 Vptp Input impedance (@ 1 khz) 11.5 kω 32/44.1/48 khz Sampling frequency Absolute maximum ratings DC voltage Min. Typ. -10 Input signal level Max. Unit +10 V 2.0 Vptp Note: Exceeding the above limits may irreversibly damage the product. Functional description topic(s) Analog Audio Interface on page 29 21

22 1843 Picolo HD 3G DVI Handbook Electrical Specification General Purpose I/O The general purpose I/O's are quasi-bidirectional I/O. They can be used as an input or as output ports. When set to the LOW state, the I/O port actively drives the output to the low state. The device is then capable of sinking 10 ma from the load with a voltage drop as little as 1 Volt. When set to the HIGH state, the I/O port stops driving the output to the low state. Instead, a weak-pullup pulls the I/O port towards the 3V3 rail. In that state, the I/O port can be used as an input port. A stronger transient pull-up is temporarily applied when the I/O state changes from LOW to HIGH. This improves the rising time of the output voltage. Operating characteristics Min. Operating voltage range Typ. Max. Unit 0 PCI 3.3V rail V LOW level input voltage V HIGH level input voltage V LOW level output current (VOUT=1 V) 10 HIGH level output current (VOUT=0 V) 30 ma 300 HIGH level output transient current (VOUT=0 V) 1 Maximum allowed input current though protection diodes (VIN outside 0V~3.3V range) -400 Absolute maximum ratings Min. Typ. µa ma 400 µa Max. Unit DC voltage -0.5 PCI 3.3V rail V DC current ma Note: Clamping diodes start conducting when applying voltage outside the operating voltage range exceeding a 0.5 V margin. Note: Exceeding the above limits may irreversibly damage the product. Functional description topic(s) I/O Functional Specifications on page 31 Watchdog Switch The watchdog switch is a polarity free switch built capable of switching loads operating in the 0V ~ 3.3V range. Operating characteristics Min. Operating voltage range Switch state 22 Typ. Max. Unit 0 PCI 3.3V rail V ma

23 Electrical Specification 1843 Picolo HD 3G DVI Handbook Operating characteristics Min. Typ. Leakage state Absolute maximum ratings Min. Typ. Max. Unit 1 µa Max. Unit DC voltage -0.5 PCI 3.3V rail V Clamping diodes current (see note) ma Note: Clamping diodes start conducting when applying voltage outside the operating voltage range exceeding a 0.5 V margin. Note: Exceeding the above limits may irreversibly damage the product. Functional description topic(s) Watchdog on page 32 23

24 1843 Picolo HD 3G DVI Handbook Environmental Specification Environmental Specification Storage Conditions The following requirements are applicable to Picolo HD 3G DVI when the product is not operating: Requirement during storage conditions Requirement during storage conditions Temperature range Humidity range Min. Max. Unit C F % Relative Humidity non-condensing Operating Conditions The following requirements are applicable to Picolo HD 3G DVI during product operation: Requirements Requirement during operating conditions Ambient air temperature range Ambient humidity range Min. Max. Unit C F % RH non-condensing Compliance Electromagnetic Picolo HD 3G DVI complies with: The European Council EMC Directive 2004/108/EC The Unites States FCC rule 47 CFR 15 It has been tested and found to comply with the following standards: Radiated emission 24 Standard Limit / Level EN Class B

25 Environmental Specification 1843 Picolo HD 3G DVI Handbook Standard Limit / Level FCC 47 CFR 15 Sub-part B Class B Immunity Standard EN Information technology equipment. Immunity characteristics EN Testing and measurement techniques Electrostatic discharge immunity test EN Radiated, radio-frequency, electromagnetic field immunity test EN Electrical fast transient/burst immunity test EN Surge immunity test EN Immunity to conducted disturbances, induced by radio-frequency fields EN Testing and measurement techniques Power frequency magnetic field immunity test EN Voltage dips, short interruptions and voltage variations immunity tests RoHS Picolo HD 3G DVI is manufactured according to the European Union RoHS 2011/65/EU Directive. WEEE According the European directive 2012/19/EU (previously 2002/96/EC), Picolo HD 3G DVI must be disposed of separately from normal household waste. It must be recycled according to the local regulations. 25

26 1843 Picolo HD 3G DVI Handbook Functional Specification Functional Specification Audio/Video Source Selection One audio/video source can be connected to the card using any one of the following connection configuration: Audio/video source selection capabilities Use case Audio Source Video Source DVI-D + L/R Audio Line-level analog audio DVI digital video DVI-A + L/R Audio Line-level analog audio DVI analog video Y/Pb/Pr + L/R Audio Line-level analog audio Y/Pb/Pr analog video S-Video + L/R Audio Line-level analog audio S-Video analog video CVBS + L/R Audio Line-level analog audio CVBS analog video The audio/video sources attach to connectors mounted on the bracket of the main board, possibly using an adapter cable: Audio/video source connections (on main board bracket) Audio/video source type Connector Adapter DVI-D digital video DVI-I input on main board N/A DVI-A analog video DVI-I input on main board N/A Y/Pb/Pr analog video YCbCr/AVS input on main board Y/Pb/Pr/L+R analog audio/video cable S-Video analog video YCbCr/AVS input on main board S-Video/CVBS/L/R analog audio/video cable CVBS analog video YCbCr/AVS input on main board S-Video/CVBS/L/R analog audio/video cable Y/Pb/Pr/L+R analog audio/video cable or L/R Audio YCbCr/AVS input on main board S-Video/CVBS/L/R analog audio/video cable A replication of the audio/video signals of all the video sources is available on the connectors mounted on the bracket of the bypass module, possibly using an adapter cable: Audio/video output connections (on bypass module bracket) 26 Audio/video output type Connector Adapter DVI-D digital video DVI-I output on bypass module N/A DVI-A analog video DVI-I output on bypass module N/A

27 Functional Specification 1843 Picolo HD 3G DVI Handbook Audio/video output type Connector Adapter Y/Pb/Pr analog video YCbCr/AVS output on bypass module Y/Pb/Pr/L+R analog audio/video cable S-Video analog video YCbCr/AVS output on bypass module S-Video/CVBS/L/R analog audio/video cable CVBS analog video YCbCr/AVS output on bypass module S-Video/CVBS/L/R analog audio/video cable L/R Audio YCbCr/AVS output on bypass module Y/Pb/Pr/L+R analog audio/video cable or S-Video/CVBS/L/R analog audio/video cable Audio/Video Interfaces MCHD C API topic(s) MchdGetVideoChannelInput() on page 45 MchdGetAudioChannelInput() on page 59 Audio/video interfaces topics DVI-D Video Interface on page 27 DVI-A Video Interface on page 28 YPbPr Analog Video Interface on page 28 S-Video and CVBS Analog Video Interface on page 29 Analog Audio Interface on page 29 DVI-D Video Interface The DVI-I connector of the main board provides one single-link DVI-D input that can be used for the acquisition of digital video. The DVI-D signals are replicated on the DVI-I connector of the bypass module. Supported DVI-D source characteristics Property Name Property Value TMDS clock frequency Up to 165 MHz Pixel Encoding 24-bit RGB 4:4:4 (default encoding for HDMI) Image resolutions 1920(H) x 1080(V) 1280(H) x 720(V) Scanning methods Progressive and interlaced Field rates (1080i) 50, 59.94, 60 fps Frame rates (1080p) 23.98, 24, 25, 29.97, 30, 50, 59.94, 60 fps Frame rates (720p) 50, 59.94, 60 fps 27

28 1843 Picolo HD 3G DVI Handbook Functional Specification Note: 720p23.98,720p24, 720p25, 720p29.97, and 720p30 video sources are not supported. Note: The card doesn't capture audio/video data from HDCP encrypted sources. When an HDCP encrypted signal is detected, the card delivers a blank image. Electrical specification topic(s) DVI-D Digital Video Input on page 19 DVI-A Video Interface The DVI-I connector of the main board provides one DVI-A input interface that can be used for the acquisition of analog RGB video only. The DVI-A signals are replicated on the DVI-I connector of the bypass module. Supported DVI-A source characteristics Property Name Property Value Sampling rate 165 MHz max. Video signal Analog RGB video components Image resolutions 1920(H) x 1080(V) 1280(H) x 720(V) Scanning methods Progressive and interlaced Field rates (1080i) 50, 59.94, 60 fps Frame rates (1080p) 23.98, 24, 25, 29.97, 30, 50, 59.94, 60 fps Frame rates (720p) 50, 59.94, 60 fps Note: 720p23.98,720p24, 720p25, 720p29.97, and 720p30 video sources are not supported. Electrical specification topic(s) DVI-A Analog Video Inputs on page 20 YPbPr Analog Video Interface The YCbCr/AVS connector of the main board provides one YPbPr input interface that can be used for the acquisition of Y, Pb, and Pr analog components of a high-definition video source. The signals are replicated on the YCbCr/AVS connector of the bypass module. Supported YPbPr source characteristics 28 Property Name Property Value Sampling rate 165 MHz max. Video signal Analog YPbPr video components

29 Functional Specification 1843 Picolo HD 3G DVI Handbook Property Name Image resolutions Property Value 1920(H) x 1080(V) 1280(H) x 720(V) Scanning methods Progressive and interlaced Field rates (1080i) 50, 59.94, 60 fps Frame rates (1080p) 23.98, 24, 25, 29.97, 30 fps Frame rates (720p) 50, 59.94, 60 fps Note: 720p23.98,720p24, 720p25, 720p29.97, and 720p30 video sources are not supported. Electrical specification topic(s) YPbPr Analog Video Inputs on page 20 S-Video and CVBS Analog Video Interface The YCbCr/AVS connector of the main board provides one S-Video input interface and one CVBS input interface that can be used for the acquisition of video from standard definition analog video sources. The S-Video input interface can be used for the acquisition of Y and C separate analog components. The CVBS input interface can be used for the acquisition of color composite video. The input signals are replicated on the YCbCr/AVS connector of the bypass module. Supported S-Video and CVBS source characteristics Property Name Property Value Sampling rate 13.5 MHz Video signal Color encoding methods Image scanning formats S-Video: separate analog video components ( Y and C) CVBS: composite analog video PAL and NTSC Interlaced fields/s Interlaced fields/s Supported 525i60 standards NTSC M, NTSC J, PAL M Supported 625i50 standards PAL B/D/G/H/I, PAL N Note: the card is not able to capture video from Macrovision protected analog SD video sources. For such video sources, the image is replaced by a placeholder. Analog Audio Interface The rycbcr/avs connector of the main board provides one audio input interface that can be used for the audio capture from analog line-level mono and stereo audio sources. 29

30 1843 Picolo HD 3G DVI Handbook Functional Specification The signals are replicated on the YCbCr/AVS connector of the bypass module. Supported Analog Audio source characteristics Property Name Property Value Number of audio channels 2 (Stereo Le and Right) Signal level Line-level Electrical specification topic(s) Analog Audio Inputs on page 21 Audio/Video Delivery Video Delivery Picolo HD 3G DVI delivers a single stream of uncompressed video in the YUY2 video format: YUY2 Video Format Characteristics Property Name Property Value FourCC Code YUY2 Format class Packed YUV 4:2:2 Horizontal sampling periods Y: 1 U: 2 V:2 Vertical sampling periods Y: 1 U: 1 V:1 Component bit depth 8-bits Byte ordering Y0, U0, Y1, V0, Y2, U2, Y3, V2 The resolution of the delivered image is, by default,the native resolution of the video source. It can also be set to a lower resolution. Image Resolution Capabilities Video Source Resolution Deliverable Video Resolutions (H x V) 1920 x x 1024, 1280 x 960, 1280 x 720 HD 1920 (H) x 1080(V) 1024 x x x 576, 720 x x x 720 HD 1280 (H) x 720(V) 800 x x 576, 720 x x

31 Functional Specification 1843 Picolo HD 3G DVI Handbook Video Source Resolution Deliverable Video Resolutions (H x V) SD 525i x 480 SD 625i x 576 The frame rate and the scanning method of the delivered image are identical to the frame rate and the scanning method of the video source. Audio Delivery The product delivers high-quality digital audio Property Name Property value Number of audio channels 2 Encoding 16-bit Linear PCM Sampling Rate(s) 32 khz, 44.1 khz, and 48 khz (See note) Note: The sampling rate of the delivered audio stream is identical to the sampling rate of the audio source. MCHD C API topic(s) MchdCreateVideoChannel() on page 39 MchdCreateSdVideoChannel() on page 41 MchdGetVideoChannelResolution() on page 44 MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. I/O Functional Specifications Property Name Property Value Number of General Purpose I/O ports 16 I/O port type Bidirectional Change-Of-State signaling Individually configurable Electrical specification topic(s) General Purpose I/O on page 22 MCHD C API topic(s) MchdGetIoDirection() on page 62 MchdSetIoDirection() on page 63 MchdGetIoState() on page 63 MchdSetIoState() on page 64 31

32 1843 Picolo HD 3G DVI Handbook Functional Specification Watchdog Picolo HD 3G DVI provides a hardware watchdog. Its purpose is to monitor the so ware application and to restart the PC a er an anomalous inactivity time-out. This ensures a reliable operation of unattended systems. The time-out duration is fixed at 3 minutes. The watchdog behaves as a normally open static switch. It is intended to be wired in parallel with the reset button of the PC. Therefore the product is equipped with two internal 2 pin headers named WATCHDOG-1 and WATCHDOG-2. Both connectors are equivalent and the polarity of the watchdog outputs doesn't matter. Watchdog Installation Instructions To insert the watchdog switch in parallel to the system reset switch, proceed as follows: Locate the "reset cable" linking the RESET BUTTON to the RESET INPUT on the motherboard. Reconnect the motherboard end of the "reset cable" to the WATCHDOG-2 connector. Using the supplied "watchdog cable", connect the RESET INPUT on the motherboard to the WATCHDOG-1 connector. Electrical specification topic(s) Watchdog Switch on page 22 32

33 So ware Specification 1843 Picolo HD 3G DVI Handbook So ware Specification MultiCam for Picolo HD Driver The MultiCam for Picolo HD driver enables the operation of Picolo HD cards. Software requirements Picolo HD Product MCHD Driver Version PC1840 Picolo HD One (S/N up to PHO01435) 1.0 or higher PC1840 Picolo HD One (S/N PHO01436 and higher) 3.0 or higher PC1841 Picolo HD 3G 1.0 or higher PC1842 Picolo HD H or higher PC1843 Picolo HD 3G DVI 3.0 or higher Operating Systems Operating System Version / Service Pack Processor Architecture MCHD Driver Version Microso Windows XP / SP3 x86 (32-bit) 1.0 or higher Microso Windows 7 / SP1 x86 (32-bit) 1.0 or higher Microso Windows 7 / SP1 x86-64 (64-bit) 1.0 or higher Microso Windows Server 2008 R2 / SP1 x86-64 (64-bit) 1.0 or higher Microso Windows 8 x86 (32-bit) 2.0 or higher Microso Windows 8 x86-64 (64-bit) 2.0 or higher Microso Windows Server 2012 x86-64 (64-bit) 2.0 or higher Application Programming Interfaces MultiCam for Picolo HD exposes the following API's: MCHD: a proprietary C API A DirectShow API The easy-to-use MCHD C API provides access to all the product functionalities. The driver also comes with customized Audio Capture and Video Capture DirectShow source filters. This allows third-party DirectShow applications to capture audio and video with Picolo HD cards. 33

34 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MultiCam for Picolo HD API MCHD C API s s Initialize/terminate on page 34 Board on page 35 Video Acquisition on page 38 Audio Acquisition on page 57 I/O on page 62 Initialize/terminate List of s MCHD C API s on page 34 Members MchdInitialize() on page 34 MchdTerminate() on page 35 MchdInitialize() MCHD_STATUS MCHD_API MchdInitialize(); The MchdInitialize() function must be called before any other MCHD API function to initialize the driver. To access the function, your program should include this header file: #include <mchd.h> Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Initialize/terminate on page 34 Related function(s) MchdTerminate() on page 35 MchdCreateBoard() on page 35 34

35 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MchdTerminate() MCHD_STATUS MCHD_API MchdTerminate(); The MchdTerminate() function must be called once for each call to MchdInitialize(). No more MCHD API function calls can be made a er the last call to MchdTerminate(). Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Initialize/terminate on page 34 Related function(s) MchdInitialize() on page 34 MchdCreateBoard() on page 35 Board List of s MCHD C API s on page 34 Members MchdCreateBoard() on page 35 MchdDeleteBoard() on page 36 MchdGetBoardType() on page 37 MchdSetOemKey() on page 37 MchdCheckOemKey() on page 38 MchdCreateBoard() MCHD_STATUS MCHD_API MchdCreateBoard(unsigned int n, MCHD_BOARD *board); Get a handle to the nth Picolo HD board in the system. The created board must be deleted by MchdDeleteBoard(). The board is set to MCHD_INVALID_HANDLE in case of error. Note: This function can be used to enumerate the Picolo HD boards that are present in the system. Therefore, increment the value n until the function returns MCHD_INVALID_HANDLE. 35

36 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API s n Position of the board in the system (zero-based numbering) board Pointer in which the board handle will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Board on page 35 MCHD_BOARD on page 67 Board instance. Related function(s) MchdDeleteBoard() on page 36 MchdGetBoardType() on page 37 MchdCreateVideoChannel() on page 39 MchdDeleteBoard() MCHD_STATUS MCHD_API MchdDeleteBoard(MCHD_BOARD board); Delete a board previously created by MchdCreateBoard(). s board Board handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Board on page 35 MCHD_BOARD on page 67 Board instance. Related function(s) MchdCreateBoard() on page 35 36

37 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MchdGetBoardType() MCHD_STATUS MCHD_API MchdGetBoardType(MCHD_BOARD board, MCHD_BOARD_TYPE *type); Retrieve the board type. s board Board handle type Pointer in which the board type will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Board on page 35 MCHD_BOARD on page 67 Board instance. MCHD_BOARD_TYPE on page 67 Board type. Related function(s) MchdCreateBoard() on page 35 MchdSetOemKey() MCHD_STATUS MCHD_API MchdSetOemKey(MCHD_BOARD board, const char oemkey[16]); Set the OEM key. s board Board handle oemkey[16] 16-characters OEM key Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Board on page 35 37

38 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MCHD_BOARD on page 67 Board instance. Related function(s) MchdCheckOemKey() on page 38 MchdCheckOemKey() MCHD_STATUS MCHD_API MchdCheckOemKey(MCHD_BOARD board, const char oemkey[16]); Checks the OEM key. Compares the given OEM key with the actual OEM key previously stored on the board EEPROM with the MchdSetOemKey() function. s board Board handle oemkey[16] 16-characters OEM key Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully and the OEM key has been checked as correct. Returned value is MCHD_STATUS_INVALID_OEM_KEY when the function executes successfully but the OEM key was not the expected one. Board on page 35 MCHD_BOARD on page 67 Board instance. Related function(s) MchdSetOemKey() on page 37 Video Acquisition List of s MCHD C API s on page 34 Members MchdCreateVideoChannel() on page 39 MchdCreateSogVideoChannel on page 40 MchdCreateSdVideoChannel() on page 41 MchdDeleteVideoChannel() on page 42 MchdRegisterVideoChannelCallback() on page 43 38

39 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MchdGetVideoChannelResolution() on page 44 MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelSignalState on page 46 MchdGetVideoChannelSyncOnGreenState on page 46 MchdGetVideoChannelFrameRate() on page 47 MchdSetVideoChannelHue() on page 48 MchdGetVideoChannelHue() on page 48 MchdSetVideoChannelSaturation() on page 49 MchdGetVideoChannelSaturation() on page 49 MchdSetVideoChannelGamma() on page 50 MchdGetVideoChannelGamma() on page 50 MchdSetVideoChannelContrast() on page 51 MchdGetVideoChannelContrast() on page 52 MchdSetVideoChannelBrightness() on page 52 MchdGetVideoChannelGamma() on page 53 MchdSetVideoChannelSharpness() on page 53 MchdGetVideoChannelSharpness() on page 54 MchdGetVideoChannelVideoPresence on page 54 MchdStartVideoChannel() on page 55 MchdStopVideoChannel() on page 56 MchdSaveSurfaceToJpegFile() on page 56 MchdCreateVideoChannel() MCHD_STATUS MCHD_API MchdCreateVideoChannel(MCHD_BOARD board, MCHD_VIDEO_INPUT input, MCHD_VIDEO_RESOLUTION resolution, MCHD_VIDEO_COLOR_FORMAT format, MCHD_VIDEO_CHANNEL *channel); Create a video channel. The created channel must be deleted by MchdDeleteVideoChannel. The channel is set to MCHD_INVALID_HANDLE in case of error. Note: This function doesn't apply to analog standard definition PAL or NTSC video sources. For such video sources, use MchdCreateSdVideoChannel() on page 41 instead. s board Board handle input Video input resolution Width and height of the delivered video frames, expressed in pixels format Data format of the delivered video 39

40 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API channel Pointer in which the video channel handle will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Note: When using MCHD_VIDEO_RESOLUTION_NATIVE, if the driver is unable to detect the actual source resolution within a 2 second time-frame, the function returns the MCHD_STATUS_SIGNAL_NOT_DETECTED error value. Functional specification topic Audio/Video Delivery on page 30 Video Acquisition on page 38 MCHD_VIDEO_INPUT on page 70 Video input. MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. MCHD_VIDEO_COLOR_FORMAT on page 70 Data format of the delivered color video MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdDeleteVideoChannel() on page 42 MchdRegisterVideoChannelCallback() on page 43 MchdStartVideoChannel() on page 55 MchdCreateSogVideoChannel MCHD_STATUS MCHD_API MchdCreateSogVideoChannel(MCHD_BOARD board, MCHD_VIDEO_INPUT input, MCHD_VIDEO_RESOLUTION resolution, MCHD_VIDEO_COLOR_FORMAT format, MCHD_VIDEO_CHANNEL *channel); Create a video channel with "sync on green" support. The created channel must be deleted by MchdDeleteVideoChannel. The channel is set to MCHD_INVALID_HANDLE in case of error. Note: This function applies only to analog high-definition video sources attached to the DVI-A video interface. Note: This function doesn't apply to analog standard definition PAL or NTSC video sources. For such video sources, use MchdCreateSdVideoChannel() on page 41 instead. 40

41 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook s board Board handle input Video input resolution Width and height of the delivered video frames, expressed in pixels format Data format of the delivered video channel Pointer in which the video channel handle will be returned Video Acquisition on page 38 MCHD_VIDEO_INPUT on page 70 Video input. MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. MCHD_VIDEO_COLOR_FORMAT on page 70 Data format of the delivered color video MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdDeleteVideoChannel() on page 42 MchdRegisterVideoChannelCallback() on page 43 MchdStartVideoChannel() on page 55 MchdCreateSdVideoChannel() MCHD_STATUS MCHD_API MchdCreateSdVideoChannel(MCHD_BOARD board, MCHD_VIDEO_INPUT input, MCHD_VIDEO_STANDARD standard, MCHD_VIDEO_RESOLUTION resolution, MCHD_VIDEO_COLOR_FORMAT format, MCHD_VIDEO_CHANNEL *channel); Create an SD video channel. The created channel must be deleted by MchdDeleteVideoChannel. The channel is set to MCHD_INVALID_HANDLE in case of error. Note: This function applies exclusively to analog standard definition PAL or NTSC video sources. For other video sources, use MchdCreateVideoChannel() on page 39 instead. s board Board handle 41

42 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API input Video input standard Video standard resolution Width and height of the delivered video frames, expressed in pixels format Data format of the delivered video channel Pointer in which the video channel handle will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Note: When using MCHD_VIDEO_RESOLUTION_NATIVE, if the driver is unable to detect the actual source resolution within a 2 second time-frame, the function returns the MCHD_STATUS_SIGNAL_NOT_DETECTED error value. Functional specification topic Audio/Video Delivery on page 30 Video Acquisition on page 38 MCHD_VIDEO_INPUT on page 70 Video input. MCHD_VIDEO_STANDARD on page 72 Video standard. MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. MCHD_VIDEO_COLOR_FORMAT on page 70 Data format of the delivered color video MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdDeleteVideoChannel() on page 42 MchdRegisterVideoChannelCallback() on page 43 MchdStartVideoChannel() on page 55 MchdDeleteVideoChannel() MCHD_STATUS MCHD_API MchdDeleteVideoChannel(MCHD_VIDEO_CHANNEL channel); Delete a video channel previously created by MchdCreateVideoChannel. 42

43 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook s channel Video channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdCreateVideoChannel() on page 39 MchdRegisterVideoChannelCallback() MCHD_STATUS MCHD_API MchdRegisterVideoChannelCallback(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_CALLBACK callback, void *context); Register a video callback function and user context. Set callback to NULL to unregister. s channel Video channel handle callback Function pointer to the function to be used as callback context Pointer to the argument to pass to the callback function Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_CALLBACK on page 68 Related function(s) MchdStartVideoChannel() on page 55 43

44 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MchdGetVideoChannelResolution() MCHD_STATUS MCHD_API MchdGetVideoChannelResolution(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_RESOLUTION *resolution); Retrieve the width and the height, expressed in pixels, of the image frames delivered by the video channel. s channel Video channel handle resolution Pointer in which the width and the height of the delivered video frames are delivered Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic Audio/Video Delivery on page 30 Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. Related function(s) MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelFrameRate() on page 47 MchdGetVideoChannelSignalState on page 46 MchdGetVideoChannelColorFormat() MCHD_STATUS MCHD_API MchdGetVideoChannelColorFormat(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_COLOR_FORMAT *colorformat); Retrieve the data format of the video delivered by the video channel. s 44 channel Video channel handle

45 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook colorformat Pointer in which the data format of the delivered video will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_COLOR_FORMAT on page 70 Data format of the delivered color video Related function(s) MchdGetVideoChannelResolution() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelFrameRate() on page 47 MchdGetVideoChannelSignalState on page 46 MchdGetVideoChannelInput() MCHD_STATUS MCHD_API MchdGetVideoChannelInput(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_INPUT *input); Retrieve the input of the video channel. s channel Video channel handle input Pointer in which the video input will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic Audio/Video Interfaces on page 27 Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_INPUT on page 70 45

46 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Video input. Related function(s) MchdGetVideoChannelResolution() on page 44 MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelFrameRate() on page 47 MchdGetVideoChannelSignalState on page 46 MchdGetVideoChannelSignalState MCHD_STATUS MCHD_API MchdGetVideoChannelSignalState(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_SIGNAL_STATE *signalstate); Retrieve the state of the video signal. s channel Video channel handle signal Pointer in which the video signal state will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_SIGNAL_STATE on page 71 Video signal state Related function(s) MchdGetVideoChannelVideoPresence on page 54 MchdGetVideoChannelResolution() on page 44 MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelSyncOnGreenState MCHD_STATUS MCHD_API MchdGetVideoChannelSyncOnGreenState(MCHD_VIDEO_CHANNEL channel, MCHD_VIDEO_SYNC_ON_GREEN_STATE *syncongreenstate); Retrieve the state of the sync on green. 46

47 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook s channel Video channel handle state Pointer in which the sync on green state will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_SYNC_ON_GREEN_STATE on page 73 Video Sync on Green State. MchdGetVideoChannelFrameRate() MCHD_STATUS MCHD_API MchdGetVideoChannelFrameRate(MCHD_VIDEO_CHANNEL channel, long *framerate); Retrieve the frame rate of the image frames delivered by the video channel. s channel Video channel handle framerate Pointer in which the frame rate value, expressed in fps, will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdGetVideoChannelResolution() on page 44 MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelSignalState on page 46 47

48 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MchdSetVideoChannelHue() MCHD_STATUS MCHD_API MchdSetVideoChannelHue(MCHD_VIDEO_CHANNEL handle, long value); Set the hue. Applies exclusively on analog SD video using the NTSC color system. s handle Video channel handle value Hue Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdGetVideoChannelHue() on page 48 MchdGetVideoChannelHue() MCHD_STATUS MCHD_API MchdGetVideoChannelHue(MCHD_VIDEO_CHANNEL handle, long *value); Get the hue. Applies exclusively on analog SD video using the NTSC color system. s handle Video channel handle value Pointer in which the hue value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. 48

49 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelHue() on page 48 MchdSetVideoChannelSaturation() MCHD_STATUS MCHD_API MchdSetVideoChannelSaturation(MCHD_VIDEO_CHANNEL handle, long value); Set the color saturation. Applies exclusively on analog SD video. s handle Video channel handle value Color saturation Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelSaturation() on page 49 MchdGetVideoChannelSaturation() MCHD_STATUS MCHD_API MchdGetVideoChannelSaturation(MCHD_VIDEO_CHANNEL handle, long *value); Get the color saturation. Applies exclusively on analog SD video. s handle Video channel handle 49

50 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API value Pointer in which the saturation value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelSaturation() on page 49 MchdSetVideoChannelGamma() MCHD_STATUS MCHD_API MchdSetVideoChannelGamma(MCHD_VIDEO_CHANNEL handle, long value); Set the gamma. Applies exclusively on analog SD video. s handle Video channel handle value Gamma value Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelGamma() on page 50 MchdGetVideoChannelGamma() MCHD_STATUS MCHD_API MchdGetVideoChannelGamma(MCHD_VIDEO_CHANNEL handle, long *value); 50

51 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook Get the gamma. Applies exclusively on analog SD video. s handle Video channel handle value Pointer in which the gamma value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelGamma() on page 50 MchdSetVideoChannelContrast() MCHD_STATUS MCHD_API MchdSetVideoChannelContrast(MCHD_VIDEO_CHANNEL handle, long value); Set the Contrast. Applies exclusively on analog SD video. s handle Video channel handle value Contrast value Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelContrast() on page 51 51

52 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MchdGetVideoChannelContrast() MCHD_STATUS MCHD_API MchdGetVideoChannelContrast(MCHD_VIDEO_CHANNEL handle, long *value); Get the contrast. Applies exclusively on analog SD video. s handle Video channel handle value Pointer in which the contrast value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelContrast() on page 51 MchdSetVideoChannelBrightness() MCHD_STATUS MCHD_API MchdSetVideoChannelBrightness(MCHD_VIDEO_CHANNEL handle, long value); Set the brightness. Applies exclusively on analog SD video. s handle Video channel handle value Brightness value Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. 52

53 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelBrightness() on page 52 MchdGetVideoChannelGamma() MCHD_STATUS MCHD_API MchdGetVideoChannelGamma(MCHD_VIDEO_CHANNEL handle, long *value); Get the gamma. Applies exclusively on analog SD video. s handle Video channel handle value Pointer in which the gamma value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelGamma() on page 50 MchdSetVideoChannelSharpness() MCHD_STATUS MCHD_API MchdSetVideoChannelSharpness(MCHD_VIDEO_CHANNEL handle, long value); Set the sharpness. Applies exclusively on analog SD video. s handle Video channel handle 53

54 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API value Sharpness value Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelSharpness() on page 53 MchdGetVideoChannelSharpness() MCHD_STATUS MCHD_API MchdGetVideoChannelSharpness(MCHD_VIDEO_CHANNEL handle, long *value); Get the sharpness. Applies exclusively on analog SD video. s handle Video channel handle value Pointer in which the sharpness value will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdSetVideoChannelSharpness() on page 53 MchdGetVideoChannelVideoPresence MCHD_STATUS MCHD_API MchdGetVideoChannelVideoPresence(MCHD_VIDEO_CHANNEL handle, MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE *value); 54

55 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook Retrieve the video presence indicator of a video signal on at least one video input s channel Video channel handle value Pointer in which the video presence indication will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE on page 69 Video signal prsence. Related function(s) MchdGetVideoChannelColorFormat() on page 44 MchdGetVideoChannelInput() on page 45 MchdGetVideoChannelFrameRate() on page 47 MchdGetVideoChannelSignalState on page 46 MchdStartVideoChannel() MCHD_STATUS MCHD_API MchdStartVideoChannel(MCHD_VIDEO_CHANNEL channel); Starts the video channel. s channel Video channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 55

56 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Video channel instance. Related function(s) MchdStopVideoChannel() on page 56 MchdStopVideoChannel() MCHD_STATUS MCHD_API MchdStopVideoChannel(MCHD_VIDEO_CHANNEL channel); Stops the video channel and waits until the acquisition thread(s) are done. Note: This function cannot be called from the callback function. s channel Video channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_VIDEO_CHANNEL on page 69 Video channel instance. Related function(s) MchdStartVideoChannel() on page 55 MchdSaveSurfaceToJpegFile() MCHD_STATUS MCHD_API MchdSaveSurfaceToJpegFile(const char *filename, const MCHD_VIDEO_SURFACE *surface, unsigned int quality); Save YUV (YV12 or YUYV) surfaces as JPEG files. Note: This function is based in part on the work of the Independent JPEG Group. s 56 filename Pointer in which the file name is given surface Pointer to the video surface

57 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook quality JPEG quality setting Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Video Acquisition on page 38 MCHD_STATUS on page 68 Success/failure status MCHD_VIDEO_SURFACE on page 73 Video surface structure definition. Audio Acquisition List of s MCHD C API s on page 34 Members MchdCreateAudioChannel() on page 57 MchdDeleteAudioChannel() on page 58 MchdRegisterAudioChannelCallback() on page 59 MchdGetAudioChannelInput() on page 59 MchdGetAudioChannelSampleRate() on page 60 MchdStartAudioChannel() on page 61 MchdStopAudioChannel() on page 61 MchdCreateAudioChannel() MCHD_STATUS MCHD_API MchdCreateAudioChannel(MCHD_BOARD board, MCHD_AUDIO_INPUT input, MCHD_AUDIO_SAMPLE_RATE rate, MCHD_AUDIO_CHANNEL *channel); Create an audio channel. The created channel must be deleted by MchdDeleteAudioChannel. The channel is set to MCHD_INVALID_HANDLE in case of error. s board Board handle input Audio input 57

58 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API rate Sampling rate of the delivered digital audio channel Pointer in which the audio channel handle will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_BOARD on page 67 Board instance. MCHD_AUDIO_INPUT on page 66 Audio input. MCHD_AUDIO_SAMPLE_RATE on page 67 Audio sample rate. MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. Related function(s) MchdDeleteAudioChannel() on page 58 MchdRegisterAudioChannelCallback() on page 59 MchdStartAudioChannel() on page 61 MchdDeleteAudioChannel() MCHD_STATUS MCHD_API MchdDeleteAudioChannel(MCHD_AUDIO_CHANNEL channel); Delete a channel previously created by MchdCreateAudioChannel. s channel Audio channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. Related function(s) MchdCreateAudioChannel() on page 57 58

59 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MchdRegisterAudioChannelCallback() MCHD_STATUS MCHD_API MchdRegisterAudioChannelCallback(MCHD_AUDIO_CHANNEL channel, MCHD_AUDIO_CALLBACK callback, void *context); Register an audio callback function and user context. Set callback to NULL to unregister. s channel Audio channel handle callback Function pointer to the function to be used as callback context Pointer to the argument to pass to the callback function Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. MCHD_AUDIO_CALLBACK on page 65 Related function(s) MchdStartAudioChannel() on page 61 MchdGetAudioChannelInput() MCHD_STATUS MCHD_API MchdGetAudioChannelInput(MCHD_AUDIO_CHANNEL channel, MCHD_AUDIO_INPUT *input); Retrieve the input of the audio channel. s channel Audio channel handle input Pointer in which the audio input value will be returned 59

60 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic Audio/Video Interfaces on page 27 Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. MCHD_AUDIO_INPUT on page 66 Audio input. Related function(s) MchdGetAudioChannelSampleRate() on page 60 MchdGetAudioChannelSampleRate() MCHD_STATUS MCHD_API MchdGetAudioChannelSampleRate(MCHD_AUDIO_CHANNEL channel, MCHD_AUDIO_SAMPLE_RATE *samplerate); Retrieve the sample rate of the audio channel. s channel Audio channel handle samplerate Pointer in which the sampling rate of the delivered digital audio will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. MCHD_AUDIO_SAMPLE_RATE on page 67 Audio sample rate. Related function(s) MchdGetAudioChannelInput() on page 59 60

61 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MchdStartAudioChannel() MCHD_STATUS MCHD_API MchdStartAudioChannel(MCHD_AUDIO_CHANNEL channel); Starts the audio channel. s channel Audio channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 Audio channel instance. Related function(s) MchdStopAudioChannel() on page 61 MchdStopAudioChannel() MCHD_STATUS MCHD_API MchdStopAudioChannel(MCHD_AUDIO_CHANNEL channel); Stops the audio channel and waits until the acquisition thread(s) are done. Note: This function cannot be called from the callback function. s channel Audio channel handle Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Audio Acquisition on page 57 MCHD_AUDIO_CHANNEL on page 66 61

62 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Audio channel instance. Related function(s) MchdStartAudioChannel() on page 61 I/O List of s MCHD C API s on page 34 Members MchdGetIoDirection() on page 62 MchdSetIoDirection() on page 63 MchdGetIoState() on page 63 MchdSetIoState() on page 64 Members MchdGetIoDirection() on page 62 MchdSetIoDirection() on page 63 MchdGetIoState() on page 63 MchdSetIoState() on page 64 MchdGetIoDirection() MCHD_STATUS MCHD_API MchdGetIoDirection(MCHD_BOARD board, unsigned int ioindex, MCHD_IO_DIRECTION *direction); Retrieve the direction of the designated I/O port. s board Board handle ioindex I/O index {0-15} direction Pointer in which the I/O direction will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic I/O Functional Specifications on page 31 I/O on page 62 I/O on page 62 62

63 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MCHD_BOARD on page 67 Board instance. MCHD_IO_DIRECTION on page 67 Direction of the I/O port. Related function(s) MchdSetIoDirection() on page 63 MchdSetIoDirection() MCHD_STATUS MCHD_API MchdSetIoDirection(MCHD_BOARD board, unsigned int ioindex, MCHD_IO_DIRECTION direction); Set the direction of the designated I/O port. s board Board handle ioindex I/O index {0-15} direction I/O direction Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic I/O Functional Specifications on page 31 I/O on page 62 I/O on page 62 MCHD_BOARD on page 67 Board instance. MCHD_IO_DIRECTION on page 67 Direction of the I/O port. Related function(s) MchdGetIoDirection() on page 62 MchdGetIoState() MCHD_STATUS MCHD_API MchdGetIoState(MCHD_BOARD board, unsigned int ioindex, 63

64 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MCHD_IO_STATE *state); Retrieve the state of the designated I/O port. s board Board handle ioindex I/O index {0-15} state Pointer in which the I/O state will be returned Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic I/O Functional Specifications on page 31 I/O on page 62 I/O on page 62 MCHD_BOARD on page 67 Board instance. MCHD_IO_STATE on page 68 State of the I/O port. Related function(s) MchdSetIoState() on page 64 MchdSetIoState() MCHD_STATUS MCHD_API MchdSetIoState(MCHD_BOARD board, unsigned int ioindex, MCHD_IO_STATE state); Set the state of the designated I/O port. If the I/O is set as an input, an error will be returned. s 64 board Board handle ioindex I/O index {0-15} state I/O state

65 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook Returned value is MCHD_STATUS_NO_ERROR when the function executes successfully. Functional specification topic I/O Functional Specifications on page 31 I/O on page 62 I/O on page 62 MCHD_BOARD on page 67 Board instance. MCHD_IO_STATE on page 68 State of the I/O port. Related function(s) MchdGetIoState() on page 63 Types Definitions MCHD_AUDIO_CALLBACK typedef void (MCHD_CALLING_CONVENTION *MCHD_AUDIO_CALLBACK)(const MCHD_AUDIO_CALLBACK_INFO *); MCHD_AUDIO_CALLBACK_INFO Audio callback information structure definition. typedef struct MCHD_AUDIO_CALLBACK_INFO { void *context; MCHD_AUDIO_CHANNEL channel; MCHD_AUDIO_FRAME frame; } MCHD_AUDIO_CALLBACK_INFO; Structure description Member context Pointer to the context passed as argument in the callback registering function channel Audio channel handle frame Audio frame MCHD_AUDIO_CHANNEL on page 66 65

66 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Audio channel instance. MCHD_AUDIO_FRAME on page 66 Audio frame structure definition. MCHD_AUDIO_CHANNEL Audio channel instance. typedef void *MCHD_AUDIO_CHANNEL; MCHD_AUDIO_FRAME Audio frame structure definition. typedef struct MCHD_AUDIO_FRAME { unsigned char *data; unsigned int size; unsigned long long timestamp; } MCHD_AUDIO_FRAME; Structure description Member data Pointer to the audio frame data buffer size Audio frame data buffer size, in bytes timestamp Audio frame time stamp MCHD_AUDIO_INPUT Audio input. typedef int MCHD_AUDIO_INPUT; 66 Identifier MCHD_AUDIO_INPUT_HDMI Digital audio input on the HDMI connector MCHD_AUDIO_INPUT_SDI Digital audio input on the SDI connector MCHD_AUDIO_INPUT_LINE_IN Analog audio input on the COMPONENT connector

67 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MCHD_AUDIO_SAMPLE_RATE Audio sample rate. typedef int MCHD_AUDIO_SAMPLE_RATE; Identifier MCHD_AUDIO_SAMPLE_RATE_DEFAULT Default sampling rate MCHD_AUDIO_SAMPLE_RATE_ khz sampling rate MCHD_AUDIO_SAMPLE_RATE_ khz sampling rate MCHD_AUDIO_SAMPLE_RATE_ khz sampling rate MCHD_BOARD Board instance. typedef void *MCHD_BOARD; MCHD_BOARD_TYPE Board type. typedef int MCHD_BOARD_TYPE; Identifier MCHD_BOARD_TYPE_PICOLO_HD_ONE PC 1840 Picolo HD One MCHD_BOARD_TYPE_PICOLO_HD_3G PC 1841 Picolo HD 3G MCHD_BOARD_TYPE_PICOLO_HD_H264 PC 1842 Picolo HD H.264 MCHD_IO_DIRECTION Direction of the I/O port. typedef int MCHD_IO_DIRECTION; Identifier MCHD_IO_DIRECTION_IN Input port MCHD_IO_DIRECTION_OUT Output port 67

68 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MCHD_IO_STATE State of the I/O port. typedef int MCHD_IO_STATE; Identifier MCHD_IO_STATE_OPEN Open MCHD_IO_STATE_HIGH High MCHD_STATUS Success/failure status typedef int MCHD_STATUS; All functions return an MCHD_STATUS indicating success or failure. Identifier MCHD_STATUS_NO_ERROR No error, the function executed successfully! MCHD_STATUS_OTHER_ERROR Internal error MCHD_STATUS_INITIALIZE_FAILED The driver initialization failed MCHD_STATUS_NO_ACCESS The application lacks access rights to fulfil the command. MCHD_STATUS_BOARD_NOT_FOUND No Picolo HD board found in the system MCHD_STATUS_RESOURCE_IN_USE The resource is already in use MCHD_STATUS_CANNOT_START_CHANNEL The acquisition channel cannot be started MCHD_STATUS_CANNOT_STOP_CHANNEL The acquisition channel cannot be stopped MCHD_STATUS_INVALID_PARAMETER_VALUE The parameter value is not valid MCHD_STATUS_INVALID_HANDLE The handle is invalid MCHD_STATUS_INVALID_OEM_KEY The OEM key is invalid MCHD_STATUS_INVALID_BOARD_TYPE The Board Type is invalid MCHD_STATUS_INVALID_COLOR_FORMAT The Color Format is invalid MCHD_STATUS_VIDEO_SIGNAL_NOT_DETECTED The video signal is not detected MCHD_VIDEO_CALLBACK typedef void (MCHD_CALLING_CONVENTION *MCHD_VIDEO_CALLBACK)(const MCHD_VIDEO_CALLBACK_INFO *); 68

69 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MCHD_VIDEO_CALLBACK_INFO Video callback information structure definition. typedef struct MCHD_VIDEO_CALLBACK_INFO { void *context; MCHD_VIDEO_CHANNEL channel; MCHD_VIDEO_SURFACE surface; } MCHD_VIDEO_CALLBACK_INFO; Structure description Member context Pointer to the context passed as argument in the callback registering function channel Video channel handle surface Video surface MCHD_VIDEO_CHANNEL on page 69 Video channel instance. MCHD_VIDEO_SURFACE on page 73 Video surface structure definition. MCHD_VIDEO_CHANNEL Video channel instance. typedef void *MCHD_VIDEO_CHANNEL; MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE Video signal prsence. typedef struct MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE { MCHD_VIDEO_PRESENCE presence; unsigned int timeout; } MCHD_VIDEO_CHANNEL_VIDEO_PRESENCE; Structure description Member presence Video presence indication timeout MCHD_VIDEO_PRESENCE on page 71 69

70 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API Video signal presence. MCHD_VIDEO_COLOR_FORMAT Data format of the delivered color video typedef int MCHD_VIDEO_COLOR_FORMAT; Identifier MCHD_VIDEO_COLOR_FORMAT_DEFAULT Default data format (see note) MCHD_VIDEO_COLOR_FORMAT_YUYV Uncompressed packed YUV 4:2:2 video FourCC code: YUYV MCHD_VIDEO_COLOR_FORMAT_YV12 Uncompressed planar YUV 4:2:0 video FourCC code: YV12 MCHD_VIDEO_COLOR_FORMAT_H264 H.264 compressed video Note: Assigning the MCHD_VIDEO_COLOR_FORMAT_DEFAULT value selects: The YUYV format for Picolo HD One and Picolo HD 3G The YV12 format for Picolo HD H.264 Note: Picolo HD One and Picolo HD 3G supports only one format: YUYV. Note: Picolo HD H.264 supports two formats: YV12 and H264. MCHD_VIDEO_INPUT Video input. typedef int MCHD_VIDEO_INPUT; Identifier MCHD_VIDEO_INPUT_DEFAULT Default video input (see note) MCHD_VIDEO_INPUT_DVI_D DVI-D digital video input MCHD_VIDEO_INPUT_YPBPR YPbPr analog components high-definition video input MCHD_VIDEO_INPUT_DVI_A DVI-A analog video input MCHD_VIDEO_INPUT_COMPOSITE CVBS composite analog standard-definition video input MCHD_VIDEO_INPUT_S_VIDEO S-Video analog components (Y/C) standard-definition video input Note: Setting MCHD_VIDEO_INPUT_DEFAULT selects the video input on which a valid video signal is applied. Avoid using this value when video signals are applied to more than one input. 70

71 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MCHD_VIDEO_PRESENCE Video signal presence. typedef int MCHD_VIDEO_PRESENCE; Identifier MCHD_VIDEO_PRESENCE_ABSENT No video signal are present on any video input. MCHD_VIDEO_PRESENCE_PRESENT A video signal is present on at least one video input. MCHD_VIDEO_RESOLUTION Video resolution structure definition. typedef struct MCHD_VIDEO_RESOLUTION { unsigned int width; unsigned int height; } MCHD_VIDEO_RESOLUTION; Structure description Member width Number of pixels per line height Number of lines per frame Identifier MCHD_VIDEO_RESOLUTION_NATIVE The delivered video frames have the same width and the same height as the frames delivered by the video source. Functional specification topic Audio/Video Delivery on page 30 MCHD_VIDEO_SIGNAL_STATE Video signal state typedef int MCHD_VIDEO_SIGNAL_STATE; Identifier MCHD_VIDEO_SIGNAL_STATE_NO_SIGNAL No or invalid video signal on the selected input. MCHD_VIDEO_SIGNAL_STATE_PRESENT Available and valid video signal on the selected input. 71

72 1843 Picolo HD 3G DVI Handbook MultiCam for Picolo HD API MCHD_VIDEO_STANDARD Video standard. typedef int MCHD_VIDEO_STANDARD; Identifier MCHD_VIDEO_STANDARD_NONE Unspecified standard MCHD_VIDEO_STANDARD_NTSC_M NTSC-M standard MCHD_VIDEO_STANDARD_NTSC_M_J NTSC-J standard (Variant of NTSC-M for Japan) MCHD_VIDEO_STANDARD_PAL_B PAL-B standard MCHD_VIDEO_STANDARD_PAL_D PAL-D standard MCHD_VIDEO_STANDARD_PAL_G PAL-G standard MCHD_VIDEO_STANDARD_PAL_H PAL-H standard MCHD_VIDEO_STANDARD_PAL_I PAL-I standard MCHD_VIDEO_STANDARD_PAL_M PAL-M standard MCHD_VIDEO_STANDARD_PAL_N PAL-N standard Analog SD Video Standards Main Characteristics Lines Field rate [Hz] Line rate [khz] Color System Color subcarrier frequency [MHz] Black Countries level [IRE] NTSC-J NTSC Japan NTSC-M NTSC United states, Canada, Mexico, PAL countries PAL-M PAL Brazil PAL-N PAL Standard Name PAL-B PAL-D PAL-G PAL-H PAL-I 72 Paraguay, Uruguay

73 MultiCam for Picolo HD API 1843 Picolo HD 3G DVI Handbook MCHD_VIDEO_SURFACE Video surface structure definition. typedef struct MCHD_VIDEO_SURFACE { unsigned char *data[3]; unsigned int size[3]; MCHD_VIDEO_RESOLUTION resolution; unsigned int pitch[3]; unsigned long long timestamp; MCHD_VIDEO_COLOR_FORMAT format; } MCHD_VIDEO_SURFACE; Structure description Member data[3] Pointers to the video data buffers size[3] Size, expressed in bytes, of the video data buffers resolution Width and height of the delivered video frames, expressed in pixels pitch[3] Pitch, expressed in bytes, of the video data buffers timestamp Time stamp, expressed in units of 100 nanoseconds format Data format of the delivered video Note: For YUV Planar video formats, such as YV12, each of the three video data buffers stores one color component. The 3 buffers contain respectively the Y, the V, and the U color components. Note: For YUV Packed video formats, such as YUY2, and for H.264 compressed formats, the video data is stored entirely into the first data buffer. The information for the second and third buffers is set to 0/NULL. MCHD_VIDEO_RESOLUTION on page 71 Video resolution structure definition. MCHD_VIDEO_COLOR_FORMAT on page 70 Data format of the delivered color video MCHD_VIDEO_SYNC_ON_GREEN_STATE Video Sync on Green State. typedef int MCHD_VIDEO_SYNC_ON_GREEN_STATE; Identifier MCHD_VIDEO_SYNC_ON_GREEN_STATE_DISABLED Sync on green is disabled MCHD_VIDEO_SYNC_ON_GREEN_STATE_ENABLED Sync on green is enabled 73

74 1843 Picolo HD 3G DVI Handbook Kernel Streaming API Kernel Streaming API Board Identifiers These identifiers are used to identify a Picolo HD board: Product Identifier Name Identifier Value GUID_PicoloHDPropertySet D1E5209F-68FD-4529-BEE0-5E7A1F47921C GUID_PicoloHD264PropertySet D1E5209F-68FD-4529-BEE0-5E7A1F47921A 1840 Picolo HD One 1841 Picolo HD 3G 1843 Picolo HD 3G DVI 1842 Picolo HD H.264 Property Access Procedure These steps must be followed to set or get a property of your Picolo HD board: 1. Retrieve the IMoniker representing the Picolo HD board; 2. Retrieve the IKsPorpertySet from the IMoniker (BindToObject with typeof(ikspropertyset).guid); 3. Choose the Kernel Streaming Identifier (KSI) corresponding to your board (GUID_PicoloHDPropertySet or GUID_PicoloHD264PropertySet); 4. Choose the right Kernel Streaming Property Identifier (KSPI); 5. Call the IKsPropertySet::Get or IKsPropertySet::Get method. Get and Set methods int Get(Guid guidpropset, int dwpropid, IntPtr pinstancedata, int cbinstancedata, IntPtr ppropdata, int cbpropdata, out int pcbreturned); int Set(Guid guidpropset, int dwpropid, IntPtr pinstancedata, int cbinstancedata, IntPtr ppropdata, int cbpropdata); When calling the Get and Set methods, make sure that parameters pinstancedata and cbinstancedata are set to IntPtr.Zero and 0 respectively. Note: You can find examples of how to call these methods in the PicoloHDIKsWrapper object included with the sample. 74

75 Kernel Streaming API 1843 Picolo HD 3G DVI Handbook Custom Property Identifiers De-interlacing Property Characteristic Name Deinterlacing Identifier 200 Logical Type Long PicoloHDIKsWrapper N/A Access RW De-interlacing mode Property Value 0 Off 1 Median Weakest 2 Median Weak 3 Median Strong 4 Median Strongest 5 Advanced Median Weakest 6 Advanced Median Weak 7 Advanced Median Strong 8 Advanced Median Strongest Video Input Property Characteristic Name Video_Input Identifier 201 Logical Type Long PicoloHDIKsWrapper PicoloHD_VideoInput Access RW 75

76 1843 Picolo HD 3G DVI Handbook Kernel Streaming API Property Characteristic Video input connector Property Value -1 Default 0 HDMI 1 DVI D 2 YPBPR 3 DVI A 4 SDI 5 Composite 6 S-Video Frame Rate Property Characteristic Name Framerate Identifier 208 Logical Type uint PicoloHDIKsWrapper N/A Access R Frame rate expressed in frames per second Property Value Up to 60 Depends on the board and resolution Resolution Property Characteristic 76 Name Resolution Identifier 210 Logical Type uint PicoloHDIKsWrapper N/A Access R

77 Kernel Streaming API 1843 Picolo HD 3G DVI Handbook Property Characteristic Width and height of the image expressed in pixels Width is coded in the first 16 bits Height is coded in the last 16 bits Property Value Up to 1920 * 1080 Depends on the board and frame rate Denoising Property Characteristic Name Denoising Identifier 217 Logical Type int PicoloHDIKsWrapper N/A Access RW Strength of the de-noising filter Property Value 0 Off 1 Weak 2 Strong 3 Strongest Video Flexible Resolution Property Characteristic Name VideoFlexibleResolution Identifier 220 Logical Type uint PicoloHDIKsWrapper N/A Access RW 77

78 1843 Picolo HD 3G DVI Handbook Kernel Streaming API Property Characteristic Enable video resizing Property Value 1 Enable video resizing Sync On Green Property Characteristic Name syncongreen Identifier 234 Logical Type uint PicoloHDIKsWrapper N/A Access RW Sync on the green component of the analog video signal (DVI-A input) Property Value 0 Disable sync on green 1 Enable sync on green Analog Audio Input Type Property Characteristic Name AnalogAudioInputType Identifier 255 Logical Type int PicoloHDIKsWrapper N/A Access RW Type of analog audio input. Property Value 78 0 Embedded audio. (Only valid for SDI and HDMI inputs) 1 Line input.

79 Kernel Streaming API 1843 Picolo HD 3G DVI Handbook H.264 Encoder Bit Rate Property Characteristic Name H264Encoder_BitRate Identifier 403 Logical Type uint PicoloHDIKsWrapper N/A Access RW Encoder bit rate expressed in bits/second. Property Value 131,072 Minimum value (128 Kbit/s) 12,582,912 Maximum value (12 Mbit/s) H.264 Encoder Bit Rate Mode Property Characteristic Name H264Encoder_BRMode Identifier 407 Logical Type ulong PicoloHDIKsWrapper PicoloHD_EncoderBitRateMode Access RW H.264 encoder bit rate control mode Property Value 0 Variable Bit Rate 1 Constant Bit Rate H.264 Encoder Profile Property Characteristic Name H264Encoder_Profile Identifier 412 Logical Type long 79

80 1843 Picolo HD 3G DVI Handbook Kernel Streaming API Property Characteristic PicoloHDIKsWrapper PicoloHD_EncoderProfile Access RW H.264 encoder profile Property Value 0 Main profile 1 Baseline profile Privacy Mask Property Characteristic Name PrivacyMask Identifier 890 Struct { Uint index; Logical Type Ushort y; Ushort x; Uint width; Uint height; } PicoloHDIKsWrapper PicoloHD_EncoderProfile Access RW Privacy mask properties: Index Y Origin (Aligned on 16 bytes) X Origin (Aligned on 16 bytes) Width (Aligned on 16 bytes) Height (Aligned on 16 bytes) Property Value 0 If x, y, width, height are all 0, the mask is removed. H.264 OSD Text Path Property Characteristic 80 Name H264OSD_Text_Path Identifier 921, 922, 923, 924 Logical Type byte[16]

81 Kernel Streaming API 1843 Picolo HD 3G DVI Handbook Property Characteristic PicoloHDIKsWrapper N/A Access W Bytes 1 to 16 of the OSD text path Bytes 17 to 32 of the OSD text path Bytes 33 to 48 of the OSD text path Bytes 49 to 64 of the OSD text path To set an OSD text on the image, you have to create a text file that contains the text you want on your image and pass the path to that file to the KsPropertySet. The path can be maximum 63 character long (64 with the null terminated character) and must be passed in chunks of 16 characters each. Example The text you want to show: Hello World The file path containing Hello World : C:\Users\Public\Documents\PicoloHD\OSD File Sample.txt. Values to pass to each Identifier: 921 : [ C, :, \, U, s, e, r, s, \, P, u, b, l, I, c, \ ] 922 : ['D', 'o', 'c', 'u', 'm', 'e', 'n', 't', 's', '\', 'P', 'i', 'c', 'o', 'l', 'o'] 923 : ['H', 'D', '\', 'O', 'S', 'D', ' ', 'F', 'i', 'l', 'e', ' ', 'S', 'a', 'm', 'p'] 924 : ['l', 'e', '.', 't', 'x', 't', 0, 0, 0, 0, 0, 0, 0, 0, 0, 0] I/O Direction Property Characteristic Name IODirection Identifier 940 Logical Type uint PicoloHDIKsWrapper N/A Access RW I/O Direction Property Value 0 Output 1 Input I/O State Property Characteristic Name IOState 81

82 1843 Picolo HD 3G DVI Handbook Kernel Streaming API Property Characteristic Identifier 941 Logical Type uint PicoloHDIKsWrapper N/A Access RW I/O Direction Property Value 82 0 High 1 Open

83 Appendix 1843 Picolo HD 3G DVI Handbook Appendix MultiCam for Picolo HD Driver Installation Note: Picolo HD 3G DVI and Picolo HD One since S/N PHO01436 require Version 3.0 or higher of the driver. The MultiCam for Picolo HD driver is distributed on the Euresys website: The first time access requires a profile creation to obtain a user ID and a password. Once the package is downloaded, run the executable to launch the installer tool. If you have an existing MultiCam for Picolo HD driver already installed, you will be prompted to uninstall it before being able to continue. Otherwise, the tool prompts you for the selection of the destination folder. Figure 19: Destination Folder Dialog Box Note: The default installation folder is: C:\Program Files (x86)\euresys\multicamforpicolohd for 64-bit Windows versions. C:\Program Files\Euresys\MultiCamForPicoloHD for 32-bit Windows versions. The tool Installs the device driver(s) for all the Picolo HD cards present in the system. However, before effective driver installation, you may have to acknowledge the Windows Security dialog box: Figure 20: Example of Security Dialog Box for Picolo HD One 83

84 1843 Picolo HD 3G DVI Handbook Appendix DirectShow Filter Graph Setup Example This topic describes the procedure to create a filter graph with 1 audio and 3 video filters for a Picolo HD H.264 card using GraphEdit. 1. Select the "Picolo HD H.264, Video Capture" filter among the WDM Streaming Capture Devices filter list. Figure 21: Filter selection 2. Insert three instances of the "Picolo HD H.264, Video Capture" filter in the graph. 3. Configure the Properties of each Video Capture Filter instance as follows: a) In the "Custom Properties" tab: select the HDMI Video Input Figure 22: Video Capture Filter Properties - Custom Properties Tab b) In the "Video Decoder" tab, select the Video Standard.. For high-definition video sources, select Unknown For low-definition S-Video and CVBS video sources, select explicitly the standard 84

85 Appendix 1843 Picolo HD 3G DVI Handbook Figure 23: Video Capture Filter Properties - Video Decoder Tab 4. Configure the Video Capture Pin Properties of each Video Capture Filter instance as follows: a) In the "Stream Format" tab: select the adequate Color Space/Compression setting: YV12 for the first filter instance H.264 for the second filter instance X.264 for the third filter instance Figure 24: Video Capture Pin Properties - Stream Format Tab - Color space/compression Box b) In the "Stream Format" tab: select the adequate Output Size setting 1920 x 1080 for the YV12 and H.264 pins 960 x 540 for the X264 pin Note: The output size of YV12 and H.264 pin must match the source resolution (1920 x 1080 in this example) Note: The output size of X.264 pin must match the source resolution scaled-down by 2. 85

86 1843 Picolo HD 3G DVI Handbook Appendix Figure 25: Video Capture Pin Properties - Stream Format Tab - Output Size Box 5. Select the "Picolo HD H.264, Audio Capture" filter among the WDM Streaming Capture Devices filter list. 6. Insert one instance of the "Picolo HD H.264, Audio Capture" filter in the graph. 7. Render the 3 video capture pins and the audio capture pin. Figure 26: Filter Graph Precautions for Use of Board Products Electrostatic Sensitive Device Boards may be damaged by electrostatic discharges. Follow the procedure hereby described and apply any general procedure aimed at reducing the risk associated with electrostatic discharge. Damage caused by improper handling is not covered by the manufacturer's warranty. Electromagnetic Compatibility Euresys boards are compliant with electromagnetic compatibility regulatory requirements. To ensure this compliance, the card bracket must be secured with the relevant screw in accordance with the procedure described herein. 86