Microsoft DirectX 8.1 (Visual Basic)

D3DXMatrixIdentity

Creates an identity matrix.

D3DXMatrixIdentity( _ 
    MOut As D3DMATRIX)

Parameters

MOut
D3DMATRIX type that is the result of the operation, the identity matrix.

Error Codes

If the function fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

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.

See Also

D3DXMatrixIsIdentity