Vela CineView HD Pro User's Guide

Document Part Number 9050-2100LRWAPI Developer’s GuideVersion 2.6.5Vela® PRISM MPEG-2 TranscoderApplication Programming Interface Documentation for th

4 Vela Prism Release 2.6.5 API Developer’s GuideIncluded FilesComponent SummaryThe goal of this API set is to give you, the developer, a binary-indepe

Chapter 1 — Getting Started 5Vela Prism SDK InstallationVela Prism SDK InstallationNote that if any previous version of Vela Prism software is install

6 Vela Prism Release 2.6.5 API Developer’s GuideSuggested ReadingATL/COM ReferencesInside COM, Rogerson; Microsoft Press. Recommended for COM introduc

Chapter 1 — Getting Started 7Customer SupportCustomer SupportIn the event of questions or problems with Vela Application Programming Interface methods

Component OverviewChapter 2Using the Filter Manager APIComponent OverviewThe key element of the Vela CineView Pro Prism API is the Filter Manager COM

10 Vela Prism Release 2.6.5 API Developer’s GuideSystem Configuration Settingsthat the method performs as well as a list of the possible return values

Chapter 2 — Using the Filter Manager API 11Transcode Parameters: The Windows RegistryOne useful feature of the Registry method of storing transcoding

12 Vela Prism Release 2.6.5 API Developer’s GuideTranscode Parameters: The Windows RegistryChanging Individual Registry SettingsThe production release

Chapter 2 — Using the Filter Manager API 13Filter Manager Interface PropertiesRegistry-Access Methods Exposed Through Filter ManagerThe Filter Manager

Copyright 2003 Vela Research LP. All rights reserved.This manual is written and published by Vela Research LP (Vela). All rightsreserved. Vela reserve

14 Vela Prism Release 2.6.5 API Developer’s GuideBasic Filter Manager MethodsFor example, if a property is listed as PropertyX( long ), then assume th

Chapter 2 — Using the Filter Manager API 15Basic Filter Manager Methodslong Initialize() – Sets up the transcoder application, creating an instance of

16 Vela Prism Release 2.6.5 API Developer’s GuideEventslong End() – This is an alternate and preferred method of stopping the transcode. It performs a

Chapter 2 — Using the Filter Manager API 17EventsHRESULT FinishedEvent(long code, BSTR message) is issued to inform the client that the transcode is c

OverviewChapter 3The Sample ApplicationOverviewDevelopers using these components should be familiar with Microsoft Visual C++™ 6.0. Microsoft provides

20 Vela Prism Release 2.6.5 API Developer’s GuideTranscodeClientCreating the ProjectWhen you are creating a Microsoft Foundation Class (MFC) Applicati

Chapter 3 — The Sample Application 21TranscodeClientUsing the #import Directive This section describes the steps required to create a COM object using

22 Vela Prism Release 2.6.5 API Developer’s GuideTranscodeClientOnce an instance of IArgusFMPtr has been created, it can be used to access the propert

Chapter 3 — The Sample Application 23TranscodeClientm_pFilterManagerEvents->EasyAdvise(m_pIFilterMgr);/////////////////////////////////////////////

Table of ContentsTable of ContentsList of Figures and Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vChapter 1G

24 Vela Prism Release 2.6.5 API Developer’s GuideTranscodeClientlong errorCode;// Reset all transcoder components, Check Results.errorCode = m_pIFilte

Chapter 3 — The Sample Application 25TranscodeClientreturn a long result which is typically set to 0, if successful, or a negative value on error. For

26 Vela Prism Release 2.6.5 API Developer’s GuideTranscodeClient2. In the class definition, insert a SINK_MAP that includes each of the events from Fi

Chapter 3 — The Sample Application 27TranscodeClienthr = DispEventAdvise(pUnk, &m_iid);return hr; }4. Within the CFilterManagerEvents class, de

