Skip to main content

grid_with_owner_history

Function grid_with_owner_history 

Source
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.