CineView® Pro XL CineView® Pro CineView® Pro LE Vela’s PCI MPEG-2 Decoder Family Installation and User Manual Includes a guide to the Vela Application Programming Interface Ver. 2.6 for the CineView Pro family of decoders CineView ® Pro CineView ® Pro XL CineView ® ProLE Model 2000-2153 Model 2000-2100 Model 2000-2110 MPEG-2 Decoders for the PCI Bus Release 2.
Copyright 2002 Vela LP. All rights reserved. CineView is a registered trademark of Vela LP. This manual is written and published by Vela LP (Vela). All rights reserved. Vela reserves the right to make changes to this manual and to the product(s) represented without notice. No portion of this manual may be copied, reproduced, or transcribed without the express written authorization of Vela.
Table of Contents List of Figures and Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Part One — Installation and Use Chapter 1 Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ii CineView Pro Decoder Family 2.6 User Manual and API Guide Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 MPEG File Properties Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Using Playlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents iii Component Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Processing Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 CVProServer Class Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 AVStream Class Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 FrameControlledPlayback Class Properties . .
iv CineView Pro Decoder Family 2.6 User Manual and API Guide MuteAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OpenStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OpenStream2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OpenStream2Uni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents v BlackLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 BlankLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 BlankVideo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Brightness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi CineView Pro Decoder Family 2.6 User Manual and API Guide nRetVal FrameAccuratePlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Initialize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 FrameControlledPlayback Class Property Descriptions . . . . . . . . . . . . . . . . . EndControlType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EndFrame . . . . . .
List of Figures and Tables Part One — Installation and Use Chapter 1 Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Figure 1-1. Table 1-1. Figure 1-2. Table 1-2. Figure 1-3. Figure 1-4. Figure 1-5. Figure 1-6. Figure 1-7. Figure 1-8. Figure 1-9. Figure 1-10. Figure 1-11. Figure 1-12. Figure 1-13. Figure 1-14. Figure 1-15. Figure 1-16. Figure 1-17. Figure 1-18. Figure 1-19. Figure 1-20. Figure 1-21. Figure 1-22. Figure 1-23. Figure 1-24.
viii CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-31. Suggested Audio Cabling (Balanced Analog), CineView Pro LE . . 39 Figure 1-32. Suggested Audio Cabling (Digital 110-Ohm), CineView Pro & XL . 40 Figure 1-33. Suggested Audio Cabling (Digital 75-Ohm), CineView Pro & XL . . 41 Chapter 2 The Playback Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Figure 2-1. Figure 2-2. Figure 2-3. Figure 2-4. Figure 2-5. Figure 2-6. Figure 2-7.
List of Figures and Tables ix Chapter 5 Advanced API Development. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Part Three — Appendices and Index Appendix A Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 Appendix B Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 Table B-1. Troubleshooting Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Part One Installation and Use Chapter 1 Getting Started Chapter 2 The Playback Application
Chapter 1 Getting Started Introduction Welcome to Vela’s CineView ® Pro family of audio/video decoders, version 2.6. These decoders include the model 2000-2153 CineView Pro XL the model 20002100 CineView Pro, and the model 2000-2110 CineView Pro LE. These broadcastquality decoders are designed to support playback of MPEG-1 and MPEG-2 video clips on both the host computer’s VGA monitor and/or an NTSC or PAL video system.
4 CineView Pro Decoder Family 2.6 User Manual and API Guide MPEG-2 main-level main-profile system, transport, and program streams. Digital and composite video are output through respective BNC connectors on the rear of the decoder board. Composite video can also be played back through the system VGA monitor for convenient monitoring. An additional BNC on the rear of the decoder allows a genlock signal to be applied. The CineView Pro XL decoder can output both serial D-1 video and NTSC/PAL composite video.
Chapter 1 — Getting Started 5 Features Introduced in Release 2.5 and Earlier: (XL Only) Enhanced Audio Capabilities: In addition to the audio capabilities found in the CineView Pro family of decoders, the CineView Pro XL supports four channels of audio embedded in the SDI stream. S/P DIF audio can be output through an optional connector bracket. (XL Only) Longitudinal Time Code (LTC) Output: The Pro XL can output time code through an optional connector bracket.
6 CineView Pro Decoder Family 2.6 User Manual and API Guide microcode file is read and displayed in the Help About window (Figure 1-1). Data displayed includes 4:2:2 and 4:2:0 microcode versions for the IBM decoder, the audio microcode version for the IBM decoder, and the build number, compile date and compile time for the DSP code. Figure 1-1.
Chapter 1 — Getting Started 7 connector on the decoder board and can be output if, desired, through a customer-fabricated cable assembly (CineView Pro XL only). • MPEG audio layers 1 and 2 at 32kHz, 44.1kHz, and 48kHz. • Mid-stream start: This feature gives the user the ability to begin playback of a video clip at any point. The keying function of mid-stream starts is userdefinable and is determined by using byte offset.
8 CineView Pro Decoder Family 2.6 User Manual and API Guide • Brightness, contrast, and saturation control for the VGA display. Minimum System Requirements • PC-compatible computer with Pentium 200 or better processor. • 32MB RAM (64MB recommended). • PCI bus architecture. • Microsoft Windows 2000 or Windows NT 4.0 (Service Pack 6a). • CD-ROM drive for software and driver installation. • PCI-compliant VGA controller with accessible linear frame buffer (support for high bit 16 or high bit 24 required).
Chapter 1 — Getting Started 9 2. Connect the supplied audio output cable to the DB-15 connector on the decoder board. See Figure 1-28 for pinout information. NOTE: The analog audio output level of the CineView Pro XL decoder is +4 dBm, balanced. Typical audio input levels for consumer television monitors are -10 dBm, unbalanced. This can lead to situations where the decoder’s output level may be too high for the destination equipment, such as a common television monitor.
10 CineView Pro Decoder Family 2.6 User Manual and API Guide LTC Output Pinouts Header JP9 Pin Signal DB-9 Connector Pin 1 LTC Positive (+) 1 2 Gnd 2 3 LTC Negative (–) 3 Table 1-2. LTC Output Header Pinouts Digital Audio Jumper Settings The CineView Pro XL decoder board provides two jumper connector blocks that are used to configure the impedance of the AES/EBU digital audio signal. JP6 controls AES/EBU channel A. Jumper block JP7 controls AES/EBU channel B.
Chapter 1 — Getting Started 11 expose the chassis and motherboard. 2. It is important that the CineView Pro/Pro LE decoder board be plugged into a PCI bus-master slot, making sure the edge connectors are fully engaged. Secure the board’s mounting bracket to the PC chassis. Connect the audio and video cables, if applicable. 3.
12 CineView Pro Decoder Family 2.6 User Manual and API Guide NOTE: Hardware drivers for Windows NT are automatically installed with the application. 1. Uninstall any CineView Pro software currently on the system. Use the Windows Control Panel > Add/Remove Programs application. For complete details on uninstalling current and previous versions of software, see “Uninstalling CineView Pro 2.6 Software,” page 24. 2. Install Windows NT Service Pack 6a or later, if it’s not already installed on your system.
Chapter 1 — Getting Started 13 • On the next screen, deselect (remove the checks from) the “Windows Media Player” and “Outlook Express” selections. • The version of Windows Media Player included with Internet Explorer 5.0 is outdated. A more recent version is included on this CD, though the installation of Windows Media Player and Outlook Express are not a requirement for the CineView Pro. • Click Next, OK, or Finished to all of the screens that follow.
14 CineView Pro Decoder Family 2.6 User Manual and API Guide “MFC Update” checkbox on the “Select Components” screen. This step needs to be done only once. If you check this box, there will be an extra set of steps automatically included in the procedure specified below— and the installation procedure will require an additional system restart. Just follow the instructions presented by the MFCupdate.exe installation application.
Chapter 1 — Getting Started 15 • On the “Install” message box (Figure 1-17), note that the system must be restarted. Click OK, and then wait as the system reboots. Leave the CDROM in the drive through the system restart process. 10. If you remembered to leave the CD-ROM in the drive, the setup application pops up immediately after the reboot.
16 CineView Pro Decoder Family 2.6 User Manual and API Guide • From the Autorun screen (Figure 1-10), select “Explore This CD.” • From the “Explore This CD” screen (Figure 1-11), double-click on the System folder. • Double-click on the “Win2k Service Pack” folder. • Double-click on the w2ksp2.exe file. • The application will extract files, then ask you to read a license agreement.
Chapter 1 — Getting Started 17 11. Click on “Reinstall Driver.” 12. The Device Driver Wizard screen appears (Figure 1-4). “Welcome to the Upgrade Device Driver Wizard.” Click Next. 13. Wizard screen “Install Hardware Device Drivers” (Figure 1-5): Select the radio button “Search for a suitable driver for my device.” Click Next. 14.
18 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-3.
Chapter 1 — Getting Started 19 Figure 1-4. Device Driver Wizard: Welcome Screen Figure 1-5.
20 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-6. Device Driver Wizard: Locate Driver Files Figure 1-7.
Chapter 1 — Getting Started 21 Figure 1-8. Device Driver Wizard: Completion Figure 1-9.
22 CineView Pro Decoder Family 2.6 User Manual and API Guide Installing CineView Pro 2.6 Software — Windows 2000 1. Install MDAC 2.6, if it is not already installed on your system. Again you can download this from the Internet, or you can install it from the installation CD-ROM. To use the CD-ROM, follow these steps: • Insert the CD-ROM into the CD-ROM drive. • When the Autorun setup screen (Figure 1-10) appears, select the “Explore This CD” option (Figure 1-11). • Double-click on the “System” folder.
Chapter 1 — Getting Started 23 • If you have purchased any of the following components, their corresponding check boxes also need to be checked.
24 CineView Pro Decoder Family 2.6 User Manual and API Guide • On the “CineView Pro End User License Agreement” screen (Figure 1-19), select the “I Agree” radio button after reading the agreement. Then click OK. The application will install some files. 6. If you elected to install the SDK: • Select the “I Agree” radio button on the “CineView Pro SDK End User License Agreement” screen (Figure 1-20). Click OK. • On the Password screen (Figure 1-21), you will be asked for a password.
Chapter 1 — Getting Started 25 • You may see a message indicating that a particular file is no longer being used by any program. Click “Yes to All” to delete it and any other such files. • On other screens that may appear, Click on Next or Finish until the uninstall process is complete. • After you click Finish on the last screen of the uninstall procedure, you will be asked to restart the system. Click OK, and allow the system to restart.
26 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-10. Installation Autorun Setup Screen Figure 1-11.
Chapter 1 — Getting Started 27 Figure 1-12.Install Welcome Screen Figure 1-13.
28 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-14.Select Components Screen Figure 1-15.
Chapter 1 — Getting Started 29 Figure 1-16.Installation Start Screen Figure 1-17.Install Restart Message Figure 1-18.
30 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-19.CineView License Agreement Screen Figure 1-20.
Chapter 1 — Getting Started 31 Figure 1-21.Password Dialog Box Figure 1-22.
32 CineView Pro Decoder Family 2.6 User Manual and API Guide Windows Registry For each CineView decoder card installed on the computer, the unique settings for each card are stored in the Windows Registry under HKEY_CURRENT_USER, Software, Vela Research, CineView Pro X, Setup; where X is the logical zerobased index of the CineView decoder card installed on the computer. See Figure 1-23, below. Figure 1-23.
Chapter 1 — Getting Started 33 Illustrations Figure 1-24.
34 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-25.
Chapter 1 — Getting Started 35 Figure 1-26.
36 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-27. CineView Pro XL Audio Pinouts Figure 1-28.
Chapter 1 — Getting Started 37 Figure 1-29.
38 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-30.
Chapter 1 — Getting Started 39 Figure 1-31.
40 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 1-32.
Chapter 1 — Getting Started 41 Figure 1-33.
Chapter 2 The Playback Application Introduction The CineView Pro XL, Pro and Pro LE playback application provides for basic operation of the decoder, including the ability to play, stop, pause and resume MPEG video clips. See Chapter 1 for installation instructions. The source code for the playback application is available for developers desiring to write custom applications. As an aid to programmers, an Application Programming Interface (API) Developer’s Guide is included in Part Two of this user manual.
44 CineView Pro Decoder Family 2.6 User Manual and API Guide Playback Toolbar The playback toolbar appears each time the playback application is started. Toolbar button objects are described below. A tool tip is displayed for each active button object as the mouse cursor passes over it. In addition, a menu bar (an item-by-item description of which can be found on page 48), is available at the top of the toolbar. The menu bar’s drop-down windows duplicate many of the functions of the toolbar buttons.
Chapter 2 — The Playback Application 45 Pause – Click to pause playback of the clip. Click the Play button to resume normal playback of the clip. The Default is to pause on the individual video field, unless the “Freeze Frame” box is checked in the General setup window (Figure 2-11). Slow Motion – Click to play the video in slow motion. Click the Play button to resume normal playback. Fast Forward – Click to play the clip in fast motion. Click the Play button to resume normal playback of the clip.
46 CineView Pro Decoder Family 2.6 User Manual and API Guide Mute/Unmute – Click to mute or restore the audio portion of the clip playback. Video Blanking – Click to blank out the audio and video on both the host computer and through the external video and audio outputs. Click again to restore the signal. VGA Output – Click to enable or disable VGA display of the current clip playback. Does not affect external video.
Chapter 2 — The Playback Application 47 Figure 2-3. File Open Window with Supported Types Status Bar As shown in Figure 2-4, the status bar, a subdivided area making up the lower border of the playback toolbar, can display real-time information on the decoder and current playback session. Figure 2-4. Status Bar Layout Tool Tips – Displays helpful information on the current tool or function in use. Decoder State – Displays the current state of the decoder.
48 CineView Pro Decoder Family 2.6 User Manual and API Guide File Info – Displays the file name of the current MPEG clip (or the file name of the last clip played). Time Code – Displays GOP time code as read by the on-board DSP processor from the MPEG video stream. Menu Bar Items along the menu bar at the top of the window can be clicked on to bring down sub-menus that duplicate many of the functions of the toolbar buttons.
Chapter 2 — The Playback Application 49 View Menu – Shows available display options: VGA Mode: Enables or disables VGA display of the current clip playback. Does not affect external video. Updated VGA: Enables the use of an updated VGA display that allows windows to be played on top without the picture showing through. Full-screen playback is also possible when Updated VGA is selected.
50 CineView Pro Decoder Family 2.6 User Manual and API Guide MPEG File Properties Window (Figure 2-5) This window displays properties of the MPEG file that is currently selected for viewing. It is accessed from either File Menu > Properties or from the Properties button on the application toolbar. Figure 2-5.
Chapter 2 — The Playback Application 51 Using Playlist The CineView Pro Playlist feature is used to create, modify, and/or play back a list of files in the playlist. In order to do this, activate the Playlist GUI by clicking on the Playlist button on the playback toolbar or click on Playlist in the dropdown View menu (Figure 2-6). For an explanation of buttons and features on the toolbar, refer to “Playback Toolbar,” page 44. Figure 2-6.
52 CineView Pro Decoder Family 2.6 User Manual and API Guide Once a playlist file is opened, it can be modified. New clips can be added to it by clicking on the Add button. Clips can be deleted by clicking on the Delete button. The order of the playback of the clips can be changed. This is done by clicking and dragging a clip to a desired position in the list. “Seamless” Indicator – This indicator, located on the Playlist GUI window (Figure 2-7), shows whether or not a playlist is seamless.
Chapter 2 — The Playback Application 53 Figure 2-9. Playlist “Open Files” Window Figure 2-10.
54 CineView Pro Decoder Family 2.6 User Manual and API Guide Playback Setup Windows When the Setup button is clicked on the main playback application toolbar, or the Settings menu Setup selection is clicked, one of three system setup windows will appear. To switch among the windows, click the tabs displayed in each window. General Setup Window (Figure 2-11) This window is where parameters related to overall video clip playback are set and changed. Figure 2-11.
Chapter 2 — The Playback Application 55 Enable Freeze Video on Under Run – This feature is under development and is not currently supported. Freeze Frame – When checked, video will automatically freeze on the first video frame of the selected playback clip when the file is opened. This can serve as a convenient cueing or pre-loading tool. To start playback, press Play as normal. Default is unchecked.
56 CineView Pro Decoder Family 2.6 User Manual and API Guide VGA Setup Window (Figure 2-12) This window is where changes are made that affect the appearance of the host computer VGA display. The values set here have no effect on the composite or serial D-1 external outputs. NOTE: Editing any value on this window causes real-time changes to be applied to the current video playback.
Chapter 2 — The Playback Application 57 Default Button – Restores brightness, contrast, and saturation levels to their default settings. Lock 4:3 aspect ratio – When checked, prevents inadvertent resizing of the VGA output window width/height ratio by locking in the broadcast standard 4:3 aspect ratio. Has no effect on external video. OK Button – Click to save the current settings to the on-board EEPROM and dismiss the window.
58 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 2-13. Audio/Video Setup Window Burst Ampl – Sets the amplitude of the chroma burst signal. Color Bars Button – Click to bring up a color bar display. For use with composite video output only. Default Button – Click to restore all settings on this window, except Video Gain, to factory defaults. Enable Ext. Genlock – Check this box if the output video signal is to be locked to an external video source.
Chapter 2 — The Playback Application 59 Horizontal – Adjusts the output sync phase relative to the genlock input. Audio Headroom – Click the radio button for 18dBm or 20dBm as desired to match the audio system used for the CineView Pro decoder. PCM Audio Settings – This feature is under development and is not currently supported. OK Button – Click to save the current settings to the on-board EEPROM and dismiss the window.
60 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 2-14. OSD Setup Window vertical pixels. Therefore, depending on which Stream Type and Lines are chosen in the General Setup Window, the Position Y constriction is applied by dividing the line chosen by two. Blend 100%, 75%, 50%, and 25% – These four radio buttons represent the blending (transparency) level for the OSD region. If Blend 100% is checked, there will not be any transparency and no video shows through the OSD region.
Chapter 2 — The Playback Application 61 Clear Background – If this option is enabled, the first pixel color of the bitmap loaded for OSD is assumed to be the background color and that color will be cleared when OSD is loaded. If this option is changed, the Send button must be clicked again in order to load the bitmap accordingly. NOTE: If the bitmap has some foreground colors that are the same as the background color, those colors in the foreground will also be cleared when OSD is loaded.
62 CineView Pro Decoder Family 2.6 User Manual and API Guide Sample2 – This button loads nine bitmaps for animation. It loads nine Vela logos that have comets orbiting. This sample takes the X and Y position from the X and Y edit boxes in the “Make Decoder Ready for OSD” group and sets the same position for all bitmaps. NOTE: When one of the two sample buttons is clicked, it takes couple of seconds for the application to load all the bitmaps.
Part Two API Development Chapter 3 API Overview Chapter 4 The COM API Chapter 5 Advanced API Development
Chapter 3 API Overview Section Overview This portion of the manual, Part Two, is intended to facilitate the development of custom user interfaces to the CineView Pro XL, CineView Pro and CineView Pro LE decoder boards using the Vela Application Programming Interface and the associated Software Developer’s Kit (SDK). It is assumed that the developer has a working knowledge of Microsoft Visual C++, COM, and programming in a Windows 2000 or NT environment.
66 CineView Pro Decoder Family 2.6 User Manual and API Guide destinations for the output video. The optional video FPGA will provide for audio embedding of up to 4channels and an LTC output. The Audio decoders are the Crystal CS4924 AC-3/Musicam decoders. The outputs of the decoders are sent to the CS8420 sample rate converters with built in AES transmitters. The bi-phase outputs of the sample rate converters are directly connected to the AES transformers.
Chapter 3 — API Overview 67 • Vela CineView Pro XL, CineView Pro, or CineView Pro LE decoder board. • PCI-compliant VGA controller with accessible linear frame buffer (support for high bit 16 or high bit 24 required). • Fast/Wide SCSI hard drive (recommended) or EIDE hard drive (EIDE limited to max. 6Mbps MPEG-2 files on playback). Software Requirements • Vela CineView Pro Software Developer’s Kit. • C++ compiler (Microsoft Visual C++ 6.0 or later running in a 32-bit programming environment).
68 CineView Pro Decoder Family 2.6 User Manual and API Guide Installation Refer to Chapter 1 of this manual for complete hardware, software, and SDK installation instructions for the particular CineView Pro decoder you are using. Building An Application SDK • Use the .tlb file to access the public interfaces of the classes. • Add the following file to the project: ddraw.
Chapter 3 — API Overview 69 • Object library module: ddraw.lib Resource preprocessor definitions: NDEBUG and _AFXDLL Suggested Reading The following are some suggested reading materials. If the developer has not been exposed to COM or C++ programming, it is highly recommended that a short course be taken in the applicable subject. C++ and Visual C++ Textbooks The C++ Programming Language, Stroustrup. The C++ bible.
70 CineView Pro Decoder Family 2.6 User Manual and API Guide Customer Support In the event of questions or problems with Vela Application Programming Interface materials or this manual, do not hesitate to contact Vela Training and Support. • Phone — (727) 507-5301 • E-mail — support@vela.com • World Wide Web — http://www.vela.
Chapter 4 The COM API The COM-based API for the Vela CineView Pro family of decoders provides a set of binary-independent methods that can be used on any Microsoft Windows 2000 or NT-based development system that supports ActiveX and COM (Component Object Model). For example, the methods can be included in user interfaces written in Microsoft Visual C++™ or Microsoft Visual Basic™. They can even be used with Microsoft end-user applications such as MS Access™.
72 CineView Pro Decoder Family 2.6 User Manual and API Guide Method Description (Continued) GetBitsMoved Gets variable tracking number of bytes. GetBytesMoved Returns the total number of bytes sent to the decoder since playback began. GetCurrentSettings Gets the current video setup parameters. GetDecoderState Returns the current state of the decoder GetDecoderVersion Reads board version id from SAA7146. GetDefaultSettings Retrieves the default settings from the tables.
Chapter 4 — The COM API Method 73 Description (Continued) OpenStream2Uni Opens VGA video stream (Unicode). Pause Pauses the playback. Play Begins MPEG file playback. Play2 Begins playback of an MPEG data stream. Play3 Begins MPEG file playback from a byte offset. PlayFromPin Begins playback of data from a pin. PlayPcmAudio Begins PCM file playback from a byte offset. PlayPcmAudio2 Begins PCM file playback from a byte offset. ReadEpldRevision Returns programmable hardware revision.
74 CineView Pro Decoder Family 2.6 User Manual and API Guide Method Description (Continued) SetNextPlayListFile Sets the next playlist filename for use after the current file playback completes. SetSrcRect Sets the source rectangle. SetSrcRectUni Sets the source rectangle (Unicode). SetVisibleRect Sets video window-visible rectangles. SlowMotion Changes playback mode to slow motion. StartStream Starts streaming video to VGA display.
Chapter 4 — The COM API 75 AVStream Class Methods The methods for the AVStream class distributed with this API include: Method Description Close Open Start Stop Table 4-3. AVStream Class Methods FrameControlledPlayback Class Methods The methods for the FrameControlledPlayback class distributed with this API include: Method Description FrameAccuratePlay Starts frame-accurate playback of video file. Initialize Prepares frame-accurate interface to play back video file. Table 4-4.
76 CineView Pro Decoder Family 2.6 User Manual and API Guide A method is simply a public interface. The method will do something and will return a result code of some sort. To work well with COM, and with the future expansion into DCOM, every method call in our components returns an HRESULT return code. This return code should always be checked for validity and success of the function. The HRESULT is a 32-bit integer. Visual Basic will automatically intercept the error and go to an exception handler.
Chapter 4 — The COM API 77 CVProServer Class Properties A number of properties are available to the application developer to customize the behavior of the CineView Pro decoder. Currently supported CVProServer properties are as follows: Property Description AC3Mode BOOL read/write property to indicate if AC-3 bit stream output is enabled or disabled. Audio20dbfs Short read/write property that determines the audio headroom.
78 CineView Pro Decoder Family 2.6 User Manual and API Guide Property Description (Continued) ChromaType BOOL read/write property indicating 4:2:0 or 4:2:2 chroma format setting. Contrast Integer read/write property that determines the contrast level of the video. FirstVideoLine Integer read/write property indicating whether the first video appears on line 6 or line 7. FreezeFieldMode BOOL read/write property indicating whether to pause on a single field or a frame.
Chapter 4 — The COM API Property 79 Description (Continued) ProgramID Integer read/write indicating the program ID number for playback. Saturation Integer read/write property that determines the saturation level of the video. ShowVGADisplay BOOL read/write property that determines whether or not to show the updated VGA display. SlowMotionRate Integer read/write property that determines the speed of the slow motion playback.
80 CineView Pro Decoder Family 2.6 User Manual and API Guide FrameControlledPlayback Class Properties Currently supported FrameControlledPlayback properties are as follows: Property Description EndControlType Specifies which property the FrameControlledPlayback interface will use to end the playback. EndFrame Sets frame number of the frame at which the playback will stop. EndTime Sets the time code at which the playback will stop. FrameControlMode Not Implemented.
Chapter 4 — The COM API 81 object using the Initialize2() method. The second parameter contains a handle of the window to which the message will be sent. You must add code to capture this windows message (refer to the example code on the CD-ROM). Constants There are a number of decoder state and stream type constants available to the application developer to facilitate development.
82 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 4-1. VC++ Class Wizard Main Window core details and COM specifics. We also suggest using MFC as a DLL from App Wizard, as all of the COM components are already using this DLL. (Figure 4-1) From within your project, open the Class Wizard, and press the Add Class button. You will see a couple of selections. Pick the one labeled “From a Type Library.” Then select the DLL that contains the component you want to use.
Chapter 4 — The COM API 83 Figure 4-2. Class Wizard Class Creation However, you can't use the component quite yet. In the introduction we mentioned the fact that the component had to be registered with the operating system. We can now use that registration information from within our program. Since the COM component is registered with the operating system, these Win32 function calls will query the file system to see if the component exists.
84 CineView Pro Decoder Family 2.6 User Manual and API Guide Figure 4-3. Resulting C++ Class in Workspace At this point in the program we can access the class method calls that were created for us by the Class Wizard. Of course, good programming habits are assumed here, as you should always check for return values (hr, for example). Details about COM and Windows programming are too in-depth for this API document, but should be investigated further by the reader.
Chapter 4 — The COM API 85 Code Listing #1 (Visual C++) ICineView *m_pCineView; _Module.Init(NULL, NULL); hr=CoInitialize(); // Create instance of the CineView object hr=CoCreateInstance(CLSID_CineView,NULL, CLSCTX_INPROC_SERVER, IID_ICineView, (LPVOID*) &m_pCineView); ... // initialize decoder hr = m_pCineView->Initialize(&result); ...
86 CineView Pro Decoder Family 2.6 User Manual and API Guide Code Listing #2 (Visual Basic) Public WithEvents myCineView As CINEVIEWSERVERLib.CVProServer Sub Form_Load() Set myCineView = new CINEVIEWSERVERLib.CVProServer myCineView.Initialize 0 ‘ Initializes Card number 0 End Sub Sub Play_Click() Dim strCurrentFile as String Dim lRetVal as Long Dim lStreamType as Long lStreamType = 4 ‘ Multiplexed stream strCurrentFile = “D:\mpegfiles\first.mpg” myCineView.
Chapter 4 — The COM API 87 2. Includes a toolbar and pull-down menus for the end-user to manipulate. 3. Provides a dialog to modify the brightness, contrast, and saturation of the VGA output. If you examine the C++ code in the sample application provided, you will see sample code which uses the three roles performed by the application. The toolbar and pull-down menus can be found in mainfrm.cpp. The code to manipulate the VGA settings can be found in the VGADlg.cpp.
Chapter 5 Advanced API Development The following descriptions and usage examples of COM-based methods and properties are presented here for the benefit of advanced developers who can use the extra information in their CineView Pro program development efforts. An introductory look at the CineView Pro API methods and properties can be found in Chapter 4. The term “CineView Pro” is used here to represent the entire CineView Pro family of decoders: CineView Pro XL, CineView Pro, and CineView Pro LE.
90 CineView Pro Decoder Family 2.6 User Manual and API Guide Void CVLock (long nRetVal) Description This method is an interlock mechanism of the COM Server which insures that only one client at a time is allowed to change critical parameters. If the decoder is not currently playing, or if no other client has obtained the lock, then this method returns LOCK_AQUIRED, indicating success. If the lock is not acquired, it may return a CURRENTLY_LOCKED or CURRENTLY_PLAYING status.
Chapter 5 — Advanced API Development Void 91 CVUnlock Description This method releases the interlock mechanism, providing the requesting client is the client that obtained the lock. This method always returns an S_OK status. Parameters None Return Value None Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim nRetVal as Long objCVProServer.Initialize(0) ' Initializes card number zero. Any other commands will affect card 0 only. . objCVProServer.
92 CineView Pro Decoder Family 2.6 User Manual and API Guide DEBIReturn FastForward Description This method instructs the decoder card to skip frames to give the appearance of moving forward at a quicker pace. Return Value DEBIReturn is an enumeration. Its definition and values can be found in the “Definitions” section of this chapter, which starts on page 195. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lRetVal as Long objCVProServer.Initialize(0) . . . lRetVal = objCVProServer.
Chapter 5 — Advanced API Development DEBIReturn 93 FrameAdvance Description This method instructs the decoder board to advance by a single video frame. Parameters None Return Value DEBIReturn is an enumeration. Its definition and values can be found in the “Definitions” section of this chapter, which starts on page 195. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lRetVal as Long objCVProServer.Initialize(0) . . . lRetVal = objCVProServer.
94 CineView Pro Decoder Family 2.6 User Manual and API Guide DEBIReturn get_MicrocodeVersion (BSTR *sMicrocodeVersion) Description This method instructs the decoder card to return the microcode version installed on the CineView Pro card. Parameter BSTR sMicrocodeVersion: A string variable that will store the result of the query to the CineView Pro card. Return Value DEBIReturn is an enumeration.
Chapter 5 — Advanced API Development 95 Long GetAudioAttenuation Description This method returns the audio attenuation (volume) level that the CineView Pro card is set to. Parameters None Return Value The returned attenuation value of type long can range from 0 to 63, inclusive. A “0” means the card is outputting at its highest volume and “63” means the card is outputting at its lowest volume. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lRetVal as Long objCVProServer.Initialize(0) .
96 CineView Pro Decoder Family 2.6 User Manual and API Guide void GetAvailStreamRate (long StreamType, long wDeviceNum, long nPort, int *nRetVal) Description Not currently implemented. Always returns the “error not supported” status specified below. Parameters long StreamType long wDeviceNum long nPort int *nRetVal Return Value VS_ERR_NOT_SUPPORTED Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development void GetBitsPerPixel 97 (int nFormat, int *nRetVal) Description This method returns the number of bits per pixel for a given video format. An enumeration that indicates a particular video format. Parameters VideoFormat nFormat. The definition for this enumeration can be found in the Definitions section at the end of this chapter. Return Value An integer value indicating the number of bits per pixel. Example (VB) Dim objCVProServer as CineViewServer.
98 CineView Pro Decoder Family 2.6 User Manual and API Guide void GetBytesMoved (long *pLowByteCount, long *pHighByteCount) Description This method returns the total number of bytes sent to the decoder since playback began. This information may be used to drive a slider bar indicating the current position in a MPEG file. Parameters long *pLowCount long *pHighCount Return Value Two pointers to 32-bit integers that together represent the 64-bit total number of bytes sent to the decoder.
Chapter 5 — Advanced API Development long 99 GetCurrentSettings (LPDEFAULTCVPROSETTINGS Settings, long *lRetVal) Parameters LPDEFAULTCVPROSETTINGS Settings long lRetVal Return Value A structure containing the following video settings information. For the definition of the LPDEFAULTCVPROSETTINGS structure, see the “Definitions” section of this chapter, which starts on page 195. The RetVal parameter returned is not currently implemented. Example (VB) Dim objCVProServer as CineViewServer.
100 CineView Pro Decoder Family 2.6 User Manual and API Guide void GetDecoderState (lState as Long) Description This method returns the state of the decoder at the time of the function call. Parameters lState: A variable that stores the value that indicates the state of the decoder card.
Chapter 5 — Advanced API Development void GetDecoderVersion 101 (long *nRetVal) Description This method retrieves the type of decoder card installed in a computer. Parameters nRetVal: An integer value representing the type of decoder card installed, as follows: 0x2083 = CineView 0x2100 = CineView Pro 0x2110 = CineView Pro LE 0x2200 = CineView Pro XL Return Value None Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lVersion as Long ObjCvProServer.
102 CineView Pro Decoder Family 2.6 User Manual and API Guide long GetDefaultSettings (DefaultCVProSettings CVProSettings) Description This method retrieves the default settings used for this decoder card. Parameters LPDEFAULTCVPROSETTINGS Settings long lRetVal Return Value A structure containing the following default video settings information. See page 195 for the definition of the LPDEFAULTCVPROSETTINGS structure. The RetVal parameter returned is not currently implemented.
Chapter 5 — Advanced API Development void GetLockID 103 (long *nLockID) Description This method returns the Client ID number of the one that last called the method CVLock to gain an exclusive lock to the decoder card. Parameters long *nLockID Return Value Returns integer nLockID corresponding to the Client that currently “owns” the lock. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lLockID as Long objCVProServer.
104 CineView Pro Decoder Family 2.6 User Manual and API Guide long color; m_pService->GetMasterReg(VELA_BCS_CTRL, &color); m_pService->GetMasterReg(nRegister, nRetVal); void GetNextPlayListFile (BSTR bstrFilename , long llength) Parameters BSTR bstrFilename long llength Return Value Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development void GetStreamState 105 (long nRetVal) Description This method returns the current state of the muxed stream. Parameters Return value is a long integer indicating the current Video Stream state.
106 CineView Pro Decoder Family 2.6 User Manual and API Guide void GetTimeCode (long nFCount, long nRetVal) Description This method retrieves the time code of the frame that is being decoded at the time of the call. The value must then be parsed to retrieve the time in hours, minutes, seconds and frames. Parameters A long integer indicating the count and a return value for error messages. Return Value None. Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development void Initialize 107 (long nCardno) Description This method initializes a CineView Pro card plugged into the PC. Parameter nCardno: A value that indicates the card number in your PC that you wish to initialize and use. Card numbers can range from 0 to 3, inclusive. Return Value None Example (VB) Dim objCVProServer as CineViewServer.CVProServer objCVProServer.
108 CineView Pro Decoder Family 2.6 User Manual and API Guide void Initialize2 (long nCardno, long hWnd) Description This method initializes a CineView Pro card plugged into a PC. This method also ties a Window handle to the COM object to receive Windows messages. This feature is used for playlists of back to back MPEG-2 files with no black frames in between. Parameters nCardno: A value that indicates the card number in the PC that is to be initialized. Card numbers can range from 0 to 3, inclusive.
Chapter 5 — Advanced API Development void MuteAudio 109 (int iChannel, long MuteFlag) Description This method will either turn off or turn on the audio playback of an MPEG-2 file, depending on the setting of the MuteFlag value. Parameters iChannel: A value that indicates the audio channel number that is to be affected by this method call. MuteFlag: A value that indicates whether the audio will be turned off or on.
110 CineView Pro Decoder Family 2.6 User Manual and API Guide void OpenStream (VideoPort, VelaPCIPort vPCIPort, long bMinimized, long *nRetVal) Description This method sets up the parameters needed to set up a DirectX window to display decoded video data on a computer monitor. Parameter VideoPort: A long value that represents the address location of the tVelaVideoPort structure that is filled in by the application.
Chapter 5 — Advanced API Development 111 // Fill in values of objVideo structure and objPCI structure. Sample values // can be found in the SDK Visual C++ sample. .
112 CineView Pro Decoder Family 2.6 User Manual and API Guide void OpenStream2 (VideoPort, VelaPCIPort vPCIPort, long *nRetVal) Description This method sets up the parameters needed to set up a DirectX window to display decoded video data on a computer monitor. This method assumes the window that will contain the video output will be displayed normally. Parameters VideoPort: A long value that represents the address location of the tVelaVideoPort structure that is filled in by the application.
Chapter 5 — Advanced API Development VSReturn OpenStream2Uni *nRetVal) 113 (VideoPort, VelaPCIPort vPCIPort, long Description This method executes the same procedure that the method OpenStream2 does. This function is made available for those that wish to include Unicode support in their applications. Parameters VideoPort: A long value that represents the address location of the tVelaVideoPort structure that is filled in by the application.
114 CineView Pro Decoder Family 2.6 User Manual and API Guide // can be found in the SDK Visual C++ sample. . // Call function m_pService->OpenStream(&m_VideoPort, &m_PciPort, lMinimized, &lRetVal); VSReturn OpenStream2Uni (VideoPort, VelaPCIPort vPCIPort, long bMinimized, long *nRetVal) Description This method executes the same procedure that the method OpenStream does. This function is made available for those that wish to include Unicode support in their applications.
Chapter 5 — Advanced API Development 115 ' Call function objCVProServer.OpenStream(objVideo, objPCI, lMinimized, lRetVal) Example (VC++) ICVProServerPtrm_pService; VelaVideoPort m_VideoPort;// video port descr. enum VelaPciPort m_PciPort;// PCI port descr. Enum long lMinimized, lRetVal; // Fill in values of objVideo structure and objPCI structure. Sample values // can be found in the SDK Visual C++ sample. .
116 CineView Pro Decoder Family 2.6 User Manual and API Guide DEBIReturn Pause () Description This method causes the decoder to freeze the video at the frame on display when the command is executed. Parameters None Return Value DEBIReturn is an enumeration. Its definition can be found in the “Definitions” section of this chapter, beginning on page 195. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lRetVal as Long . lRetVal = objCVProServer.
Chapter 5 — Advanced API Development void Play 117 (char *strFileName, long StreamType, DEBIReturn *nRetVal) Description This method instructs the CineView Pro decoder to begin decoding the file indicated in the first parameter of the method. Parameters strFileName: A string value that indicates the name of the MPEG-2 file that is going to be decoded using the CineView Pro card. StreamType: An integer value that indicates the stream type of the MPEG-2 file.
118 CineView Pro Decoder Family 2.6 User Manual and API Guide void Play2 (long StreamType, DEBIReturn *nRetVal) Description This method instructs the CineView Pro decoder to begin decoding. MPEG-2 data to be used for decoding has already been fed into an internal buffer. This is a carryover from previous versions. Please use the method PlayFromPin to begin decoding from these pins or internal buffers. Parameters StreamType: An integer value that indicates the type of stream the MPEG-2 file is.
Chapter 5 — Advanced API Development long Play3 119 (char *strFileName, long StreamType, long HiOffset, long LowOffset) Description This method instructs the CineView Pro decoder to begin decoding at a point in the MPEG-2 file indicated by the HiOffset and LowOffset parameters. Parameters strFileName: A string value that indicates the name of the MPEG-2 file that is going to be decoded using the CineView Pro card. StreamType: An integer value that indicates the stream type of the MPEG-2 file.
120 CineView Pro Decoder Family 2.6 User Manual and API Guide void PlayFromPin (char strPinName, long StreamType, long nRetVal) Description This method instructs the decoder card to obtain the muxed data from a section of memory (called a pin) instead of from a file name. The application is responsible for feeding the data into the pin. Parameters strPinName: The name of the OutPin (memory buffer) that contains MPEG-2 data to be used for decoding.
Chapter 5 — Advanced API Development 121 // end loop m_pService->PlayFromPin(strLocalPin, StreamInfo.
122 CineView Pro Decoder Family 2.6 User Manual and API Guide void PlayPCMAudio (BSTR strFileName, long HiOffset, long LowOffset, long *nRetVal) Description This method instructs the CineView Pro decoder card to begin decoding an MPEG-2 file that is an audio stream only. The decoding will begin at the point in the file indicated by the HiOffset and LowOffset values. Parameters strFileName: A string value that indicates the name of the MPEG-2 file that is going to be decoded using the CineView Pro card.
Chapter 5 — Advanced API Development void 123 PlayPCMAudio2 (char *strFileName, long StereoMode, long Rate, long HiOffset, long LowOffset, long *nRetVal) Description This method instructs the CineView Pro decoder to begin decoding an MPEG-2 file that is an audio stream only. The decoding will begin at the point in the file indicated by the HiOffset and LowOffset values.
124 CineView Pro Decoder Family 2.
Chapter 5 — Advanced API Development void ReadEpldRevision 125 (long *nRetVal) Description This method retrieves the revision number from the programmable logic devices (referred to as PLDs) of the CineView Pro. Parameter nRetVal: A variable of type long that stores the revision number found in the PLDs of the CineView Pro.
126 CineView Pro Decoder Family 2.6 User Manual and API Guide void ResetBytesMoved () Description This method resets the indicator of how many bytes of MPEG data have been processed already back to zero. Parameters None Return Value None Example (VB) Dim objCVProServer as CineViewServer.CVProServer objCVProServer.
Chapter 5 — Advanced API Development DEBIReturn Resume 127 () Description This method instructs the decoder card to return to normal play of the decoded file. This command should only be executed after a trick mode has been executed (i.e. Pause, Fast Forward, Slow Motion). Parameters None Return Value The value returned is from the enumeration DEBIReturn. Its definition can be found in the Definitions section of this chapter, which begins on page page 195.
128 CineView Pro Decoder Family 2.6 User Manual and API Guide void SetAudioAttenuation (int Channel, int Attenuation) Description This method allows the user to set the volume level of the audio output. Parameters Channel: An integer value that indicates the channel number that you wish to set the attenuation (volume) on. Attenuation: An integer value that indicates the level of attenuation the card is outputting.
Chapter 5 — Advanced API Development void SetClipMask 129 (VRECT vRect, Mask, long nRetVal) Description This method creates a custom area and mask for the video stream to be displayed at on a computer monitor. Use this command if you are not compiling with a Unicode option. Parameters vRect: A structure definition that stores border information (X Position, Y Position, length and width). Mask: Used as argument for call to SafeArrayAccessData( ).
130 CineView Pro Decoder Family 2.6 User Manual and API Guide VSReturn SetClipMaskUni (VRECT vRect) Description This method creates a custom area and mask for the video stream to be displayed at on a computer monitor. Use this command if you are compiling with a Unicode option. Parameter vRect: A structure definition that stores border information (X Position, Y Position, length and width). Return Value VSReturn: An enumeration value that indicates whether the execution of the command was successful.
Chapter 5 — Advanced API Development void SetDestRect 131 (VRECT vRect, long nRetVal) Description This method sets the rectangular area of the monitor where the video stream output will be displayed. Use this command when you are compiling without the Unicode option set. Parameters vRect: A structure definition that stores border information (X position, Y position, length and width) nRetVal: An integer value that stores the return value of the command.
132 CineView Pro Decoder Family 2.6 User Manual and API Guide VSReturn SetDestRectUni (VRECT vRect) Description This method sets the rectangular area of the monitor where the video stream output will be displayed. Use this command when you are compiling with the Unicode option set. Parameter vRect: A structure definition that stores border information (X position, Y position, length and width) Return Value VSReturn: An enumeration value that indicates whether the execution of the command was successful.
Chapter 5 — Advanced API Development void SetFilePos 133 (long HiOffset, long LowOffset, long *nRetVal) Description This method stops the decoder card from decoding, resets and starts decoding again from the file position indicated in its parameters. Parameters HiOffset: A value of type long that represents the first 32 bits of a 64-bit value indicating where along the MPEG-2 file the decoding is to start.
134 CineView Pro Decoder Family 2.6 User Manual and API Guide void SetMasterReg (long nReg, long dwValue, long bUpload, long nRetVal) Description This method sets the PCI register on the SAA7146 chip. This register is mainly used to set the brightness, contrast and saturation levels for the VGA output. Parameters nReg: A long value that indicates what command to associate with this register setting. For adjusting the colors, this value is usually 112.
Chapter 5 — Advanced API Development void SetMidStreamStart 135 (BOOL newVal) Description This method sets a flag to indicate the API is in MidStreamStart mode. The SetMidStreamStart mechanism is not currently used by the CineViewPro Client application. Parameters newVal: A Boolean value indicating whether to set or clear MidStreamStart mode. Return Value None Example (VB) Dim objCVProServer as CineViewServer.CVProServer ' Clear MidStreamStart mode objCVProServer.
136 CineView Pro Decoder Family 2.6 User Manual and API Guide void SetNextPlayListFile (char * strFileName) Description This method is used to indicate the next MPEG-2 file to be played when the decoder is in back to back with no black frames in between mode. The programmer is to use this method when the application receives a windows message indicating it is ready to receive the next file.
Chapter 5 — Advanced API Development void SetSrcRect 137 (VRECT vRect, long nRetVal) Description Sets the video or acquisition window rectangle. Parameters VRECT vRect: A structure containing a rectangle startX, StartY, width, and height parameters. The structure is defined in the “Definitions” section of this chapter, which starts on page 195. nRetVal: A variable of type long that stores the result of the command. The values returned are the same as the values in the enumeration DEBIReturn.
138 CineView Pro Decoder Family 2.6 User Manual and API Guide VSReturn SetSrcRectUni (VRECT vRect) Description Unicode version of the method that sets the video or acquisition window rectangle. Parameters VRECT vRect: A structure containing a rectangle startX, StartY, width and height parameters. The structure is defined in the “Definitions” section of this chapter, which starts on page 195. Return Value VSReturn: An enumeration value that indicates whether the execution of the command was successful.
Chapter 5 — Advanced API Development long SlowMotion 139 (long Speed) Description This method sets the decoder to display the same frame for a period of time to simulate slow motion. Parameter Speed: A value of type long that tells the decoder how many times each frame should be repeated to simulate slow motion. The values can range from 1 (very little slow motion) to 7 (very noticeable slow motion). Return Value The value returned is actually from the enumeration DEBIReturn.
140 CineView Pro Decoder Family 2.6 User Manual and API Guide VSReturn StartStream () Description This method instructs the decoder card to begin feeding decoded video data into the DirectX video driver for display on a computer monitor. Parameters None Return Value VSReturn: An enumeration value that indicates whether the execution of the command was successful. The definition of this enumeration can be found in the “Definitions” section of this chapter, which starts on page 195.
Chapter 5 — Advanced API Development void Stop 141 (long *nRetVal) Description This method instructs the decoder card to stop its current decode and place itself in a wait state. Parameter nRetVal: A variable of type long that stores the result of the command. The values returned are the same as the values in the enumeration DEBIReturn. The enumeration and its defining values can be found in the “Definitions” section of this chapter, which starts on page 195.
142 CineView Pro Decoder Family 2.6 User Manual and API Guide VSReturn StopStream () Description This method stops the decoder card from feeding video data to the DirectX driver for display on a computer monitor. Parameters None Return Value VSReturn: An enumeration value that indicates whether the execution of the command was successful. The definition of this enumeration can be found in the “Definitions” section of this chapter, which starts on page 195.
Chapter 5 — Advanced API Development long StoreVideoSettings 143 (VelaVideoSettings Settings) Description This method saves decoder setting information into the EEPROM. Parameters LPVELAVIDEOSETTINGS: Settings structure containing settings information. See the “Definitions” section of this chapter, which starts on page 195. Return Value A long value that indicates success or failure. A value of zero indicates success where as any value other than zero indicates a problem.
144 CineView Pro Decoder Family 2.6 User Manual and API Guide CVProServer Class Property Descriptions Long AC3Mode Description This property either gets or sets the value of whether AC-3 bit stream out is enabled or not. This also disables one audio channel. Values can be as follows: 0 = AC-3 bit stream will be disabled 1 = AC-3 bit stream will be enabled Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lAC3Mode as Long objCVProServer.
Chapter 5 — Advanced API Development Long Audio20dbfs 145 (Channel As Integer) Description This property either gets or sets the PCM1716 DAC Mode Register to provide audio output level at one of two scales. Parameter Channel (Type: Integer): Indicates which channel number you want to get the value for or set the value to. Values can be as follows: 1 = 24 dBm full scale 0 = 22 dBm full scale Example (VB) Dim objCVProServer as CineViewServer.
146 CineView Pro Decoder Family 2.6 User Manual and API Guide Integer AudioPID (Channel As Integer) Description This property either gets or sets the ID number of the audio stream in an encoded file. Values can range from 0 to 232 –1, inclusive. Parameter Channel (Type: Integer): Indicates which channel number you want to get the value for or set the value to. Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development Long 147 AutoDetect Description This property either gets or sets the CineView Pro decoder board to auto-detect the properties of an MPEG-2 file (Number of Lines, NTSC/PAL, 4:2:2 flag) via our own file parsing method or manually. Values can be as follows: 0 = Settings are set manually by the user 1 = Settings are automatically detected using Vela's file parsing (Default) Example (VB) Dim objCVProServer as CineViewServer.
148 CineView Pro Decoder Family 2.6 User Manual and API Guide Long Bars Description This property either gets or sets the output of composite color bars. Values can be as follows: 0 = No color bars are generated to composite output 1 = Color bars are generated to composite output Example (VB) Dim objCVProServer as CineViewServer.CVProServer ' bars are being generated and sent to composite output ObjCVProServer.
Chapter 5 — Advanced API Development 149 Long BlackLevel Description This property either gets or sets the value of the level of black in the composite video output. Values can range from 0 to 63, inclusive, where: 0 = Highest level of black available (maximum black) 63 = Lowest level of black available (minimum black) Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lLevel As Long ' Gets current Black level value lLevel = objCVProServer.
150 CineView Pro Decoder Family 2.6 User Manual and API Guide Long BlankLevel Description This property either gets or sets the value of the level of blank (or white) in the composite video output. Values can range from 0 to 63, inclusive, where: 0 = Highest level of blank (white) available (maximum blank or white) 63 = Lowest level of blank available (minimum white) Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development 151 Long BlankVideo Description This property either gets or sets the option of whether or not video is to be output. Values can be as follows: 0 = Video will be output normally 1 = Video will not be output at all Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lBlank As Long 'lBlank stores value of whether or not composite video is blank or not lBlank = objCVProServer.
152 CineView Pro Decoder Family 2.6 User Manual and API Guide Long Brightness Description This property either gets or sets the level of brightness (balance of light and dark shades) used in the VGA output (output placed on your computer monitor). Values can range from 0 to 255, inclusive, where: 0 = No balance between light and dark shades used 255 = Highest level of balance available Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development 153 Long BurstAmpitude Description This property will either get or set the amplitude of the 3.579545 Mhz color reference subcarrier sample which is added to the back porch of the horizontal sync pulse. Values can range from 0 to 127 where: 0 = No amplitude set 127 = Highest amplitude set Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lBurst As Long objCVProServer.BurstAmplitude = 127 ' Highest level it can be set to lBurst = objCVProServer.
154 CineView Pro Decoder Family 2.6 User Manual and API Guide Long ByteReorderMode Description This property will either get or set the two bytes of information read from the closed caption information, which is transmitted during the vertical interval. Closed captioning commonly uses one of two modes. If the wrong mode is used during decoding, the caption information may appear garbled.
Chapter 5 — Advanced API Development 155 Long ChromaPhase Description This property will either get or set a phase offset applied to both the color burst and the phase-modulated hue and saturation information, or chroma, which is added to each line of video. Values can range from 0 to 255, inclusive, where: 0 = No offset used for each video line 255 = Maximum offset used for each video line Example (VB) Dim Dim objCVProServer as CineViewServer.CVProServer lChroma As Long objCVProServer.
156 CineView Pro Decoder Family 2.6 User Manual and API Guide Long ChromaType Description This property either gets or sets the value that indicates the chroma type the card is set to use for decoding of MPEG files. Values can be as follows: 0 = 4:2:0 chroma type 1 = 4:2:2 chroma type 2 = 4:4:4 chroma type Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lChroma As Long lChroma = objCVProServer.ChromaType objCVProServer.
Chapter 5 — Advanced API Development 157 Long FirstVideoLine Description This property either gets or sets the setting of the first active line of video, which can either be line 6 or line 7. Values can be as follows: 6 = First active line of video is line 6 (default) 7 = First active line of video is line 7 Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lFirst as Long lFirst = objCVProServer.FirstVideoLine objCVProServer.
158 CineView Pro Decoder Family 2.6 User Manual and API Guide Long FreezeFieldMode Description This property either gets or sets the decoder pause mode where a single field is displayed as a frame, instead of alternating between two fields. When the decoder is paused, FreezeFieldMode has the effect of freezing apparent motion or jitter between two fields. Values can be as follows: 0 = Freeze on field as if it is a frame 1 = Freeze on frame (default) Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development 159 Long GainU Description This property either gets or sets the amplitude of the (B' - Y) or Blue minus luminance color difference signal which is added to each line of video. Values can range from 0 to 255, inclusive, where: 0 = No amplitude of Blue minus luminance color 255 = Maximum amplitude of Blue minus luminance color Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lGainU as Long objCVProServer.
160 CineView Pro Decoder Family 2.6 User Manual and API Guide Long GainV Description This property either gets or sets the amplitude of the (R' - Y) or Red minus luminance color difference signal which added to each line of video. Values can range from 0 to 255, inclusive, where: 0 = No amplitude of Red minus luminance color 255 = Maximum amplitude of Red minus luminance color Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lGainV as Long objCVProServer.
Chapter 5 — Advanced API Development 161 Long GenLock Description This property either gets or sets the value on whether the decoder hardware will lock on frequency and phase using an external source or not. Value can be as follows: 0 = CineView Pro does not use outside source for locking (standalone mode) (default) 1 = CineView Pro uses an external source for frequency and phase locking Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lLock as Long lLock = objCVProServer.
162 CineView Pro Decoder Family 2.6 User Manual and API Guide Long HorizontalPhase Description This property either gets or sets the delay between the decoder output horizontal sync and the input genlock sync source sync. Values are dependent on what format the MPEG file was encoded in. For the NTSC format, values can range from 0 to 1715, inclusive. For the PAL format, values can range from 0 to 1727, inclusive.
Chapter 5 — Advanced API Development 163 Long MaxLineResolution Description This property either gets or sets the number of lines, maximum, that will be displayed, in output. This setting is dependent on whether the file to be decoded, is in either NTSC or PAL format. Values can be as follows: 0 = Lower number of maximum lines (for NTSC is 480, PAL is 576) 1 = Higher number of maximum lines (for NTSC is 512, PAL is 608) Example (VB) Dim objCVProServer as CineViewServer.
164 CineView Pro Decoder Family 2.6 User Manual and API Guide Long MuxedStreamType Description This property either gets or sets the type of stream that is being used in decoding. Value can be as follows: 0 = Not an MPEG Stream 1 = A System Stream 2 = A Program Stream 3 = A Transport Stream 4 = A Video Elementary Stream 5 = An Audio Elementary Stream 6 = A Video Packetized Elementary Stream 7 = An Audio Packetized Elementary Stream Example (VB) Dim objCVProServer as CineViewServer.
Chapter 5 — Advanced API Development 165 Long NTSC Description This property either gets or sets the value on whether the MPEG file to be decoded is in NTSC or PAL format. Value can be as follows: 0 = PAL format 1 = NTSC format Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lType as Long objCVProServer.NTSC = 1 ' Sets decoder card to expect an NTSC file lType = objCVProServer.NTSC 'lType is set to 1.
166 CineView Pro Decoder Family 2.6 User Manual and API Guide Long PauseOnFFMode Description This property either gets or sets the value of whether the feature to turn on pause when the first frame is decoded is enabled or not. Value can be as follows: 0 = Pause on First Frame is Disabled (default) 1 = Pause on First Frame is Enabled Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lPause as Long objCVProServer.
Chapter 5 — Advanced API Development 167 Long PlayListMode Description This property either gets or sets the value of whether to enable or disable back to back playback with no black frames in between. Value can be as follows: 0 = BackToBack playback with no black is disabled (default) 1 = BackToBack playback with no black is enabled Example (VB) Dim objCVProServer as CineViewServer.CVProServer objCVProServer.PlayListMode = 1 ' Back to Back is enabled.
168 CineView Pro Decoder Family 2.6 User Manual and API Guide Long ProgramID Description This property either gets or sets the Identification number (ID) of a multiplexed MPEG-2 stream (has both audio and video data). Since changing the ID of a stream can affect it for future play, please use this property with caution. Values can range from 0 to 32678, inclusive Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lProgID as Long lProgID = objCVProServer.
Chapter 5 — Advanced API Development 169 Long Saturation Description This property either gets or sets the VGA saturation level. Saturation corresponds to the amount of color present. A hue at maximum saturation appears as a pure color with no white added, while a less saturated hue appears more pastel. Values can range from 0 to 100, inclusive, where: 0 = No saturation allowed at all 100 = Maximum level of saturation Example (VB) Dim objCVProServer as CineViewServer.
170 CineView Pro Decoder Family 2.6 User Manual and API Guide Long ShowVGADisplay Description This property gets or sets the value of whether to show the updated VGA display. Values can be as follows: 0 = VGA will not be showing 1 = VGA will be showing Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lVGAShowing as Long objCVProServer.ShowVGADisplay = 1 ' Server will show the updated VGA lVGAShowing = ObjCVProServer.
Chapter 5 — Advanced API Development 171 Long SlowMotionRate Description This property either gets or sets the rate of motion the decoder will display in output when it is in slow motion mode. Slow motion is accomplished by repeating frames. The slow motion value refers to the number of times each frame is to be repeated. Values can range from 0 to 7, inclusive where: 0 = video is displayed at normal speed 7 = video is displayed at slowest possible rate Example (VB) Dim objCVProServer as CineViewServer.
172 CineView Pro Decoder Family 2.6 User Manual and API Guide Long VGADisplay Description This property either gets or sets the value of whether to use the updated VGA display or the old VGA. Value can be as follows: 0 = Old VGA will be used 1 = Updated VGA will be used Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lVGADisplay as Long objCVProServer.VGADisplay = 1 ' Server will use the updated VGA lVGADisplay = ObjCVProServer.
Chapter 5 — Advanced API Development 173 Long VideoPID Description This property either gets or sets the Identification number (ID) of the video part of a multiplexed MPEG-2 stream. Since changing the ID of a stream can affect it for future play, please use this property with caution. Values can range from 0 to 232 -1, inclusive. Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lProgID as Long lProgID = objCVProServer.
174 CineView Pro Decoder Family 2.6 User Manual and API Guide Long VideoReference Description This property either gets or sets the amplitude of the composite video output, which includes video plus sync. Values can range from 0 to 100, inclusive, where: 0 = No amplitude of the composite video output 100 = Maximum amplitude of the composite video output Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lVideo as Long objCVProServer.
Chapter 5 — Advanced API Development 175 Long ZeroIRE Description This property either gets or sets the black level to either 0 IRE units or 7.5 IRE units and then reinitializes the 7185 digital video encoder hardware. Value can be as follows: 0 = 7.5 IRE units 1 = 0 IRE units Example (VB) Dim objCVProServer as CineViewServer.CVProServer Dim lZeroIRE as Long objCVProServer.ZeroIRE = 0 ' card is set to use 7.5 IRE units in black level lZeroIRE = objCVProServer.
176 CineView Pro Decoder Family 2.6 User Manual and API Guide CVProServer Class Event Descriptions There are no Events to describe.
Chapter 5 — Advanced API Development 177 OnScreenDisplay Class Method Descriptions long EnableOSD (bOn As BOOL, bBlendOn As BOOL, nRegionNum As Long) Description Enables or disables the OSD region specified. This command can be executed while a clip is playing in order to disable or enable the currently activated OSD region. You are not allowed to change the bBlendOn value of a region once the clip has started playing.
178 CineView Pro Decoder Family 2.
Chapter 5 — Advanced API Development void Initialize 179 (Card As Integer, bReserveMemory As BOOL) Description Initializes current decoder to receive OSD commands. Parameters short Card: Specifies which decoder board is to be initialized. Range: 0 to 3 BOOL bReserveMemory: specifies whether or not memory is to be reserved for the OSD region. 0 = Do not reserve OSD memory 1 = Reserve OSD memory Return Value void Example (VB) Dim objCVProOSD as CineViewServerLib.
180 long CineView Pro Decoder Family 2.6 User Manual and API Guide LoadBitmap (bstrFileName As BSTR, x As Long, y As Long, nRegionNum As Long, bTransBKGnd As BOOL, lBlendFactor As Long) Description Loads the bitmap file to be used for OSD. To load multiple bitmaps each bitmap must be given a unique nRegionNumber. Up to 16 bitmaps can be loaded at one time. The X and Y coordinates specify upper left corner of the bitmap. The width of the bitmap must be divisible by 8.
Chapter 5 — Advanced API Development 181 Example (VB) Dim objCVProOSD as CineViewServerLib.OnScreenDisplay lReturn = MyEvents.OSDObject.LoadBitmap(txtBMPFile.Text, lOSDXPos, lOSDYPos, 0, _ bOSDClearBKGrnd, lOSDBlendFactor) if lReturn <> 0 then 'An error has occurred while trying to load the bitmap End if Example (VC++) IOnScreenDisplayPtr int int int bool long int m_pOSD; m_Xpos = 50; m_Ypos = 50; m_nRegionCount = 0; m_bClearBackground = true; m_lBlendLevel = 75; errVal = m_pOSD->LoadBitmap(“C:\\temp.
182 long CineView Pro Decoder Family 2.6 User Manual and API Guide LoadRegion (bstrFileName As String, x As Long, y As Long, nRegionNum As Long) Description Used to activate a specific bitmap in a multiple bitmap OSD animation. This method has not been implemented. Instead use EnableOSD with nRegionNum set to the region number of the Bitmap you want to load.
Chapter 5 — Advanced API Development 183 OnScreenDisplay Class Property Descriptions There are no Properties to describe. OnScreenDisplay Class Event Descriptions There are no Events to describe.
184 CineView Pro Decoder Family 2.6 User Manual and API Guide FrameControlledPlayback Class Method Descriptions int nRetVal FrameAccuratePlay (BSTR bstrFileName, int StreamType) Description This method is used to start a frame-accurate play. This is used instead of the Play method in the CVProServer interface. You must set frame-accurate properties before calling this method.
Chapter 5 — Advanced API Development Void Initialize 185 (short nCardNum) Description Use Initialize to prepare a frame-accurate interface for playing back a file. Parameters nCardNum: Indicates the card number that you want the current instance of the FrameControlledPlayback interface to use. nCardNum may range from 0 to 3, inclusive. Return Value This method does not return a value.
186 CineView Pro Decoder Family 2.6 User Manual and API Guide FrameControlledPlayback Class Property Descriptions short EndControlType Description This property allows you to specify which property the FrameControlledPlayback interface will use to end the playback. Parameters A short specifying which method will be used to end playback. Values can be as follows: 0 = FrameEnd. Specifies that the EndFrame property will be used to end playback. 1 = TimeCodeEnd.
Chapter 5 — Advanced API Development long 187 EndFrame Description This property sets how many frames into the file you wish to stop playing. You must also specify a value of FrameEnd in the EndControlType property in order to end playback at the given frame. Parameter This value must be set to a value higher than the starting frame and must be a valid frame number.
188 CineView Pro Decoder Family 2.6 User Manual and API Guide BSTR EndTime Description This property is used to set the time code at which you wish to stop playing. You must also specify a value of TimeCodeEnd in the EndControlType property in order to end playback at the given time code. Parameter EndTime must have a time code value that is greater than the specified start point. It must also be a valid time code in the file you are trying to play.
Chapter 5 — Advanced API Development BOOL 189 FrameControlMode Description Not Implemented. long FrameDuration Description This property specifies the number of frames from the start point at which the playback will stop. You must also specify a value of FramesPlay in the EndControlType property in order to end playback at the given duration. Parameters Any valid number of type long that does not cause the duration plus starting point to go past the end of the file.
190 CineView Pro Decoder Family 2.6 User Manual and API Guide BOOL PauseOnFF Description Set this property to True to enable pause on the first frame. The playback will pause on the specified starting point and another play command must be issued in order to resume play. If the starting point given happens to be an I-frame in the given file, the FrameControlledPlayback interface will set the CVProServer interface PauseOnFFMode property to True in order to accurately pause on the first frame.
Chapter 5 — Advanced API Development BOOL 191 PauseOnLF Description Set this property to True to enable pausing on the last frame. The playback will pause on the specified end point. This property must be set prior to playback. Parameters A BOOL specifying pause on last frame, enabled or disabled. Values can be as follows: 1 = Pause on last frame is enabled. 0 = Pause on last frame is disabled (default).
192 CineView Pro Decoder Family 2.6 User Manual and API Guide short StartControlType Description This property allows you to specify which property the FrameControlledPlayback interface will use to start the playback. Parameters A short specifying which method will be used to start playback. Values can be as follows: 0 = FrameStart. Specifies that the StartFrame property will be used to start playback. 1 = TimeCodeStart. Specifies that the StartTime property will be used to start playback.
Chapter 5 — Advanced API Development long 193 StartFrame Description This property sets how many frames into the file you wish to start playing. You must also specify a value of FrameStart in the StartControlType property in order to start playback at the given frame. Parameter This value must be set to a value less than the ending frame and must be a valid frame number.
194 CineView Pro Decoder Family 2.6 User Manual and API Guide BSTR StartTime Description This property is used to set the time code at which you wish to begin playing. You must also specify a value of TimeCodeStart in the StartControlType property in order to start playback at the given time code. Parameter StartTime must have a time code value that is less than the specified end point. It must also be a valid time code in the file you are trying to play.
Chapter 5 — Advanced API Development 195 Definitions typedef enum // VelaPCI return codes { DEBI_NO_ERROR = 0, // No error CONFIGURE_DENC_ERROR, // error configuring DENC 7185 CONFIGURE_DMSD_ERROR, // error configuring DMSD 7111 DEBI_FILE_OPEN_ERROR, // error opening file DEBI_ISR_ERROR, // error registering interrupt service routine DEBI_DMA_TIMEOUT_ERROR, // error sending data to decoder DEBI_NULL_POINTER, // null pointer passed to function DEBI_MEMORY_ERROR, // decoder did not accept command DEBI_LOWER
196 CineView Pro Decoder Family 2.
Chapter 5 — Advanced API Development 197 int nGainV; int nBurstAmplitude; int nVideoRef; int nFirstLine; } VelaVideoSettings; typedef struct VelaVideoSettings __RPC_FAR *LPVELAVIDEOSETTINGS; typedef /* [uuid] */ struct VRECT { long nStartX; long nStartY; long nWidth; long nHeight; } VRECT; typedef struct VRECT __RPC_FAR *LPVRECT; enum VSReturn { VS_ERR_NONE VS_ERR_OPEN_CONFIG VS_ERR_OPEN_INUSE VS_ERR_OPEN_FORMAT VS_ERR_CLOSE VS_ERR_START VS_ERR_STOP VS_ERR_STATE VS_ERR_SET VS_ERR_SET_SCALER VS_ERR_SET_CLI
198 CineView Pro Decoder Family 2.
Chapter 5 — Advanced API Development 199 DEBI_NULL_POINTER, DEBI_MEMORY_ERROR, DEBI_LOWER_VOLUME_LIMIT, // null pointer passed to function // decoder did not accept command // lower audio volume limit has been reached DEBI_UPPER_VOLUME_LIMIT, // upper audio volume limit has been reached DEBI_TIMEOUT_ERROR, // transfer timed out DEBI_ERROR, // general error encountered DSP_COMMAND_ERROR, // DEBI_OUT_OF_RANGE, // value out of range DEBI_COMMAND_ERROR, // invalid command for current decoder state DSP_COMPLE
200 CineView Pro Decoder Family 2.
Chapter 5 — Advanced API Development 201 VF_RGB15_A555= VF_RGB16_565 + 1, VF_RGB15_55A5= VF_RGB15_A555 + 1, VF_RGB8_332= VF_RGB15_55A5 + 1, VF_RGB16_DITHER= VF_RGB8_332 + 1, VF_RGB15_DITHER= VF_RGB16_DITHER + 1, VF_RGB15_DITHER_1= VF_RGB15_DITHER + 1, VF_RGB8_DITHER= VF_RGB15_DITHER_1 + 1, VF_YUV444= VF_RGB8_DITHER + 1, VF_YUV422= VF_YUV444 + 1, VF_YUV411= VF_YUV422 + 1, VF_YUV8= VF_YUV411 + 1, VF_YUV8_GRAY= VF_YUV8 + 1, VF_YUV444_PLANAR= VF_YUV8_GRAY + 1, VF_YUV422_PLANAR= VF_YUV444_PLANAR + 1, VF_MPEG42
202 CineView Pro Decoder Family 2.
Part Three Appendices and Index Appendix A CineView Pro XL, Pro and Pro LE Specifications Appendix B Troubleshooting the CineView Pro Family of Decoders Index
Appendix A Specifications Vela CineView Pro Family of Decoders CineView Pro XL Decoder General • Supports decoding of the following image resolutions: NTSC PAL 352×240 352×480 480×480 544×480 640×480 704×480 720×480 720×512 (4:2:2) 352×288 352×576 480×576 544×576 704×576 720×576 720×608 (4:2:2) • Supported stream formats: MPEG-1 Elementary streams MPEG-1 System streams MPEG-2 Elementary streams MPEG-2 Packetized Elementary streams (PES) MPEG-2 Program streams MPEG-2 Transport streams • Supports MPEG d
206 CineView Pro Decoder Family 2.6 User Manual and API Guide Digital Video • SMPTE 259M-C; 270Mbps; 525/625 line component serial digital (SDI) output via BNC connector • • • • • • • • Format fully Compliant With SMPTE 259M Amplitude: 800mv ± 10% DC Offset: 0.0v ± 0.5v Rise and fall times: No less than 0.4ns; no greater than 1.5ns Overshoot: Less then 10% of amplitude Timing Jitter: 0.
Appendix A — Specifications 207 • Jitter: 75 Ohm: ±10ns 110 Ohm: ±10ns • Fall Time: 5ns <30ns (110-ohm differential termination) 30ns <44ns (75-ohm termination) • Rise Time 5ns <30ns (110-ohm differential termination) 30ns <44ns (75-ohm termination) • Output voltage 75-ohm: 1.0v P-P ±10% 110-ohm: 2.2v P-P ±10% Analog Audio • • • • • • • 15-pin high-density D-sub connector Dual two-channel decoders Frequency Response: 20Hz to 20kHz ±0.
208 CineView Pro Decoder Family 2.6 User Manual and API Guide • +12VDC ±5% @ 160ma (typ) • - 12VDC ±5% @ 50ma (typ) Operating Environment • Temperature: Operating: 41° to 104°F (5° to 40°C). Non-operating: –40°F to 149°F (–40°C to 65°C). • Humidity (Non-condensing): Operating: 10% to 90%. Non-operating: 5% to 95%, packaged. • Maximum wet bulb humidity: Operating: 80.6°F (27°C). Non-operating: Non-condensing. • Air flow @77°F (25°C): Operating: TBD. Non-operating: N/A. • Altitude: Operating: 0 to 2.
Appendix A — Specifications 209 MPEG-2 Packetized Elementary streams (PES) MPEG-2 Program streams MPEG-2 Transport streams • Supports MPEG data rates up to 50Mbps (system dependant) • Reconstruction of I, P, and B frames • Supports MPEG-1 video compression encapsulated in MPEG-2 Program and Transport streams • Built-in VGA video display support.
210 CineView Pro Decoder Family 2.6 User Manual and API Guide • Audio output volume level and mute function accessible through playback application and SDK. • Supports MPEG-2 audio PES. • Digital Audio Figures: (CineView Pro only) Connector: 15-pin high-density D-sub. Standard: AES3-1992; 110 ohms, balanced output; 75 ohms, unbalanced output. Simultaneous digital AES/EBU and analog stereo audio outputs. • Analog Audio Figures: Connector: 15-pin high-density D-sub. Output level: +4dBm = 0Vu.
Appendix A — Specifications 211 Non-operating: –40°F to 149°F (–40°C to 65°C). • Humidity (Non-condensing): Operating: 10% to 90%. Non-operating: 5% to 95%, packaged. • Maximum wet bulb humidity: Operating: 80.6°F (27°C). Non-operating: Non-condensing. • Air flow @77°F (25°C): Operating: TBD. Non-operating: N/A. • Altitude: Operating: 0 to 2.24 miles (0 to 3.6 kilometers). Non-operating: 0 to 2.24 miles (0 to 3.6 kilometers). All specifications subject to change without notice.
Appendix B Troubleshooting Symptom Possible Solutions No Video • Make sure that the VGA driver enables linear addressing to the frame buffer. • Make sure that the CineView Pro series decoder board is mounted in a PCI bus master slot. (Check the motherboard documentation to determine bus master slots.) • Check if PCI BIOS has enabled the bus master enable bit within the PCI configuration space.
Index .mpg . . . . . . . . . . . . . . . . . . . . . . . . . .pcm . . . . . . . . . . . . . . . . . . . . . . . . . . .tlb File . . . . . . . . . . . . . . . . . . . . . . . . .vbs . . . . . . . . . . . . . . . . . . . . . . . . . . .vpl . . . . . . . . . . . . . . . . . . . . . . . . 44, 44 44 68 44 51 B BIOS . . . . . . . . . . . . . . . . . . . . . . . . 213 Bit Rate . . . . . . . . . . . . . . . . . . . . . . 206 Browse Button . . . . . . . . . . . . . . . . . . 51 Building Your Application . . . . .
216 CineView Pro Decoder Family 2.6 User Manual and API Guide External Connectors . . . . . . . . . . . . . 207 External Video . . . . . . . . . . . . . . . . . . 209 F Fast Forward Button . . FIFO . . . . . . . . . . . . . . File Drop-Down Menu . FPGA . . . . . . . . . . . . . Frame Advance Button Freeze Frame Button . . Frequency Response . . . . . . . . . . . . . 45 . . . . . . . . . . . . 65 . . . . . . . . . . . . 48 . . . . . . . . . . . . 66 . . . . . . . . . . . . 45 . . . . . . . . . . . . 45 .
Index 217 Blend . . . . . . . . . . . . . . . . . . . . . . . Blending Level . . . . . . . . . . . . . . . . Cancel Button . . . . . . . . . . . . . . . . Clear Background . . . . . . . . . . . . . Help Button . . . . . . . . . . . . . . . . . . Make Decoder Ready . . . . . . . . . . . Multiple Region . . . . . . . . . . . . . . . OK Button . . . . . . . . . . . . . . . . . . . Position X . . . . . . . . . . . . . . . . . . . Position Y . . . . . . . . . . . . . . . . . . . Reset Regions . . . . . . . . .
218 CineView Pro Decoder Family 2.6 User Manual and API Guide U Unbalanced Audio . . . . . . . . . . . . . . 9, 11 V VGA Controller Requirement . . . . . . . . . . . 8 Display Adjustments . . . . . . . . . . . . . 8 Display Support . . . . . . . . . . 205, 209 VGA Controller Setting . . . . . . . . . . . 213 VGA Display . . . . . . . . . . . . . . . . . . 6, 56 VGA Output Button . . . . . . . . . . . . . . . 46 VGA Output Window . . . . . . . . . . . . . . 43 VGA Settings Apply Button . . . . . . . . . .