L-Systems in Unity

L-System is a rewriting system used mainly to model the development of plants. L-Systems in Unity enables you to rapidly create plants in your Unity games.

Getting Started

Add LSystemExecutor to a game object in your scene. Set a L-System definition (e.g., "Assets/Defs/3D Tree 1.txt") and rendering properties. Start the game.

	// 3D Tree 1.txt

	axiom=F
	angle=22.5
	number of derivations=3

	F=(1)F[-&^F][^++&F]||F[--&^F][+&F]

Advanced Usage

L-System processing is divided into three phases: parsing, derivation and interpretation. L-System on Unity's API map each phase to a static class.

Parsing

Method:

LSystemParser.Parse()

Input:

• l-system definition [string]

Output:

• axiom [string]
• angle [float]
• derivations [int]
• productions [Dictionary<string, List<Production>>]

Example:

	string axiom;
	float angle;
	int derivations;
	Dictionary<string, List<Production>> productions;
	LSystemParser.Parse(
			file.text,
			out axiom,
			out angle,
			out derivations,
			out productions);

Derivation

Method:

LSystemDeriver.Derive()

Input:

• axiom [string]
• angle [float]
• derivations [int]
• productions [Dictionary<string, List<Production>>]

Output:

• moduleString [string]

Example:

	string moduleString;
	LSystemDeriver.Derive(
			axiom,
			angle,
			derivations,
			rules,
			out moduleString);

Interpretation

Method:

LSystemInterpreter.Interpret()

Input:

• num. segment axial samplers [int]
• num. segment radial samplers [int]
• segment width [float]
• segment height [float]
• leaf size [float]
• leaf axial density [int]
• leaf radial density [int]
• use foliage [bool]
• narrow branches [bool]
• leaf material [UnityEngine.Material]
• trunk material [UnityEngine.Material]
• angle [float]
• moduleString [string]

Output:

• leaves [UnityEngine.GameObject]
• trunk [UnityEngine.GameObject]

Example:

	GameObject leaves, trunk;
	LSystemInterpreter.Interpret(
			segmentAxialSamples,
			segmentRadialSamples,
			segmentWidth,
			segmentHeight,
			leafSize,
			leafAxialDensity,
			leafRadialDensity,
			useFoliage,
			narrowBranches,
			leafMaterial,
			trunkMaterial,
			angle,
			moduleString,
			out leaves,
			out trunk);