Expand description
Build-time geometry compiler for the Brass Poolrooms visual universe.
Applications author three-dimensional Model dies and forge them into
compact, colored two-dimensional triangle meshes. Projection, illumination,
material response, visibility, and shadows share the exact laws used by
Poolrooms’ own mechanisms.
Structs§
- Mesh
- A compact two-dimensional mesh forged from a three-dimensional die.
- Model
- An application-authored three-dimensional die.
- Pixel
- One projected, illuminated vertex in a forged mesh.
- Rust
Dialect - Runtime type names used by generated Rust mesh bindings.
- Vec3
- A point, vector, or normal in the common fixed-camera universe.
- Vertex
- A model vertex carrying one physically meaningful surface normal.
Enums§
- Charge
- The three canonical bronze charges.
- Rust
Reach - Rust visibility assigned to one emitted mesh binding.
Constants§
- BRONZE_
BODY - Oxidized-bronze body charge.
- BRONZE_
GLINT - Polished-bronze highlight charge.
- BRONZE_
SHADOW - Oxidized-bronze shadow charge.
- DARK_
AMBIENT - Work-darkened metal ambient response.
- DARK_
BROAD_ SHINE - Work-darkened metal broad-reflection exponent.
- DARK_
BROAD_ WEIGHT - Work-darkened metal broad-reflection weight.
- DARK_
DIFFUSE_ WEIGHT - Work-darkened metal diffuse weight.
- DARK_
EXPOSURE - Work-darkened bronze output exposure.
- DARK_
GLINT_ SHINE - Work-darkened metal glint exponent.
- DARK_
GLINT_ WEIGHT - Work-darkened metal glint weight.
- DARK_
REFLECTION_ CELL - Largest interpolation cell admitted by the dark-bronze reflection lobe.
- DARK_
TONE_ CEILING - Work-darkened metal response ceiling.
- EYE_Z
- Fixed perspective eye above the assembly plane, in logical points.
- HALF_Y
- Down-screen component of the fixed halfway vector.
- HALF_Z
- Viewer-facing component of the fixed halfway vector.
- LIGHT_Y
- Down-screen component of the fixed distant illuminant.
- LIGHT_Z
- Viewer-facing component of the fixed distant illuminant.
- METAL_
SHINE - Ordinary bare-metal specular exponent.
- MIRROR_
SHINE - Mirror-polished metal specular exponent.
Functions§
- bronze_
rgb - Interpolate the canonical bronze charge at one illumination tone.
- compile_
with - Forge visible facets with an application-supplied material response.
- darkened_
bronze_ rgb - Apply the foundry’s oxide exposure to a bronze response.
- darkened_
lit - Illuminate work-darkened bronze.
- darkened_
lit_ with_ key - Illuminate work-darkened bronze with explicit key visibility.
- darkened_
metal_ tone - Return work-darkened material tone at one point and normal.
- darkened_
metal_ tone_ with_ key - Return work-darkened tone with explicit geometric key visibility.
- depth
- Return the painter-order depth of one facet.
- emit_
rust - Emit one mesh as static Rust data.
- emit_
rust_ as - Emit one mesh using equivalent consumer-owned runtime type names.
- forge
- Forge a die with one canonical material charge.
- lit
- Illuminate bare bronze.
- lit_
with_ key - Illuminate bare bronze with explicit key visibility.
- material_
terms - Return diffuse and Blinn-Phong reflection terms under the fixed key.
- metal_
tone - Return bare-bronze material tone at one point and normal.
- metal_
tone_ with_ key - Return bare-bronze tone with explicit geometric key visibility.
- polished_
lit - Illuminate mirror-polished ceremonial bronze.
- polished_
metal_ tone - Return mirror-polished material tone at one point and normal.
- project
- Project one foundry-space point into the assembly plane.
- shadow
- Forge the directional shadow cast onto one planar receiver.
- shadow_
source - Forge receiver-independent directional shadow coordinates.
- visible
- Return whether an oriented facet faces the fixed camera.