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>C Specification</h2> 17 18<dl> 19<dd><pre><CODE>#include <revolution/gx.h></CODE></pre> 20 </dd> 21<dd><pre><CODE>void GXGetVtxDescv( <a href="../Structures/GXVtxDescList.html">GXVtxDescList</a><em>* attr_list</em> );</CODE></pre> 22 </dd> 23</dl> 24 25<h2>Arguments</h2> 26<TABLE border="1" cellpadding="3" cellspacing="0.1"> 27 <tr> 28<TD width="120" valign="top" bgcolor="#ffffe8"><em><strong><CODE>attr_list</font></strong></em></TD> 29<TD width="520">Pointer to an array of <a href="../Structures/GXVtxDescList.html"><code>GXVtxDescList</code></a> structures (a list of {<a href="../Enumerated_Types/GXAttr.html">attr</a>, <a href="../Enumerated_Types/GXAttrType.html">type</a>} pairs). </TD> 30 </tr> 31</TABLE> 32<h2>Return Values</h2> 33 34<p>None.</p> 35<H2>Description</H2> 36<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 <code><a href="GXSetVtxDescv.html">GXSetVtxDescv</a></code> with <em><strong><code>attr_list</code></strong></em> as a parameter.</P> 37<P>The constant <code>GX_MAX_VTXDESCLIST_SZ</code> can be used to statically allocate memory for <em><strong><code>attr_list</code></strong></em>:</P> 38<P><code><font size="2">GXVtxDescList attr_list[GX_MAX_VTXDESCLIST_SZ];<br> GXGetVtxDescv(attr_list);</font></code></P> 39<P>The constant<code> GX_MAX_VTXDESCLIST_SZ</code> can also be used to dynamically allocate memory for <em><strong><code>attr_list</code></strong></em>: </P> 40<P><code><font size="2">attr_list = (GXVtxDescList*) OSAlloc(GX_MAX_VTXDESCLIST_SZ * sizeof(GXVtxDescList));<br> GXGetVtxDescv(attr_list);</font></code></P> 41<P>The descriptors for all attributes are fetched by <code>GXGetVtxDescv</code>.</P> 42<h2>See Also</h2> 43 44<p><a href="../Structures/GXVtxDescList.html">GXVtxDescList</a><br> <a href="GXClearVtxDesc.html">GXClearVtxDesc</a><br> <a href="GXSetVtxDesc.html">GXSetVtxDesc</a></p> 45<H2>Revision History</H2> 46<P>03/01/2006 Initial version.</P> 47</BODY> 48</HTML>