geom
`puttCourse.geom`: a small vertex-coloured mesh builder (quad, poly, box, oriented box, cylinder, tube, ring, disc, holed plane, sphere) that merges everything into one mesh per layer, with a mesh cache (`cached(key, make)`). Used by pieces, flags, effects and balls; handy for an…
geom
puttCourse.geom: a small vertex-coloured mesh builder (quad, poly, box, oriented box, cylinder, tube, ring, disc, holed plane, sphere) that merges everything into one mesh per layer, with a mesh cache (cached(key, make)). Used by pieces, flags, effects and balls; handy for any low-poly procedural prop.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2puttCourse.geom: a small low-poly mesh builder. Flat-shaded faces with vertex colours, merged into ONE runtime mesh per layer, so a course piece draws in one or two calls. Built meshes are cached by key and shared, so every copy of the same piece in the same theme is one GPU mesh.
new(mirror: boolean?) → Builder
A new empty builder. `mirror` = true mirrors everything across x = 0 (a left-handed copy of a piece).
| arg | type | description |
|---|---|---|
| mirror | boolean? |
sub(a: { number }, b: { number }) → void
| arg | type | description |
|---|---|---|
| a | { number } | |
| b | { number } |
vert(b: Builder, x: number, y: number, z: number, nrx: number, nry: number, nrz: number, col: { number }) → void
| arg | type | description |
|---|---|---|
| b | Builder | |
| x | number | |
| y | number | |
| z | number | |
| nrx | number | |
| nry | number | |
| nrz | number | |
| col | { number } |
poly(b: Builder, pts: { { number } }, col: { number }, hint: { number }?) → void
A flat convex polygon (3+ points, counter-clockwise seen from its front). `hint` = a direction the front should face; when given the winding is flipped to face it.
| arg | type | description |
|---|---|---|
| b | Builder | |
| pts | { { number } } | |
| col | { number } | |
| hint | { number }? |
quad(b: Builder, a: { number }, c: { number }, d: { number }, e: { number }, col: { number }, hint: { number }?) → void
Quad from four corners in order (either winding; `hint` picks the front, default up).
| arg | type | description |
|---|---|---|
| b | Builder | |
| a | { number } | |
| c | { number } | |
| d | { number } | |
| e | { number } | |
| col | { number } | |
| hint | { number }? |
box(b: Builder, x0: number, y0: number, z0: number, x1: number, y1: number, z1: number, top: { number }, side: { number }?, skip: any?) → void
Axis-aligned box from min to max corner. `top` colours the +y face, `side` the others. `skip` = { top=true, bottom=true, nrx=true, px=true, nrz=true, pz=true } leaves faces out.
| arg | type | description |
|---|---|---|
| b | Builder | |
| x0 | number | |
| y0 | number | |
| z0 | number | |
| x1 | number | |
| y1 | number | |
| z1 | number | |
| top | { number } | |
| side | { number }? | |
| skip | any? |
obox(b: Builder, c: { number }, u: { number }, v: { number }, w: { number }, hx: number, hy: number, hz: number, top: { number }, side: { number }?) → void
Oriented box: centre `c`, unit axes `u` (x), `v` (y, "up" face gets `top`), `w` (z), half sizes.
| arg | type | description |
|---|---|---|
| b | Builder | |
| c | { number } | |
| u | { number } | |
| v | { number } | |
| w | { number } | |
| hx | number | |
| hy | number | |
| hz | number | |
| top | { number } | |
| side | { number }? |
P(sx: number, sy: number, sz: number) → void
| arg | type | description |
|---|---|---|
| sx | number | |
| sy | number | |
| sz | number |
cyl(b: Builder, cx: number, y0: number, y1: number, cz: number, r: number, segs: number, side: { number }, top: { number }?, bottom: boolean?) → void
Upright prism (a low-poly cylinder) from y0 to y1 at (cx, cz), `segs` sides. Caps optional.
| arg | type | description |
|---|---|---|
| b | Builder | |
| cx | number | |
| y0 | number | |
| y1 | number | |
| cz | number | |
| r | number | |
| segs | number | |
| side | { number } | |
| top | { number }? | |
| bottom | boolean? |
tubeIn(b: Builder, cx: number, y0: number, y1: number, cz: number, r: number, segs: number, col: { number }) → void
Inside wall of a tube (normals facing in): a cup liner.
| arg | type | description |
|---|---|---|
| b | Builder | |
| cx | number | |
| y0 | number | |
| y1 | number | |
| cz | number | |
| r | number | |
| segs | number | |
| col | { number } |
ring(b: Builder, cx: number, y: number, cz: number, r0: number, r1: number, segs: number, col: { number }) → void
Flat ring (annulus) facing up at height y.
| arg | type | description |
|---|---|---|
| b | Builder | |
| cx | number | |
| y | number | |
| cz | number | |
| r0 | number | |
| r1 | number | |
| segs | number | |
| col | { number } |
holed(b: Builder, x0: number, z0: number, x1: number, z1: number, hx: number, hz: number, r: number, segs: number, col: { number }, height: ((number, number) → void
The top of a rectangle [x0,x1] x [z0,z1] with a round hole of radius r at (hx, hz). `height(x, z)` gives the surface height (flat 0 if nil); `stripe(x, z)` can return a second colour.
| arg | type | description |
|---|---|---|
| b | Builder | |
| x0 | number | |
| z0 | number | |
| x1 | number | |
| z1 | number | |
| hx | number | |
| hz | number | |
| r | number | |
| segs | number | |
| col | { number } | |
| height | ((number, number |
h(x: number, z: number) → number
| arg | type | description |
|---|---|---|
| x | number | |
| z | number |
edge(a: number) → void
| arg | type | description |
|---|---|---|
| a | number |
disc(b: Builder, cx: number, y: number, cz: number, r: number, segs: number, col: { number }) → void
A flat triangle-fan disc facing up.
| arg | type | description |
|---|---|---|
| b | Builder | |
| cx | number | |
| y | number | |
| cz | number | |
| r | number | |
| segs | number | |
| col | { number } |
sphere(b: Builder, cx: number, cy: number, cz: number, r: number, segs: number, rings: number, col: { number }, band: { number }?) → void
A low-poly sphere (flat-shaded latitude bands). `band` colours the equator band, so a rolling ball shows its spin.
| arg | type | description |
|---|---|---|
| b | Builder | |
| cx | number | |
| cy | number | |
| cz | number | |
| r | number | |
| segs | number | |
| rings | number | |
| col | { number } | |
| band | { number }? |
pt(i: number, k: number) → void
| arg | type | description |
|---|---|---|
| i | number | |
| k | number |
size(b: Builder) → number
Number of vertices so far.
| arg | type | description |
|---|---|---|
| b | Builder |
build(b: Builder) → any
The finished runtime mesh (nil when nothing was added).
| arg | type | description |
|---|---|---|
| b | Builder |
cached(key: string, make: () → void
A cached mesh: `make()` builds it the first time `key` is asked for; later calls share it.
| arg | type | description |
|---|---|---|
| key | string | |
| make | ( |
clearCache( ) → void
Forget every cached mesh (after a theme's colours were edited).
Builder = typeof(setmetatable({} :: {Merged vertex-coloured low-poly mesh builder with a cache.Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.