Geo: a small flat-array mesh builder shared by forestProps generators.
local Geo = require("~.Geo")
local g = Geo.new()
local a = Geo.vertex(g, 0,0,0, 0,0,1, 0,1, 1,1,1,0) -- returns a 0-based index
Geo.tri(g, a, b, c) -- counter-clockwise = front
Geo.bake("forestProps.package/meshes/trees", "oak_mature_v1_lod0_bark", g)
Vertex colour follows the forest contract: RGB is a tint multiplier, ALPHA is
the wind sway weight (0 rigid at the base, 1 full sway at the tips).
tri(g: Geometry, a: number, b: number, c: number) → void
| arg | type | description |
|---|
| g | Geometry | |
| a | number | |
| b | number | |
| c | number | |
triCount(g: Geometry) → number
| arg | type | description |
|---|
| g | Geometry | |
append(dst: Geometry, src: Geometry) → void
Append src into dst (indices re-based).
| arg | type | description |
|---|
| dst | Geometry | |
| src | Geometry | |
bounds(g: Geometry) → void
Axis-aligned bounds { min = {x,y,z}, max = {x,y,z} }.
| arg | type | description |
|---|
| g | Geometry | |
orient(g: { positions: { number }, normals: { number }, indices: { number } }) → number
Make every triangle's winding agree with its vertex normals: the engine draws counter-clockwise triangles as front faces, so a triple whose face normal (b-a)x(c-a) points against the sum of its three vertex normals has two indices swapped. Works on any table with flat positions / normals / 0-based indices. Returns how many triangles were flipped.
| arg | type | description |
|---|
| g | { positions: { number }, normals: { number }, indices: { number } } | |
solid(g: { colors: { number }? }) → void
Set vertex alpha to 1 on every vertex (RGB kept): the colour contract for SOLID parts (bark, wood, stone, soil, fungus, moss cushions), whose alpha would otherwise fade them under a material that multiplies vertex alpha into surface alpha.
| arg | type | description |
|---|
| g | { colors: { number }? } | |
bake(folder: string, name: string, g: Geometry, solid: boolean?) → any
Write g as a durable .mesh asset at <folder>/<name>.mesh (folder relative to /zero/source), replacing an earlier bake. Triangle winding is made to agree with the vertex normals first; `solid` sets vertex alpha to 1 (any part that is not a swaying foliage card).
| arg | type | description |
|---|
| folder | string | |
| name | string | |
| g | Geometry | |
| solid | boolean? | |
v(x: number, y: number, z: number) → void
| arg | type | description |
|---|
| x | number | |
| y | number | |
| z | number | |
add(a: { number }, b: { number }) → void
| arg | type | description |
|---|
| a | { number } | |
| b | { number } | |
sub(a: { number }, b: { number }) → void
| arg | type | description |
|---|
| a | { number } | |
| b | { number } | |
scale(a: { number }, s: number) → void
| arg | type | description |
|---|
| a | { number } | |
| s | number | |
dot(a: { number }, b: { number }) → number
| arg | type | description |
|---|
| a | { number } | |
| b | { number } | |
cross(a: { number }, b: { number }) → void
| arg | type | description |
|---|
| a | { number } | |
| b | { number } | |
len(a: { number }) → number
| arg | type | description |
|---|
| a | { number } | |
norm(a: { number }) → void
| arg | type | description |
|---|
| a | { number } | |
lerp(a: { number }, b: { number }, t: number) → void
| arg | type | description |
|---|
| a | { number } | |
| b | { number } | |
| t | number | |
rotate(v: { number }, k: { number }, angle: number) → void
Rotate vector v about unit axis k by angle (Rodrigues).
| arg | type | description |
|---|
| v | { number } | |
| k | { number } | |
| angle | number | |
perp(v: { number }) → void
Any unit vector perpendicular to unit v.
| arg | type | description |
|---|
| v | { number } | |
rng(seed: number) → Rng
A seeded random stream; Geo.rand(r) -> [0,1), Geo.range(r, a, b).
| arg | type | description |
|---|
| seed | number | |
range(r: Rng, a: number, b: number) → number
| arg | type | description |
|---|
| r | Rng | |
| a | number | |
| b | number | |
hash(s: string) → number
A hash of a string into a seed number.
| arg | type | description |
|---|
| s | string | |
noise1(x: number, seed: number) → number
Smooth 1D value noise in [-1,1].
| arg | type | description |
|---|
| x | number | |
| seed | number | |
h(n: number) → number
| arg | type | description |
|---|
| n | number | |