This filter has no specific data types, but includes the following enumerations for use with its programming interface:
Specifies the direction of the flames.
enum DIRECTION
{
DIR_NORTH = 1,
DIR_SOUTH = 2,
DIR_EAST = 4,
DIR_WEST = 8,
DIR_NORTHEAST = 16,
DIR_NORTHWEST = 32,
DIR_SOUTHEAST = 64,
DIR_SOUTHWEST = 128,
DIR_GLOW = 256
};
Flames to the North.
Flames to the South.
Flames to the East.
Flames to the West.
Flames to the North-East.
Flames to the North-West.
Flames to the South-East.
Flames to the South-West.
Flames all around the object, giving a glowing effect.
Values may be combined using OR.
Specifies the reference frame.
enum REFERENCE_FRAME
{
REF_USEBUFFER,
REF_USENEXTFRAME,
REF_USECOLOR,
};
Only the pBuffer member is used.
The next frame in the movie is taken as the reference frame.
The lRGBColor parameter is used.
Type | Name | Description |
---|---|---|
VARIANT_BOOL | Enabled | Enables or disables the effect. If set to VARIANT_FALSE, the filter will pass the video samples intact. |
DIRECTION | Direction | Value that indicates the direction of the flames. |
long | Decay | Controls the spread and height of the flames. A lower decay value will result in a greater spread of fire and higher flames. Range: 1 to 100. |
long | ColorsOffset | Changes the colors used in generating the fire flames to another set of colors. Range: 0 to 1000. |
long | GradientLevel | A percentage value that controls the colors graduation. For example 0 will result in a very small number of colors used to draw the flame. Higher values result in more colors used to draw the flames' gradient color. Range: 0 to 100. |
VARIANT_BOOL | Fire | Enables or disables covering the entire object with flames. If this is VARIANT_TRUE, the entire object will be covered in flames and the Burn property will be turned off automatically (false). |
VARIANT_BOOL | Burn | Enables or disables having only parts of the object on fire. If this is VARIANT_TRUE, only parts of the object will be covered in flames the Fire property will be turned off automatically (false). |
VARIANT_BOOL | ShowBackground | Enables or disables showing the background of a moving object. Possible values are: |
• VARIANT_TRUE - the background of the moving object will be displayed. | ||
• VARIANT_FALSE - a black background is displayed. | ||
VARIANT_BOOL | FirstFrameIsReference | Enables or disables setting the first frame in every play session as the reference frame. Possible values are: |
• VARIANT_TRUE - the first frame in every play session will be set as the reference frame (Usually the first frame in a movie). | ||
• VARIANT_FALSE - 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. |
VARIANT_BOOL | NoReferenceFrame | Flag that controls the reference frame. Possible values are: |
• VARIANT_TRUE - the reference frame is assumed to be a black buffer. | ||
• VARIANT_FALSE - the reference frame will be the frame set by the user through the SetReferenceFrame method or by setting the FirstFrameAsReference property. |
Sets the reference frame of the movie.
Buffer contains the reference frame. This buffer should have the same dimensions (width and height), and the same bits per pixel as the movie.
Pixel color (RGB 24-bit). The reference frame will be set as a solid frame with the color specified in this parameter.
Flag that controls the reference frame.
Return | Description |
---|---|
S_OK | Connected. |
S_FALSE | Otherwise. |