Class Ifc2x3::IfcFace¶

Nested Relationships¶

This class is a nested type of Struct Ifc2x3.

Class Documentation¶

class `Ifc2x3::``IfcFace` : public Ifc2x3::IfcTopologicalRepresentationItem

Definition from ISO/CD 10303-42:1992: A face is a topological entity of dimensionality 2 corresponding to the intuitive notion of a piece of surface bounded by loops. Its domain, if present, is an oriented, connected, finite 2-manifold in Rm. A face domain shall not have handles but it may have holes, each hole bounded by a loop. The domain of the underlying geometry of the face, if present, does not contain its bounds, and 0 < Ξ < ∞. A face is represented by its bounding loops, which are defined as face bounds. A face has a topological normal n and the tangent to a loop is t. For a loop bounding a face with defined geometry, the cross product n x t points toward the interior of the face. That is, each loop runs counter-clockwise around the face when viewed from above, if we consider the normal n to point up. With each loop is associated a BOOLEAN flag to signify whether the loop direction is oriented with respect to the face normal (TRUE) or should be reversed (FALSE).

A face shall have at least one bound, and the loops shall not intersect. One loop is optionally distinguished as the outer loop of the face. If so, it establishes a preferred way of embedding the face domain in the plane, in which the other bounding loops of the face are inside the outer bound. Because the face domain is arcwise connected, no inner loop will contain any other loop. This is true regardless of which embedding in the plane is chosen.

The edges and vertices referenced by the loops of a face form a graph, of which the individual loops are the connected components. The Euler equation (1) for this graph becomes:

where Gli is the graph genus of the i th loop.

NOTE Corresponding ISO 10303 entity: face. No subtypes of face have been incorporated into this IFC Release. Please refer to ISO/IS 10303-42:1994, p. 140 for the final definition of the formal standard. The WR1 has not been incorporated, since it is always satisfied, due to the fact that only poly loops exist for face bounds.

HISTORY New class in IFC Release 1.0

Informal propositions:

No edge shall be referenced by the face more than twice.

Distinct face bounds of the face shall have no common vertices. If geometry is present, distinct loops of the same face shall not intersect.

The face shall satisfy the Euler Equation: (number of vertices) - (number of edges) - (number of loops) + (sum of genus for loops) = 0.

Subclassed by Ifc2x3::IfcFaceSurface

Public Types

typedef IfcTemplatedEntityList<IfcFace> `list`

Public Functions

IfcTemplatedEntityList<::Ifc2x3::IfcFaceBound>::ptr `Bounds`() const

Boundaries of the face.

void `setBounds`(IfcTemplatedEntityList<::Ifc2x3::IfcFaceBound>::ptr v)
const IfcParse::entity &`declaration`() const
`IfcFace`(IfcEntityInstanceData *e)
`IfcFace`(IfcTemplatedEntityList<::Ifc2x3::IfcFaceBound>::ptr v1_Bounds)

Public Static Functions

const IfcParse::entity &`Class`()