Movie2 Control Reference 15.0
Events

Functions

void CVCError (long ErrorCode, BSTR ErrorString, boolean *Continue)
 This event is fired, if an error occurs in the Movie 2 Control. An error could be raised for example when trying to set a source image that is incompatible with Movie 2 or if an acquisition function returned an error. More...
 
void ImageSnapped (void)
 Generated whenever an image has been acquired internally by the CVB Movie2 control. More...
 
void ImageUpdated (void)
 Generated whenever an new image has been set for the CVB Movie2 control. More...
 
void ProvideMetaData (BSTR *DataString, LONG bufferSize)
 Generated whenever new MetaData can be passed to the current frame into the AVI container. More...
 

Detailed Description

Function Documentation

◆ CVCError()

void CVCError ( long  ErrorCode,
BSTR  ErrorString,
boolean *  Continue 
)

This event is fired, if an error occurs in the Movie 2 Control. An error could be raised for example when trying to set a source image that is incompatible with Movie 2 or if an acquisition function returned an error.

In order to make sense of the error code, please match them versus
the definitions in the CVCError.h header file.

Parameters
[in]ErrorCodeA unique number describing the error.
See the error code description in the Image Manager header CVCError.h for possible values.
[in]ErrorStringReadable description of the error.
[in,out]ContinueThe Continue variable is only there for compatibility reasons with other CVB controls and is ignored in CVB Movie.

◆ ImageSnapped()

void ImageSnapped ( void  )

Generated whenever an image has been acquired internally by the CVB Movie2 control.

It may be used to synchronize with the image acquisition and e.g. do a simultaneous display of the acquired image etc. Remember that the time your application spends inside this event further slows down the speed at which images are recorded!

◆ ImageUpdated()

void ImageUpdated ( void  )

Generated whenever an new image has been set for the CVB Movie2 control.

◆ ProvideMetaData()

void ProvideMetaData ( BSTR *  DataString,
LONG  bufferSize 
)

Generated whenever new MetaData can be passed to the current frame into the AVI container.

Meta data are (ANSI-) strings with up to 64k characters, one per image being recorded. For example, the MetaData can be used to save the corresponding timestamp as a string for every recorded frame within the AVI container.

To read out the MetaData you can implement the CVB Notify Interface (INotify) of the Driver.dll in your own application. If you prefer the Grabber OCX you can use the ImageNotificationString Event.

The use is shown in the VCMovie2PlayerExample and the CSMovie2PlayerExample that are included in the Movie2 installation.

Note
Please note that some media players or AVI Editors may get confused by the presence of a text stream in the AVI container. When an AVI Editor does not support the text stream the MetaData is lost after editing the AVI file. For Example VirtualDub with DirectStreamCopy writes only the text of the first frame to all other frames.
Our Movie Interactive 2 is the only application we know which can handle text streams as MetaData. So if you want to recompress your recorded movie and don't want to lose the MetaData we recommend to use Movie Interactive 2.
Attention
This event will only be fired if UseMetaData is set to TRUE.
Parameters
[in]DataStringMetaData to be written to the current frame.
[in]bufferSizeLength of the DataString to be written.
Examples:
Visual C++ - VC Movie2 OCX Example