COM Objects > VideoPlayer object > Methods > VideoPlayer.ImageAdjustEnable method

Remarks

Enables/disables image adjustment of video frames.

For further details about the use of the embedded video player see the VideoPlayer object section.

For details about video clips rendering refer to the How to play video files through DirectShow tutorial.

Syntax

[Visual Basic]

control.VideoPlayer.ImageAdjustEnable (

nPlayer as Integer,

bEnable as enumBoolean

) as enumErrorCodes

[C++]

short control.VideoPlayer.ImageAdjustEnable (

short nPlayer,

short bEnable

);

Parameter

Description

nPlayer

Number representing the zero-based index of the player that will use the video player.

bEnable

Boolean value that determines if the custom transform filter for video adjustment must be inserted when building the filter graph.

Supported values are the following:

Mnemonic constant

Value

Meaning

BOOL_FALSE (default)

Disable image adjustment

BOOL_TRUE

Enable image adjustment. In this situation a custom transform filter is inserted inside the filter graph in order to allow processing of video frames: this setting becomes effective only when a new video clip is loaded.

IMPORTANT: The transform filter can be inserted inside the video stream, downstream to the decoder, only if the decoder supports the YUY2 color space. If the YUY2 color space should not be supported, the filter graph would be in any case built without the transform filter. After loading the video clip, you can verify the availability of the transform filter through the VideoPlayer.VideoTransformIsAvailable method.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to get the error code
enumErrorCodes.ERR_NOERROR (0)	The method call was successful