IDCompositionDevice2::CreateMatrixTransform method (dcomp.h)
Creates a 2D 3-by-2 matrix transform object.
Syntax
HRESULT CreateMatrixTransform(
[out] IDCompositionMatrixTransform **matrixTransform
);
Parameters
[out] matrixTransform
Type: IDCompositionMatrixTransform**
The new matrix transform object. This parameter must not be NULL.
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
A new matrix transform object has the identity matrix as its initial value. The identity matrix is the 3x2 matrix with ones on the main diagonal and zeros elsewhere, as shown in the following illustration.
![Three-by-two identity matrix](images/identity_3x2matrix.png)
When an identity transform is applied to an object, it does not change the position, shape, or size of the object. It is similar to the way that multiplying a number by one does not change the number. Any transform other than the identity transform will modify the position, shape, and/or size of objects.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1 [desktop apps only] |
Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
Target Platform | Windows |
Header | dcomp.h |
Library | Dcomp.lib |
DLL | Dcomp.dll |
See also
IDCompositionEffectGroup::SetTransform3D