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’sproduct_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’sproduct_graphs. - Meshes (feature
mesh, opt-in): per product, triangles compiled by the reference backend,f32positions relative to the product’s world placement andu32indices. The facade’sproduct_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;nullwhen nothing colours the product, with a typedcolour_refusalwhen its colour cannot be resolved; and itsclosure(#458):solid,surface(area, no volume) orunknown.product_meshes_formeshes another representation, such asSurface. - Polylines (feature
mesh, #458): per product, the curves of a curve representation (Axis,FootPrint, an annotation’s curves), onef32position array relative to the world placement and oneProductPolylinerecord 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’sproduct_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§
- Geometry
Refusal - Why one product has no placement, representation, graph or mesh.
- Product
Mesh - One product’s Body as triangles.
- Product
Placement - One product’s world placement and selected Body representation.
- Selected
Representation - The
IfcShapeRepresentationselected as a product’s Body, and its context. - Surface
Colour - The surface colour a mesh is painted with (#449).