1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<TITLE>GXLoadPosMtxImm</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXLoadPosMtxImm</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/gx.h&gt;
16
17void GXLoadPosMtxImm(
18    const f32   mtxPtr[3][4],
19    u32         <A href="../Enumerated_Types/GXPosNrmMtx.html">id</A> );
20</pre></dd></dl>
21
22<H2>Arguments</H2>
23<TABLE class="arguments" border="1" >
24  <TBODY>
25    <TR>
26<TH>mtxPtr</TH>
27<TD>Specifies a pointer to the matrix data.</TD>
28    </TR>
29    <TR>
30<TH>id</TH>
31<TD>Specifies the matrix name. Can specify a value enumerated by <CODE><A href="../Enumerated_Types/GXPosNrmMtx.html">GXPosNrmMtx</CODE></A>.</TD>
32    </TR>
33  </TBODY>
34</TABLE>
35
36<H2>Return Values</H2>
37<P>None.</P>
38
39<H2>Description</H2>
40<P>This function is used to load a 3x4 modelview matrix <SPAN class="argument">mtxPtr</SPAN> into matrix memory at location <SPAN class="argument">id</SPAN>. This matrix is either made the current matrix (see the <A href="GXSetCurrentMtx.html"><CODE>GXSetCurrentMtx</CODE></A> function), or used for converting vertex coordinates in model space to view space by setting a matrix ID for each vertex. <SPAN class="argument">id</SPAN> indicates a location in the matrix memory, enumerated by <A href="../Enumerated_Types/GXPosNrmMtx.html"><CODE>GXPosNrmMtx</CODE></A>.</P>
41<P>You can also load a normal matrix (the <A href="GXLoadNrmMtxImm.html"><CODE>GXLoadNrmMtxImm</CODE></A> or <A href="GXLoadNrmMtxIndx3x3.html"><CODE>GXLoadNrmMtxIndx3x3</CODE></A> function) to the same <SPAN class="argument">id</SPAN>. Generally, the normal matrix will be the inverse transpose of the vertex coordinate matrix. The normal matrix is used for <a href="../../gx/list.html#Lighting">vertex lighting</a>.&nbsp;In cases where the modelview and inverse transpose of the modelview matrix (excluding translation) are the same, you can load the same matrix for both the normal and the vertex coordinate matrices.</P>
42<P>The matrix data is copied either from main memory or from the CPU cache into the graphics FIFO. Accordingly, matrices loaded using this function are always coherent with the CPU cache.</P>
43
44<H2>See Also</H2>
45<P class="reference">
46<A href="GXSetCurrentMtx.html">GXSetCurrentMtx</A>,
47<A href="GXLoadNrmMtxImm.html">GXLoadNrmMtxImm</A>
48</P>
49
50<H2>Revision History</H2>
51<P>
522006/03/01 Initial version.<br>
53</P>
54
55<hr><p>CONFIDENTIAL</p></body>
56</HTML>