Skip to main content

Module graph

Module graph 

Source
Expand description

Geometry, Level 2 (#367, ADR 0021): each product’s Body as Axiolid’s neutral geometry graph, serialised in Axiolid’s versioned wire format.

The payload is the envelope Axiolid defines (axiolid/kernel#267, Axiolid ADR 0085), JSON text or CBOR bytes:

{"format":"axiolid-geometry-graph","version":"1.0","graph":{"nodes":[...],"roots":[...]}}

Nodes are in insertion order and a reference is the index of an earlier node; the graph is in world coordinates, metres, with the product’s placement already applied. A host evaluates it with its own kernel, or reads it back with GeometryGraph::from_json / from_cbor in Rust. The envelope’s version is the lowest wire format version its content needs: 1.0 unless a station in it carries a seam-snapping window (#423; a station on an offset whose length is a quadrature), then 1.1, or a run’s sections do (#429; a sectioned solid or surface along such an offset), then 1.2, or an offset run continues to a basis end the kernel measures (#433; an IfcOffsetCurveByDistances along such an offset), then 1.3, or a polygonal bounded half-space clips (#515; an IfcPolygonalBoundedHalfSpace, bounded along its Position’s Z), then 1.4 (axiolid/kernel#297, #301, #303, #321). A reader on axiolid-model 0.3.8 or older reads a 1.0 payload and refuses a 1.1 one; a reader on 0.3.10 or older refuses a 1.2 one, one on 0.3.11 or older a 1.3 one, and one on 0.3.13 or older a 1.4 one. GEOMETRY_FORMAT_VERSION is the newest version this build writes. A minor version of the wire format reaches every binding as a minor release, a major one is a breaking change of every binding (ADR 0021).

Structs§

ProductGeometry
One product’s Body as a serialised neutral geometry graph.

Enums§

GeometryEncoding
How IfcModel::product_geometry encodes each graph.

Constants§

GEOMETRY_FORMAT
The wire format’s name, the envelope’s format entry.
GEOMETRY_FORMAT_VERSION
The newest wire format version this build writes, MAJOR.MINOR. A payload’s envelope carries the lowest version its content needs, so its version entry is this or an older minor of the same major (module documentation).