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>GXGetVtxAttrFmtv</title> 10</head> 11 12<body> 13 14<h1 align="left">GXGetVtxAttrFmtv</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXGetVtxAttrFmtv( 21 <a href="../Enumerated_Types/GXVtxFmt.html">GXVtxFmt</a> vtxfmt, 22 <a href="../Structures/GXVtxAttrFmtList.html">GXVtxAttrFmtList</a>* list ); 23</pre></dd></dl> 24 25<h2>Arguments</h2> 26<TABLE class="arguments" border="1" > 27 <tr> 28<TH>vtxfmt</TH> 29<TD>Specifies the vertex format <A href="../Enumerated_Types/GXVtxFmt.html">number</A>.</TD> 30 </tr> 31 <tr> 32<TH>list</TH> 33<TD>Specifies a pointer to a <A href="../Structures/GXVtxAttrFmtList.html"><CODE>GXVtxAttrFmtList</CODE></A> structure array (a list of {<A href="../Enumerated_Types/GXAttr.html"><CODE>attr</CODE></A>, <A href="../Enumerated_Types/GXCompCnt.html"><CODE>cnt</CODE></A>, <A href="../Enumerated_Types/GXCompType.html"><CODE>type</CODE></A>, and <CODE>frac</CODE>}). </TD> 34 </tr> 35</TABLE> 36 37<h2>Return Values</h2> 38<p>None.</p> 39 40<H2>Description</H2> 41<P>This function gets multiple <em>attribute formats</em> within a single vertex format. This is useful when you need to get all the attributes in a vertex format at once (for example, to push/pop the vertex format).</P> 42<P>Be sure to use <CODE>GX_MAX_VTXATTRFMTLIST_SZ</CODE> to allocate the buffer specified in <SPAN class="argument">list</SPAN>.</P> 43<P><CODE>GXVtxAttrFmtList list[GX_MAX_VTXATTRFMTLIST_SZ];<BR> GXGetVtxAttrFmtv( GX_VTXFMT3, list);</CODE></P> 44<P>or</P> 45<P><CODE>GXVtxAttrFmtList* list = OSAlloc(GX_MAX_VTXATTRFMTLIST_SZ * sizeof(GXVtxAttrFmtList));<BR> GXGetVtxAttrFmtv( GX_VTXFMT3, list);</CODE></P> 46<P>This function gets all attributes of the vertex format.</P> 47<P>You can set the current vertex format using the <A href="GXSetVtxAttrFmtv.html"><CODE>GXSetVtxAttrFmtv</CODE></A> function.</P> 48 49<h2>See Also</h2> 50<p class="reference"> 51<a href="GXSetVtxAttrFmt.html">GXSetVtxAttrFmt</a> 52</p> 53 54<H2>Revision History</H2> 55<P> 562006/03/01 Initial version.<br> 57</P> 58 59<hr><p>CONFIDENTIAL</p></body> 60</HTML>