RockGeo: generators for jungleProps' natural stone: water-worn river
boulders, moss-capped boulders, wet walkable slabs, fused rock clusters, a
tileable mossy cliff face, the waterfall lip (a ledge with a notch the water
pours over) and a line of stepping stones across a stream. Bake-time only
(StructureBake runs them through StructureGen).
local Rocks = require("~.RockGeo")
local parts, meta = Rocks.SPECS.riverBoulder.build(rng, variant, lod, form)
-- parts = { body = Geo, moss = Geo? }, meta = { collision = Geo?, size = {...}, lip = {...}? }
Every shape is a signed-distance function meshed by StoneGeo's surface nets
at a triangle budget per LOD, so LOD 0/1/2 and the toon / lowpoly forms are
the same rock. Every random number is drawn before any LOD-dependent work.
Moss is the triangles facing up (with noise) split into their own part,
drawn with the mossThick surface; vertex RGB tints the stone (dark wet foot,
crevices, lichen-grey tops). Origins at ground contact; every rock reaches
below y = 0 so it sits in soil or water.
detailOf(lod: number, form: string) → number
Surface detail by LOD and form: 1 near, 0.55 mid, 0.15 far; toon and lowpoly drop fine detail.
| arg | type | description |
|---|
| lod | number | |
| form | string | |
trisFor(budget: { number }, lod: number, form: string) → number
Triangle target for a LOD and form from a { lod0, lod1, lod2 } budget.
| arg | type | description |
|---|
| budget | { number } | |
| lod | number | |
| form | string | |
sculpt(sdfFor: (number, string) → void
Mesh a sculpted kind: sdfFor(detail, form) -> sdf inside lo..hi at the budget for this LOD/form, tinted by color. With colBudget, meta.collision is a coarse mesh of the same shape (LOD 0 of the default form only).
| arg | type | description |
|---|
| sdfFor | (number, string | |
rotY(x: number, z: number, c: number, s: number) → void
| arg | type | description |
|---|
| x | number | |
| z | number | |
| c | number | |
| s | number | |
tint(seed: number, o: { wet: number?, algae: number?, lichen: number?, warm: number? }?) → void
A jungle stone tint: grey-brown mottling, crevices darker, a dark wet foot below `wet` metres, faint green algae near the foot, paler dry lichen on top faces. Returns color(x,y,z,nx,ny,nz,ao) -> r,g,b.
| arg | type | description |
|---|
| seed | number | |
| o | { wet: number?, algae: number?, lichen: number?, warm: number? }? | |
mossClass(seed: number, up: number, minY: number?, cover: number?) → void
A moss classifier for G.split: triangles facing up more than `up` (noise-broken), above `minY`, become "moss"; the rest "body".
| arg | type | description |
|---|
| seed | number | |
| up | number | |
| minY | number? | |
| cover | number? | |
flats(rng: any, a: number, b: number, c: number, n: number, lo: number, hi: number, tiltY: number?) → void
random flattening planes for a stone of semi-axes a, b, c: { nx, ny, nz, d }
| arg | type | description |
|---|
| rng | any | |
| a | number | |
| b | number | |
| c | number | |
| n | number | |
| lo | number | |
| hi | number | |
| tiltY | number? | |
newStone(rng: any, a: number, b: number, c: number, o: any) → Stone
| arg | type | description |
|---|
| rng | any | |
| a | number | |
| b | number | |
| c | number | |
| o | any | |
stoneSdf(st: Stone, detail: number, form: string) → G
a water-worn stone: an ellipsoid pressed flat by a few planes, warped by fbm
| arg | type | description |
|---|
| st | Stone | |
| detail | number | |
| form | string | |
stoneBounds(list: { Stone }, pad: number) → void
| arg | type | description |
|---|
| list | { Stone } | |
| pad | number | |
floorAt(lo: { number }, y: number) → void
| arg | type | description |
|---|
| lo | { number } | |
| y | number | |
sdfFor(detail: number, form: string) → G
| arg | type | description |
|---|
| detail | number | |
| form | string | |
cliffLayers( ) → void
the strata every cliff tile shares, so the profile at x = +-6 matches between tiles
sdfFor(detail: number, form: string) → G
| arg | type | description |
|---|
| detail | number | |
| form | string | |
chanX(z: number) → number
| arg | type | description |
|---|
| z | number | |
sdfFor(detail: number, form: string) → G
| arg | type | description |
|---|
| detail | number | |
| form | string | |
sdfFor(detail: number, form: string) → G
| arg | type | description |
|---|
| detail | number | |
| form | string | |
⌬ Types
Spec = { category: string, variants: number, styled: boolean?, build: (rng: any, v: number, lod: number, form: string, style: string?) -> (Parts, any?) }