GXLoadNrmMtxImm3x3

Syntax

#include <revolution/gx.h>

void GXLoadNrmMtxImm3x3(
    const f32   mtxPtr[3][3], 
    u32         id );

Arguments

mtxPtr	Specifies a pointer to the matrix data.
id	Specifies the matrix name. Can specify a value enumerated in `GXPosNrmMtx`.

Return Values

None.

Description

This function is used to load a 3x3 normal transform matrix into matrix memory at location id from the 3x3 matrix, mtxPtr. This matrix is either made the current matrix (see the GXSetCurrentMtx function), or used to transform normals in model space to view space by setting a matrix ID for each vertex. The mtxPtr argument is a pointer to a 3x3 (row x column) matrix. The id argument enumerated in GXPosNrmMtx points to the load destination matrix location in the matrix memory.

You can also load a position coordinate matrix (the GXLoadPosMtxImm function) to the same id.

To load a normal matrix from a 3x4 matrix, use the GXLoadNrmMtxImm function.

The matrix data is copied from main memory or the CPU cache into the graphics FIFO. Accordingly, matrices loaded using this function are always coherent with the CPU cache.

Revision History

2006/03/01 Initial version.