updated documentation for display list functions

git-svn-id: svn://anubis/anaglym/trunk@218 99a6e188-d820-4881-8870-2d33a10e2619

doc/index.html

@@ -38,6 +38,14 @@ The library functions are documented below.
 <a name="ag" />
 <h2><tt>ag</tt> library</h2>
 
+<a name="ag_callList" />
+<h3>callList</h3>
+<p><tt>ag.callList(display_list)</tt><p>
+<p>
+This function invokes a display list created with
+<a href="#ag_startList"><tt>startList()</tt></a>.
+</p>
+
 <a name="ag_clearEventHandler" />
 <h3>clearEventHandler</h3>
 <p><tt>ag.clearEventHandler(event_name)</tt><p>
@@ -125,6 +133,20 @@ See <a href="#ag_setAutoDrawObjects">setAutoDrawObjects</a>
 for more information.
 </p>
 
+<a name="ag_drawPoint" />
+<h3>drawPoint</h3>
+<p><tt>ag.drawPoint(size, r, g, b, x, y [, z])</tt></p>
+<p>
+This function draws a point to the screen.
+The size of the point is given by <tt>size</tt>.
+The point will be antialiased.
+The color of the point is given by (r, g, b).
+The position of the point is given by (x, y, z).
+If not specified, <tt>z</tt> defaults to 0.
+This function can be called from either the <tt>update_event</tt>
+or the <tt>update_overlay_event</tt>.
+</p>
+
 <a name="ag_drawRect" />
 <h3>drawRect</h3>
 <p><tt>ag.drawRect(r, g, b, width, height, x, y [, rot])</tt></p>
@@ -170,6 +192,16 @@ See <a href="#ag_setAutoEndFrame">setAutoEndFrame</a> for more
 information.
 </p>
 
+<a name="ag_endList" />
+<h3>endList</h3>
+<p><tt>ag.endList()</tt></p>
+<p>
+This function ends the creation of a display list created with
+<a href="#ag_startList"><tt>startList()</tt></a>.
+Every call to <tt>startList()</tt> should have a corresponding call
+to <tt>endList()</tt>.
+</p>
+
 <a name="ag_exit" />
 <h3>exit</h3>
 <p><tt>ag.exit()</tt></p>
@@ -411,6 +443,18 @@ mode is enabled.
 See <a href="#ag_setAutoStartFrame">ag.setAutoStartFrame()</a>.
 </p>
 
+<a name="ag_startList" />
+<h3>startList</h3>
+<p><tt>displaylist = ag.startList()</tt></p>
+<p>
+This function instructs the engine to start a display list.
+Any <tt>draw*()</tt> functions called between <tt>startList()</tt>
+and <a href="#ag_endList"><tt>endList()</tt></a> will be stored in the display
+list for efficient execution.
+The display list can be called with
+<a href="#ag_callList"><tt>callList()</tt></a>.
+</p>
+
 <hr />
 
 <a name="object_creation" />