This filter has no specific data types, but includes the following enumeration for use with its programming interface:
enum REFERENCE_FRAME
{
REF_USEBUFFER,
REF_USENEXTFRAME,
REF_USECOLOR,
};
Type |
Name |
Description |
VARIANT_BOOL |
Enabled |
Enables or disables the effect. If set to VARIANT_FALSE, the filter will pass the video samples intact. |
VARIANT_BOOL |
FirstFrameIsReference |
Enables or disables setting the first frame in every play session as the reference frame. If this is VARIANT_TRUE, the first frame in every play session will be set as the reference frame (Usually the first frame in a movie). |
long |
Threshold |
Value used to control an object's detection level. A lower threshold provides stronger object detection. Range : 1 to 100. |
VARIANT_BOOL |
NoReferenceFrame |
Flag that controls the reference frame. If this property is VARIANT_TRUE, the reference frame is assumed to be a black buffer. If it is VARIANT_FALSE, the reference frame will be the frame set by the user through theSetReferenceFrame method or by setting the FirstFrameAsReference property. |
pBuffer | buffer contains the reference frame. This buffer should have the same dimensions (width and height), and the same bits per pixel as the movie. | |
lRGBColor | pixel color (RGB 24-bit). The reference frame will be set as a solid frame with the color specified in this parameter. | |
opt: | flag that controls the reference frame. Possible values are: | |
Value | Meaning | |
REF_USEBUFFER | only the pBuffer member is used. | |
REF_USENEXTFRAME | the next frame in the movie is taken as the reference frame. | |
REF_USECOLOR | the lRGBColor parameter is used. |
Sets the reference frame of the movie.
S_OK if connected, S_FALSE otherwise.