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 http-equiv="Content-Style-Type" content="text/css">
6<META name="GENERATOR" content="Microsoft FrontPage 5.0">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<TITLE>GDLObj</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GDLObj</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15<PRE>typedef struct _GDLObj {
16u8  *start;
17u32  length;
18u8  *ptr;
19u8  *top;
20} GDLObj;</PRE>
21</DL>
22<H2>Description</H2>
23<P>This structure contains information related to a graphics display list. This structure should be initialized with the <a href="GDInitGDLObj.html"><CODE>GDInitGDLObj</CODE></a> function.</P>
24<P>The <STRONG><EM><CODE>start</CODE></EM></STRONG> field indicates the location of the buffer that stores the actual display list commands. It must be 32-byte aligned.</P>
25<P>The <STRONG><EM><code>length</code></EM></STRONG> field indicates the size of the buffer. It must be a multiple of 32.</P>
26<P>The <STRONG><EM><code>ptr</code></EM></STRONG> field indicates the current location pointer for this <CODE>GDLObj</CODE>. The pointer should always point between <STRONG><EM><code>start</code></EM></STRONG> and <STRONG><EM><code>top</code></EM></STRONG>.</P>
27<P><STRONG><EM><code>top</code></EM></STRONG> should always be set to (<STRONG><EM><code>start</code></EM></STRONG> + <STRONG><EM><code>length</code></EM></STRONG>). This structure is used to check overflow.</P>
28<H2>Functions That Use This Structure</H2>
29<P><CODE><a href="GDInitGDLObj.html">GDInitGDLObj</a><br> <a href="GDGetGDLObjStart.html">GDGetGDLObjStart</a><br> <a href="GDGetGDLObjLength.html">GDGetGDLObjLength</a><br> <a href="GDGetGDLObjPointer.html">GDGetGDLObjPointer</a><br> <a href="GDGetGDLObjOffset.html">GDGetGDLObjOffset</a><br> <a href="GDSetCurrent.html">GDSetCurrent</a><br> <a href="GDGetCurrent.html">GDGetCurrent</a><br> <a href="GDIsCurrent.html">GDIsCurrent</a></CODE></P>
30<P>(All of the <a href="gdgx.html">GD graphics commands</a> implicitly use the current <CODE>GDLObj</CODE>.)</P>
31<H2>Revision History</H2>
32</code>
33<P>03/01/2006 Initial version.</p>
34</BODY>
35</HTML>