Skip to main content

Module geometry

Module geometry 

Source
Expand description

Geometry for the hosts (#328, #367, ADR 0021), at three levels.

  • Placements (feature placements, default): per product, the world placement as a 4x4 column-major matrix in metres and the Body representation a viewer draws, with its identifier, type and context. Kernel-free: the facade’s product_placements.
  • Graphs (feature graph, #367): per product, the Body lowered into Axiolid’s neutral geometry graph, exact, serialised in Axiolid’s versioned wire format (1.0 to 1.5) as JSON or CBOR (graph). Computes nothing; the facade’s product_graphs.
  • Meshes (feature mesh, opt-in): per product, triangles compiled by the reference backend, f32 positions relative to the product’s world placement and u32 indices. The facade’s product_meshes; it links an execution provider, which ADR 0004 keeps out of every default build. Each mesh carries its surface colour (#449): RGB and transparency, and whether the representation item, its presentation layer or its material supplied it; null when nothing colours the product, with a typed colour_refusal when its colour cannot be resolved; and its closure (#458): solid, surface (area, no volume) or unknown. product_meshes_for meshes another representation, such as Surface.
  • Polylines (feature mesh, #458): per product, the curves of a curve representation (Axis, FootPrint, an annotation’s curves), one f32 position array relative to the world placement and one ProductPolyline record per curve, with its certified chord bound (curves).

A representation is named by a host as Body (the meshes’ default), Plan (the polylines’ default: Plan, Annotation, FootPrint or Axis, preferring a PLAN_VIEW context), or one identifier: Axis, FootPrint, Annotation, Surface, Reference. Another name is refused with invalid-value.

A product that cannot be placed, selected or meshed is a record with a typed GeometryRefusal, never an error that aborts the call: one broken wall does not hide the building. The refusal codes are the shared binding codes unsupported, invalid-model, missing-reference and budget-exceeded. Without its feature an operation refuses with feature-disabled.

Modules§

curves
Polylines per product for the hosts (#458): the curves of a curve representation (Axis, FootPrint, an annotation’s curves), compiled by the reference backend. The facade’s product_curves.
graph
Geometry, Level 2 (#367, ADR 0021): each product’s Body as Axiolid’s neutral geometry graph, serialised in Axiolid’s versioned wire format.

Structs§

GeometryRefusal
Why one product has no placement, representation, graph or mesh.
ProductMesh
One product’s Body as triangles.
ProductPlacement
One product’s world placement and selected Body representation.
SelectedRepresentation
The IfcShapeRepresentation selected as a product’s Body, and its context.
SurfaceColour
The surface colour a mesh is painted with (#449).