Data types:
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 |
Emboss |
Flag that indicates weather to emboss with a bump map. Possible values are: |
Long |
Depth |
Depth of the emboss effect. Range: 1 to 100. |
Long |
Elevation |
Elevation angle. Range of values is from 0 to 180 degrees, where 0 will cause outer embossing, and 180 will cause inner embossing. |
Long |
LightAngle |
The direction of the light, in degrees. Range: 0 to 360 degrees. |
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). If this property is VARIANT_FALSE, then the reference frame should be set manually after a number of frames. Setting this property after the stream starts will have no effect. |
long |
Threshold |
Value used to control an object's detection level. A lower threshold provides stronger object detection. Range: 1 to 100. |
VAIRIANT_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 the SetReferenceFrame 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.
Return
S_OK if connected, S_FALSE otherwise.