Skip to main content

lower_face_surface_node

Function lower_face_surface_node 

Source
pub fn lower_face_surface_node(
    session: &mut LoweringSession<'_>,
    id: EntityId,
    frame: Transform,
) -> GeometryResult<NodeId>
Expand description

Lower one IfcFaceSurface or IfcAdvancedFace as a single-face open BRep.

IfcFaceSurface is an IfcFace, NOT an IfcSurface, in every release (IFC2X3 TC1, IFC4 ADD2 TC1 and IFC4X3 ADD2 all declare it SUBTYPE OF (IfcFace)), so the surface lowerer never sees one and it is dispatched here instead.

A face surface is a legal representation item and a member of IfcSurfaceOrFaceSurface, so a connection surface or a topology representation may name one directly rather than through a shell. It is lowered through the same face path a B-rep uses – carrier surface, SameSense, and each bound’s Orientation all compose exactly as they do inside a solid – into ONE open shell holding that face and NO solid. A face bounds no volume; closing the shell or adding a Solid would manufacture one.

Refuses anything other than the two face-surface types with crate::GeometryError::WrongEntityType (a plain IfcFace has no carrier surface and is not a member of IfcSurfaceOrFaceSurface), and a face whose only area collapses under DegenerateFacePolicy::DropAndReport with crate::GeometryError::Degenerate: nothing is left to return.