Expand description
Connection-surface lowering: the surface where two elements meet.
§Why a helper and not a representation item
IfcConnectionSurfaceGeometry is not a representation item. It is what
IfcRelSpaceBoundary.ConnectionGeometry and the element-connection
relationships point at, and its payload is an IfcSurfaceOrFaceSurface:
a bare IfcSurface, an IfcFaceSurface (or its IfcAdvancedFace
subtype), or an IfcFaceBasedSurfaceModel. The select is resolved here so
a consumer measuring space-boundary coverage does not re-derive it, and
each member goes through the lowerer that already owns its family.
§Two ends, two coordinate systems
SurfaceOnRelatingElement is given in the relating element’s local
coordinate system, the optional SurfaceOnRelatedElement in the related
element’s (IFC4 ADD2 TC1, IfcConnectionSurfaceGeometry attribute
definitions). One frame cannot place both, so each end has its own entry
point and the caller passes the placement of the element that end belongs
to. For a space boundary that is the space’s placement.
§Only surfaces
The point, curve, volume and (IFC2X3) port connection kinds are legal
connection geometry but carry no surface. They are refused with a typed
crate::GeometryError::Unsupported naming the connection, never
substituted by a degenerate or bounding surface. Anything that is not a
connection geometry at all is a wrong-type error.
Slots are identical in IFC2X3 TC1, IFC4 ADD2 TC1 and IFC4X3 ADD2:
IfcConnectionGeometry declares no attributes, so
SurfaceOnRelatingElement is 0 and SurfaceOnRelatedElement is 1
(data/absolute-slots.txt).
Functions§
- lower_
connection_ surface - Lower
SurfaceOnRelatingElementof anIfcConnectionSurfaceGeometry. - lower_
related_ connection_ surface - Lower the optional
SurfaceOnRelatedElementof anIfcConnectionSurfaceGeometry.