D3DMXMatrixIdentity

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This inline function returns the identity matrix in floating point format.

Syntax

D3DMXMATRIX* D3DMXMatrixIdentity(
  D3DMXMATRIX* pOut
);

Parameters

  • pOut
    [in, out] Pointer to the D3DMXMATRIX structure that is the result of the operation.

Return Value

Pointer to a D3DMXMATRIX structure that is the identity matrix.

Remarks

The identity matrix is a matrix in which all coefficients are 0 except the [1,1][2,2][3,3][4,4] coefficients, which are set to 1. The identity matrix is special in that when it is applied to vertices, they are unchanged. The identity matrix is used as the starting point for matrices that will modify vertex values to create rotations, translations, and any other transformations that can be represented by a 4 ×4 matrix.

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DMXMatrixIdentity function can be used as a parameter for another function.

Requirements

Header d3dmx.h
Library Implemented in d3dmxmath.inl
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

D3DMX Functions
D3DMXMATRIX
D3DMXMatrixIdentityFxd