pub fn grid_with_owner_history(
tx: &mut Transaction,
model: &Model,
global_id: &str,
placement: Option<EntityId>,
axes: (&[EntityId], &[EntityId], &[EntityId]),
predefined_type: Option<&str>,
owner_history: EntityId,
) -> Result<EntityId, GeometryError>Expand description
grid in the model’s declared release, with a caller-supplied
IfcOwnerHistory, which IFC2X3 requires on every IfcRoot.
The record is laid out by attribute name from the bound release’s
table, so an IFC2X3 grid has its 10 attributes, not IFC4’s 11.
owner_history must be in the model or staged earlier on tx, and
must be an IfcOwnerHistory; one is never invented here (build it with
ifc-author). In IFC4 and IFC4X3 the reference fills the optional
slot, and the record is otherwise the one grid writes.
§Errors
Those of grid, and: GeometryError::AuthoringSchemaUnbound for a
model that binds no single known release;
GeometryError::InvalidAuthoredValue for a predefined_type in
IFC2X3, which declares none, or outside the release’s
IfcGridTypeEnum, and on OwnerHistory for an owner_history that
does not resolve or is another entity. Nothing is staged on an error.