Add new docs manuals

Author: adamgraham

.docfx/filterconfig.yml

@@ -5,3 +5,13 @@ apiRules:
     uidRegex: ^UnityEngine
 - exclude:
     uidRegex: ^UnityEditor
+- exclude:
+    uidRegex: ^Zigurous.Graphics.CheckerboardTextureDrawer.OnValidate
+- exclude:
+    uidRegex: ^Zigurous.Graphics.TextureDrawer.Awake
+- exclude:
+    uidRegex: ^Zigurous.Graphics.TextureDrawer.OnEnable
+- exclude:
+    uidRegex: ^Zigurous.Graphics.TextureDrawer.OnValidate
+- exclude:
+    uidRegex: ^Zigurous.Graphics.TextureDrawer.Update

.docfx/manual/auto-tiling.md

@@ -0,0 +1,9 @@
+# Auto Tiling
+
+One of the most powerful features included in the Graphics Utils package is the ability to auto tile materials based on the object's scale. In doing so, new materials are created that are unique to the object. This makes the workflow of creating materials for tiled objects effortless. Without this feature, you often end up creating dozens of variants of a material just to change the tiling values for different objects.
+
+Add the [AutoTile](xref:Zigurous.Graphics.AutoTile) script to the object you want to tile. The main properties that are usually edited are the `submeshes`. Each element in the array indicates how a submesh of the mesh is tiled, such as which axis the object is tiled on, the unit scale of the object, the texture offset, etc. For example, a plane is usually tiled around the Y+ axis and has a unit scale of 10. See the [Scripting API](xref:Zigurous.Graphics.AutoTile) for more information.
+
+### Cube Tiling
+
+When tiling cubes, the script gives the best results when used with the `Cube-Tiling.mesh` asset instead of Unity's default cube mesh. This mesh asset is split into 3 separate submeshes so you can tile each axis independently from the others. The mesh also has custom UV coordinates so the materials are tiled from the center of each axis.

.docfx/manual/meshes.md renamed to .docfx/manual/custom-meshes.md

@@ -1,22 +1,18 @@
-# Meshes
+# Custom Meshes
 
-The Graphics Utils package comes with a few custom cube meshes.
+The Graphics Utils package includes a few custom cube meshes.
 
 - `Cube-3.mesh`: cube mesh with 3 submeshes (one for each axis)
 - `Cube-6.mesh`: cube mesh with 6 submeshes (one for each face)
 - `Cube-Inverted.mesh`: cube mesh with inverted normals and triangles (inside-out)
-- `Cube-Tiling.mesh` cube mesh designed specifically for [Auto Tiling](tiling.md)
+- `Cube-Tiling.mesh` cube mesh designed specifically for [Auto Tiling](auto-tiling.md)
 
 There are also 3 different scripts to generate cube meshes at runtime:
 
 - [CubeMesh](xref:Zigurous.Graphics.CubeMesh)
 - [CubeMesh3](xref:Zigurous.Graphics.CubeMesh3)
 - [CubeMesh6](xref:Zigurous.Graphics.CubeMesh6)
 
-### Saving Meshes
-
-Often when generating meshes at runtime, you may want to save that mesh as an asset for future use so you do not need to regenerate them over and over. The Graphics Utils package comes with a [SaveMesh](xref:Zigurous.Graphics.SaveMesh) script that will save a mesh as an asset at runtime.
-
 ### Inverting Meshes
 
 Sometimes it is useful to invert a mesh so it renders inside out. This is especially useful for cubes. Inverting a mesh flips the triangles and the normals. The Graphics Utils package comes with an [InvertMesh](xref:Zigurous.Graphics.InvertMesh) script that handles this automatically.
