0.4.0 documentation;

Author: bjornbytes

docs/Buffer:draw.md

@@ -5,13 +5,34 @@ category: reference
 Buffer:draw
 ===
 
-Draws the contents of the buffer.
+Draws the contents of the Buffer.
 
-    buffer:draw()
+    buffer:draw(x, y, z, scale, angle, ax, ay, az)
 
 ### Arguments
 
-None
+- `number x (0)` The x coordinate to translate the vertices by.
+- `number y (0)` The y coordinate to translate the vertices by.
+- `number z (0)` The z coordinate to translate the vertices by.
+- `number scale (1)` The amount to scale the vertex positions by.
+- `number angle (0)` The number of radians to rotate the vertices around their axis of rotation.
+- `number ax (0)` The x component of the axis of rotation.
+- `number ay (1)` The y component of the axis of rotation.
+- `number az (0)` The z component of the axis of rotation.
+
+### Returns
+
+Nothing
+
+---
+
+Draws the contents of the Buffer.
+
+    buffer:draw(transform)
+
+### Arguments
+
+- `Transform transform` The Transform to apply to the vertices.
 
 ### Returns
 

docs/Buffer:getVertexFormat.md

@@ -0,0 +1,20 @@
+<!--
+category: reference
+-->
+
+Buffer:getVertexFormat
+===
+
+Get the format table of the Buffer's vertices.
+
+    format = buffer:getVertexFormat()
+
+### Arguments
+
+None
+
+### Returns
+
+- `table format` The table of vertex attributes.  Each attribute is a table containing the name
+  of the attribute (string), the data type (string), and the number of components of the attribute
+  (number).

docs/HeadsetEye.md

@@ -0,0 +1,20 @@
+<!--
+category: reference
+-->
+
+HeadsetEye
+===
+
+Represents either the left or right eye.
+
+Values
+---
+
+- `left` The left eye.
+- `right` The right eye.
+
+See also
+---
+
+- `lovr.headset.getEyePosition`
+- `lovr.draw`

docs/Model:draw.md

@@ -23,3 +23,17 @@ Draws a model.
 ### Returns
 
 Nothing
+
+---
+
+Draws a model using a transform.
+
+    model:draw(transform)
+
+### Arguments
+
+- `Transform transform` The Transform to apply to the model.
+
+### Returns
+
+Nothing

docs/lovr.draw.md

@@ -17,3 +17,4 @@ See also
 ---
 
 - `lovr.headset.renderTo`
+- `HeadsetEye`

docs/lovr.graphics.cube.md

@@ -46,3 +46,21 @@ Draw a textured cube
 ### Returns
 
 Nothing
+
+---
+
+Draw a cube using a `Transform`.
+
+    lovr.graphics.cube(mode, transform)
+
+- `DrawMode mode` How to draw the cube.
+- `Transform transform` The Transform to apply to the cube.
+
+---
+
+Draw a textured cube using a `Transform`.
+
+    lovr.graphics.cube(texture, transform)
+
+- `Texture texture` The Texture to apply to the cube.
+- `Transform transform` The Transform to apply to the cube.

docs/lovr.graphics.md

@@ -70,6 +70,11 @@ how objects in the game world are mapped onto the screen.
   <td>Push a copy of the current coordinate transform onto the stack.</td>
 </tr>
 
+<tr>
+  <td class="pre">lovr.graphics.transform</td>
+  <td>Transform the coordinate system using a <code>Transform</code> object.</td>
+</tr>
+
 <tr>
   <td class="pre">lovr.graphics.rotate</td>
   <td>Rotate the coordinate system around an axis.</td>

docs/lovr.graphics.newModel.md

@@ -16,3 +16,18 @@ Creates a new Model from a file.  Most 3D file formats are supported.
 ### Returns
 
 - `Model model` The new Model.
+
+---
+
+Create a new Model with a Texture applied.
+
+    model = lovr.graphics.newModel(filename, texture)
+
+### Arguments
+
+- `string filename` The filename of the model.
+- `string texture` The filename of the texture to apply to the model.
+
+### Returns
+
+- `Model model` The new Model.

docs/lovr.graphics.transform.md

@@ -0,0 +1,28 @@
+<!--
+category: reference
+-->
+
+lovr.graphics.transform
+===
+
+Transform the coordinate system using a `Transform` object.  Transforms provide a convenient way
+to represent translations, rotations, and scales in a single object.  All coordinates used in
+drawing operations will be transformed by the specified Transform until the coordinate system is
+popped off the stack.
+
+Note that order matters when transforming the coordinate system.
+
+    lovr.graphics.transform(transform)
+
+### Arguments
+
+- `Transform transform` The Transform to apply to the coordinate system.
+
+### Returns
+
+Nothing
+
+See also
+---
+
+- `Transform`

docs/lovr.headset.getEyePosition.md

@@ -0,0 +1,20 @@
+<!--
+category: reference
+-->
+
+lovr.headset.getEyePosition
+===
+
+Returns the current position of one the headset's eyes in 3d space.
+
+    x, y, z = lovr.headset.getEyePosition(eye)
+
+### Arguments
+
+- `HeadsetEye eye` The eye to return the position of.
+
+### Returns
+
+- `number x` The x position of the headset.
+- `number y` The y position of the headset.
+- `number z` The y position of the headset.