game.arena.ArenaGeo — geometry kit for the Rogue Ice arena set.
A mesh builder that accumulates flat arrays in the shape `asset.create("mesh")`
takes (positions / normals / uvs / colors / indices), box and quad emitters,
and the rink perimeter: the rounded rectangle of Core.RINK and its offsets,
sampled as a path with outward normals and arc length, which the boards,
glass, stands, suite ring and crowd are all swept along.
builder(withColors: boolean?) → Builder
| arg | type | description |
|---|
| withColors | boolean? | |
vertex(b: Builder, x: number, y: number, z: number, nx: number, ny: number, nz: number, u: number, v: number, c: { number }?) → number
| arg | type | description |
|---|
| b | Builder | |
| x | number | |
| y | number | |
| z | number | |
| nx | number | |
| ny | number | |
| nz | number | |
| u | number | |
| v | number | |
| c | { number }? | |
tri(b: Builder, a: number, c: number, d: number) → void
| arg | type | description |
|---|
| b | Builder | |
| a | number | |
| c | number | |
| d | number | |
quad(b: Builder, p0: { number }, p1: { number }, p2: { number }, p3: { number }, c: { number }?, u0: number?, v0: number?, u1: number?, v1: number?) → void
A quad from four corners given counter-clockwise as seen from its front.
uv rect (u0,v0)-(u1,v1): p0 -> (u0,v1), p1 -> (u1,v1), p2 -> (u1,v0), p3 -> (u0,v0)
| arg | type | description |
|---|
| b | Builder | |
| p0 | { number } | |
| p1 | { number } | |
| p2 | { number } | |
| p3 | { number } | |
| c | { number }? | |
| u0 | number? | |
| v0 | number? | |
| u1 | number? | |
| v1 | number? | |
box(b: Builder, cx: number, cy: number, cz: number, hx: number, hy: number, hz: number, yaw: number, c: { number }?, skipBottom: boolean?) → void
An oriented box: centre, half sizes along its own axes, yaw (radians about +Y).
Faces: 6 quads with flat normals (24 vertices). `skipBottom` drops the base.
| arg | type | description |
|---|
| b | Builder | |
| cx | number | |
| cy | number | |
| cz | number | |
| hx | number | |
| hy | number | |
| hz | number | |
| yaw | number | |
| c | { number }? | |
| skipBottom | boolean? | |
P(x: number, y: number, z: number) → void
| arg | type | description |
|---|
| x | number | |
| y | number | |
| z | number | |
lowBox(b: Builder, cx: number, cy: number, cz: number, hx: number, hy: number, hz: number, yaw: number, c: { number }, uvx: number, uvyBottom: number, uvyTop: number) → void
A cheap box: 8 shared vertices with averaged normals (12 triangles), the
crowd's building block. `uvx`/`uvy` are written on every vertex; `uvyTop`
overrides uv.y on the top four (so an arm's top can carry a different drop).
| arg | type | description |
|---|
| b | Builder | |
| cx | number | |
| cy | number | |
| cz | number | |
| hx | number | |
| hy | number | |
| hz | number | |
| yaw | number | |
| c | { number } | |
| uvx | number | |
| uvyBottom | number | |
| uvyTop | number | |
v(ix: number, iy: number, iz: number) → number
vertex index = base + ix + 2*iz + 4*iy
| arg | type | description |
|---|
| ix | number | |
| iy | number | |
| iz | number | |
q(a: number, bb: number, cc: number, d: number) → void
| arg | type | description |
|---|
| a | number | |
| bb | number | |
| cc | number | |
| d | number | |
mesh(b: Builder) → void
| arg | type | description |
|---|
| b | Builder | |
perimeter(R: { [string]: any }, off: number, step: number) → void
Sample the rounded rectangle offset outward by `off` metres. `step` is the
target spacing in metres. The path starts at the middle of the south side
(+Z) and runs counter-clockwise seen from above (toward +X first).
Each point carries its outward normal, arc length and which side it is on
("S","E","N","W" or "SE","NE","NW","SW" for the corners).
| arg | type | description |
|---|
| R | { [string]: any } | |
| off | number | |
| step | number | |
add(x: number, z: number, nx: number, nz: number, straight: boolean, side: string) → void
| arg | type | description |
|---|
| x | number | |
| z | number | |
| nx | number | |
| nz | number | |
| straight | boolean | |
| side | string | |
line(x0: number, z0: number, x1: number, z1: number, nx: number, nz: number, side: string, includeEnd: boolean) → void
| arg | type | description |
|---|
| x0 | number | |
| z0 | number | |
| x1 | number | |
| z1 | number | |
| nx | number | |
| nz | number | |
| side | string | |
| includeEnd | boolean | |
arc(cx: number, cz: number, a0: number, a1: number, side: string) → void
| arg | type | description |
|---|
| cx | number | |
| cz | number | |
| a0 | number | |
| a1 | number | |
| side | string | |
perimeterLength(R: { [string]: any }, off: number) → number
Total length of a closed perimeter offset by `off`.
| arg | type | description |
|---|
| R | { [string]: any } | |
| off | number | |
sweepWall(b: Builder, pts: { PathPoint }, y0: number, y1: number, inset: number, inward: boolean, c: { number }?, uScale: number?) → void
Sweep a vertical strip between heights y0..y1 along a path, offset
`inset` along the normal (negative = toward the rink). `inward` makes the
face look toward the rink (normal -n); otherwise outward. U runs along the
arc length / uScale.
| arg | type | description |
|---|
| b | Builder | |
| pts | { PathPoint } | |
| y0 | number | |
| y1 | number | |
| inset | number | |
| inward | boolean | |
| c | { number }? | |
| uScale | number? | |
sweepFlat(b: Builder, pts: { PathPoint }, y: number, o0: number, o1: number, down: boolean?, c: { number }?) → void
Sweep a horizontal strip at height y between two offsets o0 < o1 (along
the normal), facing up (or down with `down`).
| arg | type | description |
|---|
| b | Builder | |
| pts | { PathPoint } | |
| y | number | |
| o0 | number | |
| o1 | number | |
| down | boolean? | |
| c | { number }? | |
shaftCone(b: Builder, r: number, h: number, seg: number) → void
A cone (open, apex at origin pointing down -Y in local space) as a light
shaft: radius r at length h, `seg` sides. uv.y = 0 at the apex, 1 at the base.
| arg | type | description |
|---|
| b | Builder | |
| r | number | |
| h | number | |
| seg | number | |
hash(i: number, salt: number?) → number
Deterministic hash in [0,1) for integers, so every rebuild lays the same crowd.
| arg | type | description |
|---|
| i | number | |
| salt | number? | |
hex(h: string, a: number?) → void
sRGB hex to linear {r,g,b,1}
| arg | type | description |
|---|
| h | string | |
| a | number? | |
ch(i: number) → number
| arg | type | description |
|---|
| i | number | |