@@ -31,3 +27,11 @@ mesh.InvertTriangles();
 Vector3[] normals = mesh.InvertedNormals();
 int[] triangles = mesh.InvertedTriangles();
 ```
+
+### Combining Meshes
+
+The Graphics Utils package includes a script to combine multiple meshes into a single mesh. This can sometimes be used to improve rendering performance, or as a way to create custom meshes and turn them into assets. Add the [CombineChildrenMeshes](xref:Zigurous.Graphics.CombineChildrenMeshes) script to a game object that includes an empty mesh filter. The script will combines the meshes of the children objects and apply the new combined mesh to the parent mesh filter.
+
+### Saving Meshes
+
+Often when generating meshes at runtime, you may want to save that mesh as an asset for future use so you do not need to regenerate them over and over. The Graphics Utils package comes with a [SaveMesh](xref:Zigurous.Graphics.SaveMesh) script that will save a mesh as an asset at runtime.

.docfx/manual/identifiers.md

@@ -4,6 +4,7 @@ The Graphics Utils package provides scripts and utilities for graphics and rende
 
 ### Reference
 
-- [Meshes](meshes.md)
-- [Identifiers](identifiers.md)
-- [Auto Tiling](tiling.md)
+- [Auto Tiling](auto-tiling.md)
+- [Custom Meshes](custom-meshes.md)
+- [Shader Properties](shader-properties.md)
+- [Texture Drawers](texture-drawers.md)

.docfx/manual/index.md

@@ -0,0 +1,38 @@
+# Shader Properties
+
+When setting shader properties on materials, it is more efficient to use property ids instead of strings. The Graphics Utils package comes with a static class [Identifier](xref:Zigurous.Graphics.Identifier) with predefined ids for common shader properties.
+
+```csharp
+private void Start()
+{
+    Material material = GetComponent<MeshRenderer>().material;
+    material.SetFloat(Identifier.Glossiness, 1.0f);
+}
+```
+
+### Automatic Property Ids
+
+The [ShaderProperty](xref:Zigurous.Graphics.ShaderProperty) struct included in the Graphics Utils package automatically creates a property id for a given shader property name. Anywhere you might declare a variable for a custom shader property name use `ShaderProperty` instead. It will still be serialized as a string in the editor, but you can use the id when getting or setting a shader property on a material.
+
+To learn more, see https://docs.unity3d.com/ScriptReference/Shader.PropertyToID.html.
+
+```csharp
+public ShaderProperty property = "_Custom";
+public float propertyValue;
+
+private void Start()
+{
+    Material material = GetComponent<MeshRenderer>().material;
+    material.SetFloat(property.id, propertyValue);
+}
+```
+
+### Animated Properties
+
+Sometimes you want to animate a shader property over time. The Graphics Utils package includes a few data structures to accomplish this. You can declare any one of the following in a script:
+
+- [AnimatedShaderIntProperty](xref:Zigurous.Graphics.AnimatedShaderIntProperty)
+- [AnimatedShaderFloatProperty](xref:Zigurous.Graphics.AnimatedShaderFloatProperty)
+- [AnimatedShaderColorProperty](xref:Zigurous.Graphics.AnimatedShaderColorProperty)
+
+The structs provide a `valueOverTime` or `colorOverTime` variable that you can use to set the animated values. At this point your script can call `Animate(material, time)` to evaluate the value at the given time and apply it to the provided material.

.docfx/manual/shader-properties.md

@@ -0,0 +1,11 @@
+# Texture Drawers
+
+The Graphics Utils package includes a base class for drawing textures at runtime. It provides the boilerplate code for creating and drawing new textures programmatically. Create a new class that inherits from [TextureDrawer](xref:Zigurous.Graphics.TextureDrawer) and override the function `SetPixels(Texture2D)` to complete the implementation.
+
+### Rendering
+
+The [TextureDrawer](xref:Zigurous.Graphics.TextureDrawer) script will automatically apply your texture to the renderer's main material on the object if a Renderer component is available. This is not required, but often is useful. There are additional customization options available in regards to the rendering, such as which shader property the texture is set to.
+
+### Checkerboard
+
+The Graphics Utils package includes a script [CheckerboardTextureDrawer](xref:Zigurous.Graphics.CheckerboardTextureDrawer) as a sample implementation. It is, of course, a fully functional script that draws a checkerboard pattern. This can be used however you desire, and there are even a number of customization options available.

.docfx/manual/texture-drawers.md

@@ -4,9 +4,11 @@
   href: installation.md
 - name: Reference
   items:
-  - name: Meshes
-    href: meshes.md
-  - name: Identifiers
-    href: identifiers.md
   - name: Auto Tiling
-    href: tiling.md
+    href: auto-tiling.md
+  - name: Custom Meshes
+    href: custom-meshes.md
+  - name: Shader Properties
+    href: shader-properties.md
+  - name: Texture Drawers
+    href: texture-drawers.md

.docfx/manual/tiling.md

@@ -32,6 +32,7 @@ using Zigurous.Graphics;
 
 ## Reference
 
-- [Meshes](https://docs.zigurous.com/com.zigurous.graphics/manual/meshes.html)
-- [Identifiers](https://docs.zigurous.com/com.zigurous.graphics/manual/identifiers.html)
-- [Auto Tiling](https://docs.zigurous.com/com.zigurous.graphics/manual/tiling.html)
+- [Auto Tiling](https://docs.zigurous.com/com.zigurous.graphics/manual/auto-tiling.md)
+- [Custom Meshes](https://docs.zigurous.com/com.zigurous.graphics/manual/custom-meshes.md)
+- [Shader Properties](https://docs.zigurous.com/com.zigurous.graphics/manual/shader-properties.md)
+- [Texture Drawers](https://docs.zigurous.com/com.zigurous.graphics/manual/texture-drawers.md)