Update documentation for 0.3.0;

Author: bjornbytes

docs/Texture.md

@@ -11,7 +11,7 @@ include `.png`, `.jpg`, `.tga`, and `.bmp`.
 <table>
 <tr>
   <td class="pre">lovr.graphics.newTexture</td>
-  <td>Create a new Texture from an image file.</td>
+  <td>Create a new Texture.</td>
 </tr>
 
 <tr>
@@ -39,6 +39,11 @@ include `.png`, `.jpg`, `.tga`, and `.bmp`.
   <td>Get the current <code>WrapMode</code> of the Texture.</td>
 </tr>
 
+<tr>
+  <td class="pre">Texture:renderTo</td>
+  <td>Render to a Texture using a function.</td>
+</tr>
+
 <tr>
   <td class="pre">Texture:setFilter</td>
   <td>Set the <code>FilterMode</code> of the Texture, used to control upsampling and downsampling.</td>

docs/Texture:renderTo.md

@@ -0,0 +1,27 @@
+<!--
+category: reference
+-->
+
+Texture:renderTo
+===
+
+Render to a texture using a function.
+
+    texture:renderTo(callback)
+
+### Arguments
+
+- `function callback` The function used to render to the texture.  Normal `lovr.graphics` functions
+can be used inside the callback to change the contents of the texture.
+
+### Returns
+
+Nothing
+
+Notes
+---
+
+1. Textures created from an image can't be rendered to.  See `lovr.graphics.newTexture` for details on
+creating an empty texture with a width and height.
+1. Make sure you clear the contents of the texture before rendering using `lovr.graphics.clear`.
+Otherwise there might be garbage data in the texture.

docs/TextureProjection.md

@@ -0,0 +1,16 @@
+<!--
+category: reference
+-->
+
+TextureProjection
+===
+
+When creating Textures to be used as render targets, they can be created in either "2d" or "3d"
+mode.  2D mode is good for 2D user interfaces or postprocessing, whereas 3d is useful for portals,
+weapon scopes, mirrors, and other situations where 3D content needs to be rendered.
+
+Values
+---
+
+- `2d` Optimize the texture for rendering 2d content using an orthographic projection.
+- `3d` Optimize the texture for rendering 3d content using a perspective projection.

docs/lovr.graphics.cube.md

@@ -24,3 +24,25 @@ Draws a cube with a given position, size, and orientation.
 ### Returns
 
 Nothing
+
+---
+
+Draw a textured cube
+
+    lovr.graphics.cube(texture, x, y, z, size, angle, ax, ay, az)
+
+### Arguments
+
+- `Texture texture` The Texture to apply to the cube.
+- `number x (0)` The x coordinate of the center of the cube.
+- `number y (0)` The y coordinate of the center of the cube.
+- `number z (0)` The z coordinate of the center of the cube.
+- `number size (1.0)` The z coordinate of the center of the cube.
+- `number angle (0)` The rotation of the cube around its rotation axis, in radians.
+- `number ax (0)` The x coordinate of the cube's axis of rotation.
+- `number ay (1)` The y coordinate of the cube's axis of rotation.
+- `number az (0)` The z coordinate of the cube's axis of rotation.
+
+### Returns
+
+Nothing

docs/lovr.graphics.newTexture.md

@@ -5,7 +5,10 @@ category: reference
 lovr.graphics.newTexture
 ===
 
-Creates a new texture from an image file.
+Creates a new texture.  The texture can be loaded from an image file, or it can be created as an
+empty render target.
+
+---
 
     texture = lovr.graphics.newTexture(filename)
 
@@ -16,3 +19,19 @@ Creates a new texture from an image file.
 ### Returns
 
 - `Texture texture` The new Texture.
+
+---
+
+    texture = lovr.graphics.newTexture(width, height, projection, msaa)
+
+### Arguments
+
+- `number width` The width of the texture, in pixels.
+- `number height` The height of the texture, in pixels.
+- `TextureProjection projection (3d)` The type of the projection to use for the Texture.
+- `number msaa (0)` The number of samples to use for multisample antialiasing.  A higher number will
+  make things look prettier at the cost of performance.  Set to 0 to disable antialiasing.
+
+### Returns
+
+- `Texture texture` The new Texture.  To render to it, use `Texture:renderTo`.

docs/lovr.graphics.plane.md

@@ -23,3 +23,38 @@ Draws a plane with a given position, size, and orientation.
 ### Returns
 
 Nothing
+
+---
+
+Draw a textured plane
+
+    lovr.graphics.plane(texture, x, y, z, size, nx, ny, nz)
+
+### Arguments
+
+- `Texture texture` The Texture to apply to the plane.
+- `number x (0)` The x coordinate of the center of the plane.
+- `number y (0)` The y coordinate of the center of the plane.
+- `number z (0)` The z coordinate of the center of the plane.
+- `number size (1.0)` The size of the plane, in meters.
+- `number nx (0.0)` The x coordinate of the normal vector of the plane.
+- `number ny (1.0)` The y coordinate of the normal vector of the plane.
+- `number nz (0.0)` The z coordinate of the normal vector of the plane.
+
+### Returns
+
+Nothing
+
+---
+
+Draw a textured plane that takes up the whole screen
+
+    lovr.graphics.plane(texture)
+
+### Arguments
+
+- `Texture texture` The texture to use.
+
+### Returns
+
+Nothing