![background image](http://html1.mh-extra.com/html/vela/argus-2000-1500/argus-2000-1500_developers-manual_3878168034.webp)
26
Argus Encoder Family Version 2.6 API Developer’s Guide
Basic Filter Manager Methods
long Initialize() –
Sets up the encoder application, creating an instance of each
required COM object, initializing all of the drivers, and resetting the boards.
The
Initialize()
method should be called only once during the life of a single
application.
Initialize()
returns 0 if successful. Otherwise, it returns one of the
error codes listed in Appendix C, “Filter Manager Error/Status Codes.”
long Cue() –
Should be called
after
a call to
Load()
, which loads Registry
settings.
Cue()
sets up each component for an encode, based on the Registry
settings that apply. For example, the cue call causes the tape deck to roll the
tape to the requested pre-roll, communicates all of the requested encode set-
tings to the audio and video encoders, and opens requested output files. The
Cue()
method returns 0 if it is successful. Otherwise, it returns one of the error
codes listed in Appendix C, “Filter Manager Error/Status Codes.” Note that if
the previous attempt to encode resulted in an error, you should call the
Filter
Manager Reset()
method before calling the Load/Cue combination.
long Start() –
Actually starts the encode. If VTR-control is enabled, the tape
deck will begin to roll, triggering the audio and video encoders to begin encod-
ing when the requested mark-in appears on the tape. Otherwise, the
Start()
method starts the encode immediately, leaving control of the source material to
the calling application. Returns 0 if successful, or one of the error codes listed
in Appendix C if not.
long Stop() –
Stops the encode. One of three methods of stopping an encode:
1. Prior to the start of each encode, an encode duration is set (as well, option-
ally, as a mark-in and a mark-out). If neither
Stop()
nor
End()
is called, the
pre-set duration parameter controls the automatic termination of the encode.
2. Calling the
Stop()
method causes the encode to stop immediately; it is
actually a call to abort the encoding process.
Paused
Resume()
Resumed
Initialized
Resumed
Pause()
Paused
Initialized
End() or Stop()
Initialized
Initialized
Allowable State Transitions (Continued)
Current State
Allowed Commands
Resulting State
Success
Failure
Table 2-2. Argus Allowable State Transitions (Continued)