IDCompositionDevice::CreateMatrixTransform3D method

Creates a 3D 4-by-4 matrix transform object.

Syntax


HRESULT CreateMatrixTransform3D(
  [out]  IDCompositionMatrixTransform3D **matrixTransform3D
);

Parameters

matrixTransform3D [out]

Type: IDCompositionMatrixTransform3D**

The new 3D 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

The new 3D matrix transform has the identity matrix as its value. The identity matrix is the 4-by-4 matrix with ones on the main diagonal and zeros elsewhere, as shown in the following illustration.

Four-by-four identity matrix

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Dcomp.h

Library

Dcomp.lib

DLL

Dcomp.dll

See also

IDCompositionDevice
DCompositionEffectGroup::SetTransform3D

 

 

Community Additions

ADD
Show:
© 2014 Microsoft