Face

Public Class

A bounded face of a 3d solid or open shell.

Inheritance Hierarchy

System.Object
Autodesk.Revit.DB.APIObject
Autodesk.Revit.DB.GeometryObject
Autodesk.Revit.DB.Face

Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public class Face : GeometryObject

The Face type exposes the following members.

Properties

Name

Description

Public Property
Area

The area of this face.

Public Property

EdgeLoops

A collection of edge loops. Each edge loop represents one of the closed boundaries of the face.

Public Property
Code Example
GraphicsStyleId

The ElementId of the GeometryObject’s GraphicsStyle
(Inherited from GeometryObject)

Public Property
HasRegions

Identifies if the face contains regions (which can be created, for example, by the Split Face command).

Public Property
Id

A unique integer identifying the GeometryObject in its associated non view-specific GeometryElement.
(Inherited from GeometryObject)

Public Property

IsCyclic

Indicates whether the underlying surface is periodic in the specified parametric direction.

Public Property

IsElementGeometry

Indicates whether this geometry is obtained directly from an Element.
(Inherited from GeometryObject)

Public Property
Code Example

IsReadOnly

Identifies if the object is read-only or modifiable.
(Inherited from APIObject)

Public Property

IsTwoSided

Determines if a face is two-sided (degenerate).

Public Property

MaterialElementId

The element ID of the material from which this face is composed.

Public Property
OrientationMatchesSurfaceOrientation

Returns true if this face’s orientation matches the orientation of the face’s surface, false if they have opposite orientations.

Public Property

Period

The period of the underlying surface in the specified parametric direction.

Public Property

Reference

Returns a stable reference to the face.

Public Property
Visibility

The visibility.
(Inherited from GeometryObject)

Methods

Name

Description

Public Method
ComputeDerivatives

Returns the first partial derivatives of the underlying surface at the specified point.

Public Method
ComputeNormal

Returns the normal vector for the face at the given point.

Public Method
ComputeSecondDerivatives

Returns the second partial derivatives of the face at the specified point.

Public Method
Dispose

Causes the object to release immediately any resources it may be utilizing.
(Inherited from APIObject)

Public Method
Equals

Determines whether the specified Object is equal to the current Object.
(Inherited from GeometryObject)

Public Method
Evaluate

Evaluates and returns the XYZ coordinates of a point at the indicated UV parameterization of the face.

Public Method

GetBoundingBox

Returns the UV bounding box of the face.

Public Method
GetEdgesAsCurveLoops

Returns a list of closed curve loops that correspond to the edge loops of the face. Curves in each curve loop correspond to individual edges.

Public Method

GetHashCode

Gets the integer value of the geometry object as hash code
(Inherited from GeometryObject)

Public Method
GetRegions

Gets the face regions (created, for example, by the Split Face command) of the face.

Public Method

GetSurface

Returns a copy of this face’s surface.

Public Method

GetType

Gets the Type of the current instance.
(Inherited from Object)

Public Method

Intersect(Curve)

Calculates the intersection of the specified curve with this face.

Public Method
Intersect(Face)

Calculates the intersection of the specified face with this face and returns the intersection results.

Public Method
Intersect(Curve, IntersectionResultArray.)

Calculates the intersection of the specified curve with this face and returns the intersection results.

Public Method
Intersect(Face, Curve.)

Calculates the intersection of the specified face with this face and returns the intersection results.

Public Method

IsInside(UV)

Indicates whether the specified point is within this face.

Public Method
IsInside(UV, IntersectionResult.)

Indicates whether the specified point is within this face and outputs additional information about the point location.

Public Method
Project

Projects the specified point on the face.

Public Method

ToString

Returns a string that represents the current object.
(Inherited from Object)

Public Method
Code Example
Triangulate.

Returns a triangular mesh approximation to the face.

Public Method

Triangulate(Double)

Returns a triangular mesh approximation to the face.

Remarks

Faces are defined by surfaces ( Surface) bounded by edge loops. The surfaces provide natural UV parameterization to the faces.

Inheritance Hierarchy

System.Object
Autodesk.Revit.DB.APIObject
Autodesk.Revit.DB.GeometryObject
Autodesk.Revit.DB.Face
Autodesk.Revit.DB.ConicalFace
Autodesk.Revit.DB.CylindricalFace
Autodesk.Revit.DB.HermiteFace
Autodesk.Revit.DB.PlanarFace
Autodesk.Revit.DB.RevolvedFace
Autodesk.Revit.DB.RuledFace