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="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>G3_Begin</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G3*_Begin <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19  <PRE>
20<CODE>#include &lt;nitro/gx/g3imm.h&gt;
21#include &lt;nitro/gx/g3b.h&gt;
22#include &lt;nitro/gx/g3c.h&gt;</CODE><BR>
23<CODE>void G3_Begin(GXBegin primitive);</CODE>
24
25// Below are APIs for creating the display list (command list)<BR><CODE>void G3B_Begin(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, GXBegin primitive);</CODE><BR><CODE>void G3C_Begin(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, GXBegin primitive);</CODE><BR><CODE>void G3BS_Begin(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, GXBegin primitive);</CODE><BR><CODE>void G3CS_Begin(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, GXBegin primitive);</CODE></PRE>
26  </dd></dl><h2>Arguments</h2><table border="1" width="100%"><tr><td width="13%"><em><strong><font face="Courier New">info</font></strong></em></td><td width="87%">Command List Information.</td></tr><tr><td width="13%"><em><strong><font face="Courier New">primitive</font></strong></em></td><td width="87%">Primitive type</td></tr></table><h2>Return Values</h2><p>None.</p><H2>Description</H2><P>This function declares the start of the vertex list. <em><strong><code>primitive</code></strong></em> specifies the primitive type created by the vertex list.
27</P>
28<TABLE border="1">
29  <TBODY>
30    <TR>
31      <TD width="30%"><CODE>GX_BEGIN_TRIANGLES</CODE></TD>
32      <TD>Multiple triangle polygons</TD>
33    </TR>
34    <TR>
35      <TD width="30%"><CODE>GX_BEGIN_QUADS</CODE></TD>
36      <TD>Multiple quadrilateral polygons</TD>
37    </TR>
38    <TR>
39      <TD width="30%"><CODE>GX_BEGIN_TRIANGLE_STRIP</CODE></TD>
40      <TD>Triangle strip polygon</TD>
41    </TR>
42    <TR>
43      <TD width="30%"><CODE>GX_BEGIN_QUAD_STRIP</CODE></TD>
44      <TD>Quadrilateral strip polygon</TD>
45    </TR>
46  </TBODY>
47</TABLE>
48<P>The following indicates the type definition for <code>GXBegin</code> types.</P>
49<PRE><CODE>typedef enum
50{
51    GX_BEGIN_TRIANGLES = 0,
52    GX_BEGIN_QUADS = 1,
53    GX_BEGIN_TRIANGLE_STRIP = 2,
54    GX_BEGIN_QUAD_STRIP = 3
55}
56GXBegin;</CODE></PRE>
57<H2>See Also</H2>
58<P><A href="G3_End.html">G3*_End</A></P>
59<H2>Revision History</H2>
60<P>2004/01/19 Initial version.</P>
61<hr><p>CONFIDENTIAL</p></body></html>
62