IDCompositionVisual3::SetTransform(constD2D_MATRIX_4X4_F&) method (dcomp.h)

Article
02/22/2024

Sets the Transform property of this visual to the specified 4-by-4 transform matrix.

Syntax

HRESULT SetTransform(
  [in, ref] const D2D_MATRIX_4X4_F & matrix
);

Parameters

[in, ref] matrix

Type: const D2D_MATRIX_4X4_F

The 4-by-4 transform matrix that is used to modify the coordinate system of this visual.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See DirectComposition Error Codes for a list of error codes.

Remarks

Setting the Transform property transforms the coordinate system of the entire visual subtree that is rooted at this visual. If the Clip property of this visual is specified, the clip rectangle is also transformed.

If the Transform property previously specified a transform object, the newly specified transform matrix replaces the transform object.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	dcomp.h
Library	Dcomp.lib
DLL	Dcomp.dll