1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>GXLoadNrmMtxImm3x3</title> 10</head> 11 12<body> 13 14<h1 align="left">GXLoadNrmMtxImm3x3</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXLoadNrmMtxImm3x3( 21 const f32 mtxPtr[3][3], 22 u32 <A href="../Enumerated_Types/GXPosNrmMtx.html">id</A> ); 23</pre></dd></dl> 24 25<h2>Arguments</h2> 26<TABLE class="arguments" border="1" > 27 <tr> 28<TH>mtxPtr</TH> 29<TD>Specifies a pointer to the matrix data.</TD> 30 </tr> 31 <tr> 32<TH>id</TH> 33<TD>Specifies the matrix name. Can specify a value enumerated in <CODE><A href="../Enumerated_Types/GXPosNrmMtx.html">GXPosNrmMtx</CODE></A>.</TD> 34 </tr> 35</TABLE> 36 37<h2>Return Values</h2> 38<p>None.</p> 39 40<H2>Description</H2> 41<P>This function is used to load a 3x3 normal transform matrix into matrix memory at location <SPAN class="argument">id</SPAN> from the 3x3 matrix, <SPAN class="argument">mtxPtr</SPAN>. This matrix is either made the current matrix (see the <A href="GXSetCurrentMtx.html"><CODE>GXSetCurrentMtx</CODE></A> function), or used to transform normals in model space to view space by setting a matrix ID for each vertex. The <SPAN class="argument">mtxPtr</SPAN> argument is a pointer to a 3x3 (row x column) matrix. The <SPAN class="argument">id</SPAN> argument enumerated in <A href="../Enumerated_Types/GXPosNrmMtx.html"><CODE>GXPosNrmMtx</CODE></A> points to the load destination matrix location in the matrix memory.</P> 42<P>You can also load a position coordinate matrix (the <A href="GXLoadPosMtxImm.html"><CODE>GXLoadPosMtxImm</CODE></A> function) to the same <SPAN class="argument">id</SPAN>.</P> 43<P>To load a normal matrix from a 3x4 matrix, use the <A href="GXLoadNrmMtxImm.html"><CODE>GXLoadNrmMtxImm</CODE></A> function.</P> 44<P>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.</P> 45 46<h2>See Also</h2> 47<p class="reference"> 48<a href="GXSetCurrentMtx.html">GXSetCurrentMtx</a>, 49<a href="GXLoadPosMtxImm.html">GXLoadPosMtxImm</a> 50</p> 51 52<H2>Revision History</H2> 53<P> 542006/03/01 Initial version.<br> 55</P> 56 57<hr><p>CONFIDENTIAL</p></body> 58</HTML>