Author: ArcRiley
Date: 2008-09-08 04:24:34 -0400 (Mon, 08 Sep 2008)
New Revision: 1355

Modified:
   trunk/pysoy/src/actions/Print.pym
   trunk/pysoy/src/models/Axis.pym
   trunk/pysoy/src/models/Billboard.pym
Log:
More docs work.


Modified: trunk/pysoy/src/actions/Print.pym
===================================================================
--- trunk/pysoy/src/actions/Print.pym   2008-09-03 18:03:20 UTC (rev 1354)
+++ trunk/pysoy/src/actions/Print.pym   2008-09-08 08:24:34 UTC (rev 1355)
@@ -20,7 +20,8 @@
 cdef class Print (Action) :
   '''soy.actions.Print
   
-    This L{action<soy.action.Action>} prints the specified text on performance.
+    This L{actions class<soy.actions>} prints the specified text on 
+    performance.  This is useful for debugging.
 
     Note that as of Python 3.0, this class will use the standard print 
     function which can be overridden for adjustable behavior.

Modified: trunk/pysoy/src/models/Axis.pym
===================================================================
--- trunk/pysoy/src/models/Axis.pym     2008-09-03 18:03:20 UTC (rev 1354)
+++ trunk/pysoy/src/models/Axis.pym     2008-09-08 08:24:34 UTC (rev 1355)
@@ -20,7 +20,8 @@
 cdef class Axis (Model) :
   '''soy.models.Axis
 
-    This models class renders an XYZ axis at the center of bodies.
+    This L{models class<soy.models>} renders a "XYZ axis" oriented to each 
+    body it's attached to.  This is useful for debugging.
   '''
 
 
@@ -30,6 +31,9 @@
   #
 
   cdef void _render(self, soy.bodies.Body _body) :
+    #
+    # This should be upgraded to use VBO.  Test for buffer ID here.
+    #
     gl.glPushMatrix()
     gl.glDisable(gl.GL_CULL_FACE)
     gl.glDisable(gl.GL_DEPTH_TEST)

Modified: trunk/pysoy/src/models/Billboard.pym
===================================================================
--- trunk/pysoy/src/models/Billboard.pym        2008-09-03 18:03:20 UTC (rev 
1354)
+++ trunk/pysoy/src/models/Billboard.pym        2008-09-08 08:24:34 UTC (rev 
1355)
@@ -20,11 +20,17 @@
 cdef class Billboard (Model) :
   '''soy.models.Billboard
   
-    This mesh rendering quad always facing the camera
+    This L{models class<soy.models>} renders a L{material<soy.materials>} 
+    which always faces the L{camera<soy.bodies.Camera>} viewing it.
+
+    @type  material : soy.materials.Material
+    @param material : Material to be used
+    @type  size     : tuple
+    @param size     : Initial size of the Billboard
   '''
 
 
-  def __cinit__(self, material,size=(1,1), *args, **kwargs):
+  def __cinit__(self, material, size=(1,1), *args, **kwargs):
     self._material = material
     self._size[0]  = size[0]
     self._size[1]  = size[1]

_______________________________________________
PySoy-SVN mailing list
PySoy-SVN@pysoy.org
http://www.pysoy.org/mailman/listinfo/pysoy-svn

Reply via email to