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>GXGetVtxDescv</title> 10</head> 11 12<body> 13 14<h1 align="left">GXGetVtxDescv</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXGetVtxDescv( <a href="../Structures/GXVtxDescList.html">GXVtxDescList</a>* attr_list ); 21</pre></dd></dl> 22 23<h2>Arguments</h2> 24<TABLE class="arguments" border="1" > 25 <tr> 26<TH>attr_list</TH> 27<TD>Pointer to an array of <A href="../Structures/GXVtxDescList.html"><CODE>GXVtxDescList</CODE></A> structures (a list of {<A href="../Enumerated_Types/GXAttr.html"><CODE>attr</CODE></A>, <A href="../Enumerated_Types/GXAttrType.html"><CODE>type</CODE></A>} pairs). </TD> 28 </tr> 29</TABLE> 30 31<h2>Return Values</h2> 32<p>None.</p> 33 34<H2>Description</H2> 35<P>This function allows an application to get the descriptors of multiple attributes. This function can be used to save the current vertex descriptor. The saved vertex descriptor can be made the current vertex descriptor by calling the <A href="GXSetVtxDescv.html"><CODE>GXSetVtxDescv</CODE></A> function with <SPAN class="argument">attr_list</SPAN> as a parameter.</P> 36<P>The constant <CODE>GX_MAX_VTXDESCLIST_SZ</CODE> can be used to statically allocate memory for <SPAN class="argument">attr_list</SPAN>:</P> 37<P><CODE>GXVtxDescList attr_list[GX_MAX_VTXDESCLIST_SZ];<BR> GXGetVtxDescv(attr_list);</CODE></P> 38<P>The constant <CODE>GX_MAX_VTXDESCLIST_SZ</CODE> can also be used to dynamically allocate memory for <SPAN class="argument">attr_list</SPAN>: </P> 39<P><CODE>attr_list = (GXVtxDescList*) OSAlloc(GX_MAX_VTXDESCLIST_SZ * sizeof(GXVtxDescList));<BR> GXGetVtxDescv(attr_list);</CODE></P> 40<P>The descriptors for all attributes are gotten by the <CODE>GXGetVtxDescv</CODE> function.</P> 41 42<h2>See Also</h2> 43<p class="reference"> 44<a href="../Structures/GXVtxDescList.html">GXVtxDescList</a>, 45<a href="GXClearVtxDesc.html">GXClearVtxDesc</a>, 46<a href="GXSetVtxDesc.html">GXSetVtxDesc</a> 47</p> 48 49<H2>Revision History</H2> 50<P> 512006/03/01 Initial version.<br> 52</P> 53 54<hr><p>CONFIDENTIAL</p></body> 55</HTML>