Share via

IWMColorConvProps::SetFullCroppingParam

  • Article
banner art

Sets the source and destination rectangles.

Syntax

HRESULT SetFullCroppingParam(LONGlSrcCropLeft,LONGlSrcCropTop,LONGlDstCropLeft,LONGlDstCropTop,LONGlCropWidth,LONGlCropHeight);

Parameters

lSrcCropLeft

[in]  Specifies the left edge of the source rectangle, in pixels.

lSrcCropTop

[in]  Specifies the top edge of the source rectangle, in pixels.

lDstCropLeft

[in]  Specifies the left edge of the destination rectangle, in pixels.

lDstCropTop

[in]  Specifies the top edge of the destination rectangle, in pixels.

lCropWidth

[in]  Specifies the width of the source and destination rectangles, in pixels.

lCropHeight

[in]  Specifies the height of the source and destination rectangles, in pixels.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

By default, the color converter copies the entire video frame. When you call this method, the color converter crops the video to the source rectangle and copies that portion to the destination rectangle.

This method is equivalent to setting the following properties:

Requirements

Client: Requires Windows Vista or Windows XP.

Header: Include wmcodecdsp.h.

See Also