Add docs manuals

Author: adamgraham

.docfx/manual/identifiers.md

@@ -0,0 +1,26 @@
+# Identifiers
+
+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 many common shader properties. To learn more, see https://docs.unity3d.com/ScriptReference/Shader.PropertyToID.html.
+
+```csharp
+private void Start()
+{
+    Material material = GetComponent<MeshRenderer>().material;
+    material.SetFloat(Identifier.Glossiness, 1.0f);
+}
+```
+
+### [Shader Property](xref:Zigurous.Graphics.ShaderProperty)
+
+The `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 in the editor as a string, but you can use the id when getting or setting a shader property on a material.
+
+```csharp
+public ShaderProperty property = "_Custom";
+public float propertyValue;
+
+private void Start()
+{
+    Material material = GetComponent<MeshRenderer>().material;
+    material.SetFloat(property.id, propertyValue);
+}
+```

.docfx/manual/index.md

@@ -1,3 +1,9 @@
 # Graphics Utils
 
-The Graphics Utils package provides scripts and utilities for graphics and rendering purposes in Unity projects.
+The Graphics Utils package provides scripts and utilities for graphics and rendering purposes in Unity projects. The package is still early in development, and more functionality will be added over time.
+
+### Reference
+
+- [Meshes](meshes.md)
+- [Identifiers](identifiers.md)
+- [Auto Tiling](tiling.md)

.docfx/manual/meshes.md

@@ -0,0 +1,33 @@
+# Meshes
+
+The Graphics Utils package comes with 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)
+
+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.
+
+You can also manually invert the normals and triangles of a mesh by using extension methods:
+
+```csharp
+mesh.InvertNormals();
+mesh.InvertTriangles();
+
+// Returns the inverted values without changing the actual mesh
+Vector3[] normals = mesh.InvertedNormals();
+int[] triangles = mesh.InvertedTriangles();
+```

.docfx/manual/tiling.md

@@ -0,0 +1,5 @@
+# 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.
+
+The [AutoTile](xref:Zigurous.Graphics.AutoTile) script is intended to be used with the `Cube-Tiling.mesh` asset. 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. That said, the script has several properties to customize how you want to tile the object, so it is possible to use your own meshes.

.docfx/manual/toc.yml

@@ -2,3 +2,11 @@
   href: index.md
 - name: Installation
   href: installation.md
+- name: Reference
+  items:
+  - name: Meshes
+    href: meshes.md
+  - name: Identifiers
+    href: identifiers.md
+  - name: Auto Tiling
+    href: tiling.md

README.md

@@ -1,6 +1,6 @@
 # Graphics Utils
 
-The Graphics Utils package provides scripts and utilities for graphics and rendering purposes in Unity projects.
+The Graphics Utils package provides scripts and utilities for graphics and rendering purposes in Unity projects. The package is still early in development, and more functionality will be added over time.
 
 ## Installation
 
@@ -29,3 +29,9 @@ Import the package namespace in each script or file you want to use it.
 ```csharp
 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)