28 Vela Prism Release 2.6.5 API Developer’s GuideTranscodeClientSTDMETHODIMP CFilterManagerEvents::OnLog(long code, BSTR error){CString strMessage = _

Chapter 3 — The Sample Application 29TranscodeClientRunning the Sample ApplicationThe TranscodeClient (CVProPrism) sample C++ application, portions of

30 Vela Prism Release 2.6.5 API Developer’s GuideWindows Registry OverviewWindows Registry Overview As discussed in Chapter 2, most of the properties

Chapter 3 — The Sample Application 31Windows Registry OverviewExample: Loading a Transcoder Registry TableAs an example of using the CRegistry class t

32 Vela Prism Release 2.6.5 API Developer’s GuideWindows Registry OverviewCRegistry Settings ;CRegistry DualEnc ;if( m_lHorizRes == 176 ) // QSIF{m_lV

Chapter 3 — The Sample Application 33CVProPrism Typical Screen ShotsCVProPrism Typical Screen Shots When you double-click on CVProPrism.exe, tabbed wi

ii Vela Prism Release 2.6.5 API Developer’s GuideTable of ContentsCreating the Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34 Vela Prism Release 2.6.5 API Developer’s GuideCVProPrism Typical Screen ShotsFigure 3-2. Registry Control Panel — A/V InfoFigure 3-3. Registry Cont

Chapter 3 — The Sample Application 35CVProPrism Typical Screen ShotsFigure 3-4. Registry Control Panel — RealFigure 3-5. Registry Control Panel — WMF

OverviewChapter 4 Distributing ComponentsOverviewBuilding an installation disk is very important. This is the first view a user will have of your soft

38 Vela Prism Release 2.6.5 API Developer’s GuideMicrosoft Redistributable Codesection into an individual .INI. Using a utility such as Regini will he

Chapter 4 — Distributing Components 39Microcode Directory StructureMicrocode Directory StructureThe CineView Pro decoder also has microcode requiremen

40 Vela Prism Release 2.6.5 API Developer’s GuideTranscoding FilesCineView Pro Prism COM components located in: C:\Program Files\Vela Research\Common\

Chapter 4 — Distributing Components 41Component RegistrationRealNetworks COM components located in: C:\WINNT\system32:• pncrt.dll• pngu3266.dll• rmbe3

Appendix ATranscode Registry Settings OverviewAll of the Registry settings used to configure an individual transcode on the Vela CineView Pro Prism ar

List of Figures and TablesList of Figures and TablesChapter 1Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

44 Vela Prism Release 2.6.5 API Developer’s GuideSecond Audio Channel in Secondary Stream (CineViewPro XL)Refer to “Changing Individual Registry Setti

Appendix A — Transcode Registry Settings 45The DualEnc Registry TableThe DualEnc Registry TableWhen performing a transcode, you'll need to set up

46 Vela Prism Release 2.6.5 API Developer’s GuideThe DualEnc Registry TableIf you assign a value of 1 to the Ligos Flag, the Real Flag, or the Windows

Appendix A — Transcode Registry Settings 47The Ligos Mux Registry TableThe Ligos Mux Registry Table The Filter Manager automatically sets all of the L

48 Vela Prism Release 2.6.5 API Developer’s GuideSetting the Registry for Ligos® TranscodingSetting the Registry for Ligos® TranscodingIf you want you

Appendix A — Transcode Registry Settings 49Setting the Registry for RealNetworks® TranscodingSetting the Registry for RealNetworks® TranscodingIf you

50 Vela Prism Release 2.6.5 API Developer’s GuideSetting the Registry for RealNetworks® TranscodingStream Data Flag ServerEnabled Int TRUE (1) if the

Appendix A — Transcode Registry Settings 51Setting the Registry for RealNetworks® TranscodingConnect28K Bool On (1) or Off (0) The audience deter-mine

52 Vela Prism Release 2.6.5 API Developer’s GuideSetting the Registry for Windows Media™ TranscodingSetting the Registry for Windows Media™ Transcodin

Appendix A — Transcode Registry Settings 53Setting the Registry for Windows Media™ TranscodingFrames per SecondFrameRate Int /REG_DWORD10 to 30 30 mos

54 Vela Prism Release 2.6.5 API Developer’s GuideSetting the Registry for Windows Media™ TranscodingServer Enabled ServerEnabled long / REG_DWORDEnabl

Appendix A — Transcode Registry Settings 55Setting the Registry for Windows Media™ TranscodingTable of Audio Codec format String ValuesThe following s

56 Vela Prism Release 2.6.5 API Developer’s GuideSetting the Registry for Windows Media™ Transcoding“96 kbps, 44 kHz, stereo (A/V) CBR”“80 kbps, 44 kH

Filter Manager Error/Status CodesAppendix BFilter Manager Error/Status CodesThe following return codes may be returned by calls to Filter Manager meth

58 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-16 Storage component for elementary audio or video stream failed to

Appendix B — Filter Manager Error/Status Codes 59Filter Manager Error/Status Codes-33, -34 Error resetting or starting audio storage component. Summar

60 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-47 Unable to read preroll from tape deck. Check COM port connec-ti

Appendix B — Filter Manager Error/Status Codes 61Filter Manager Error/Status Codes-54 Attempted to Pause the video component while it was already paus

62 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-73 Attempted to cue or Start an audio component that is currently e

Appendix B — Filter Manager Error/Status Codes 63Filter Manager Error/Status Codes-81 Audio process failed because of a driver initializa-tion error,

Introduction to the Vela Prism APIChapter 1Getting StartedIntroduction to the Vela Prism APIThis Application Programming Interface (API) for the Vela

64 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-119 Error initializing the input pin of the storage component.-121

Appendix B — Filter Manager Error/Status Codes 65Filter Manager Error/Status Codes-183 Error creating audio elementary storage object. Ascertain that

66 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-238 Attempted to stop the plug-in component when it was not playing

Appendix B — Filter Manager Error/Status Codes 67Filter Manager Error/Status Codes-253 An attempt was made to read or to write too large a block of da

68 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-335 The PlayFromPin call to the CVPro Server failed. The decoder fa

Appendix B — Filter Manager Error/Status Codes 69Filter Manager Error/Status Codes-347 Mux component failed to open the mux writer stream.-348 An GOP

70 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-414 Attempted to set Ligos sample rate to 32,000, which is not supp

Appendix B — Filter Manager Error/Status Codes 71Filter Manager Error/Status Codes-429 Invalid Ligos audio bitrate set in Registry. Must be 64000, 960

72 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-438 A filename was not supplied in the Ligos Registry. Check the Li

Appendix B — Filter Manager Error/Status Codes 73Filter Manager Error/Status Codes-448 Argus Registry failure. Unable to open the HKEY_CURRENT_USER p

2 Vela Prism Release 2.6.5 API Developer’s GuideMinimum System RequirementsCPU usage of any one of the low-bitrate transcodes by decreasing its horizo

74 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-462 Invalid video format. Must be NTSC (0) or PAL (1).Check IBM Vid

Appendix B — Filter Manager Error/Status Codes 75Filter Manager Error/Status Codes-473 Invalid Intra-table flag. Check IBM Video Registry table (see A

76 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-485 Invalid audio stream id for main encode. Must be a value of 0 t

Appendix B — Filter Manager Error/Status Codes 77Filter Manager Error/Status Codes-495 Invalid SourceEnabled setting. Must be 0 to turn OFF VTR Contro

78 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-504 Invalid setting of mux-file-enabled flag (which determines if a

Appendix B — Filter Manager Error/Status Codes 79Filter Manager Error/Status Codes-514 IBM-Audio database error when using EDL Editor. Could be an ODB

80 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-528 An attempt was made to reset the WMF compo-nent when it was not

Appendix B — Filter Manager Error/Status Codes 81Filter Manager Error/Status Codes-549 There was an error setting up the Audio Input profile. The sett

82 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-584 Error Creating Main WMF Processing thread.-585 A filename was n

Appendix B — Filter Manager Error/Status Codes 83Filter Manager Error/Status Codes-611 Unable to create mutexes for video component. System error? Che

Chapter 1 — Getting Started 3Included FilesIncluded FilesThe following table is a list of all files to be installed with the CineView Pro Prism and wi

84 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-628 Unable to create FTP COM object. Make certain that the RemoteSt

Appendix B — Filter Manager Error/Status Codes 85Filter Manager Error/Status Codes-714 Error opening the Real or codec Registry. Use RegEdit and/or CV

86 Vela Prism Release 2.6.5 API Developer’s GuideFilter Manager Error/Status Codes-726 A filename was not supplied in the Real Registry. Check the Rea

IndexIndexAActiveX™ . . . . . . . . . . . . . . . . . . . 20, 38Allowable State Transitions . . . . . . . . . 14API . . . . . . . . . . . . . . .

88 Vela Prism Release 2.6.5 API Developer’s GuideIndexRReal® . . . . . . . . . . . . . 11, 41, 45, 46, 49RealNetworks . . . . . . . . . . . . . . .