Procedural Toolkit

LibTessDotNet is a robust and fast tessellator for .NET designed to produce polygons with N vertices (where N >= 3) and perform triangulation. It is compatible with .NET Framework 2.0, making it suitable for use with Mono, Unity, or XNA.

Key capabilities include:

• Tessellating arbitrary complex polygons (self-intersecting, coincident vertices).
• Supporting advanced winding rules: even/odd, non zero, positive, negative, and |winding| >= 2.
• Custom input support, including custom vertex attributes (e.g., UV coordinates) with merging callbacks.
• Forcing input contour orientation (clockwise/counterclockwise).
• Single and double precision support.
• Compatibility with polygons computed using the Clipper library.

You can also install the toolkit by importing it from the Unity Asset Store or downloading a release from the GitHub Releases page.

Note: If you have previous versions of the toolkit installed, it is highly recommended to delete them before importing a newer version.

The toolkit includes a shader library for utilizing SDF functions. Examples include:

• StarPolygon: Demonstrates 'normal' vs 'cheap' polygon functions.
• Shapes: Demonstrates available shapes.
• DistanceOperations: Shows combining shapes (e.g., square and circle) using different functions.
• Easing: Demonstrates easing curves and motion.
• Transitions: Shows sequencing and animation techniques.
• Animation: Demonstrates complex pattern creation and animation in shaders.

The BuildingGenerator creates entire meshes from scratch and paints vertices. Note that generated meshes do not have UV maps, so they are not compatible with the Standard shader.

Key components for building generation:

• BuildingGeneratorComponent: A minimal implementation example.
• BuildingGeneratorConfigurator: A UI-based configurator with editor controls.
• ProceduralFacadePlanner: Controls facade layouts.
• ProceduralFacadeConstructor: Used with the planner for facade construction.
• ProceduralRoofPlanner: Generates roof descriptions.
• ProceduralRoofConstructor: Used with the roof planner for construction.
• ProceduralFacadeElements: A collection of procedural facade panels.
• PolygonAsset: A ScriptableObject used to contain vertices.

The MazeGenerator creates mazes based on input configuration and can draw the generation process onto a texture.

Key components:

• MazeGeneratorConfigurator: UI controls for the generator.
• Maze: The graph representation of the generated maze.

After installation, import the ProceduralToolkit namespace to access the library's features.

If you are using Assembly Definitions, you must add ProceduralToolkit as a reference in your assembly definition file.

using UnityEngine;
using ProceduralToolkit;

public class ReadmeExample : MonoBehaviour
{
    private void Update()
    {
        Debug.Log(string.Format("<color=#{0}>{0}</color>", RandomE.colorHSV.ToHtmlStringRGB()));
    }
}

The recommended installation method is using the Unity Package Manager as a Git package. Ensure Git is installed and available in your system's PATH.

Add the package using the following URL: https://github.com/Syomus/ProceduralToolkit.git#upm

The ChairGenerator is the main class for generating chair meshes from scratch.

Key components:

• ChairGeneratorConfigurator: Provides UI and editor controls for configuration.
• Armrests, Backs, and Stretchers: Specific constructors for chair parts.

The CharacterGenerator creates a sprite set and a random name for 2D characters.

Key components:

• Character: A container for sprite renderers.
• NameGenerator: Generates random names from a large array.
• CharacterGeneratorConfigurator: UI for configuring the generator.

The CellularAutomaton class can be used to run simulations, with the results drawn onto a texture.

Note: Some rulesets require a noise value different from the default setting. Use CellularAutomatonConfigurator for UI-based control.