ILMVMotionEmboss Interface

Data types:

This filter has no specific data types, but includes the following enumeration for use with its programming interface:

 

REFERENCE_FRAME

enum REFERENCE_FRAME
{
   REF_USEBUFFER,
   REF_USENEXTFRAME,
   REF_USECOLOR,
}; 

 

Interface Properties:

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:
VARIANT_TRUE: emboss with a bump map
VARIANT_FALSE: do not emboss with a bump map.

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.

 

Interface Methods:

HRESULT SetReferenceFrame (BYTE *pBuffer, long lRGBColor, REFERENCE_FRAME opt)

Parameters

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.

Description

Sets the reference frame of the movie.

Return

S_OK if connected, S_FALSE otherwise.