pub fn connect_with_realizing_elements(
tx: &mut Transaction,
model: &Model,
global_id: &str,
relating: EntityId,
related: EntityId,
realizing: &[EntityId],
) -> SpatialAuthoringResult<EntityId>Expand description
Stage an IfcRelConnectsWithRealizingElements.
The realizing elements are what physically make the connection – a weld, a bolt, a bracket.
Bound to the model’s declared release (#213): the record is laid out by
attribute name with the release’s nine attributes (ConnectionGeometry
and ConnectionType unset). OwnerHistory is left $, which IFC4 and
IFC4X3 allow and IFC2X3 does not; in IFC2X3 use
connect_with_realizing_elements_with_owner_history.
§Errors
Refuses a malformed GlobalId, an element connected to itself,
and an empty realizing set: the subtype exists precisely to name
those elements, so omitting them makes it an
IfcRelConnectsElements wearing the wrong type name. A header binding
no single verified release (MultipleSchemas, UnsupportedSchema) and
an IFC2X3 model (AuthoringRequired) are refused. Nothing is staged on
an error.