Face Object
Description
The Face object. See the article in the overviews section.Methods
| Name | Description |
| CalculateFacets | Obtain the facetted representation for the given chord-height tolerance. |
| CalculateFacetsAndTextureMap | Obtain the facetted representation for the given chord-height tolerance. This also include the texture map coordinates. |
| CalculateFacetsWithOptions | Method that creates a new set of facets within the specified conditions. |
| CalculateStrokes | Obtain the stroked or polygonal representation for the given chord-height tolerance. |
| CalculateStrokesWithOptions | Method that creates a new set of strokes within the specified conditions. |
| GetClosestPointTo | Method that returns a point on the face that is closest to the input point. A single point is returned even if multiple equidistant points are found. To get the u-v parameters of the returned point on the face, use Face.Evaluator.GetParamAtPoint method. |
| GetExistingFacets | Obtain the facetted representation for the given chord-height tolerance as. Fails if the tolerance supplied is not pre-existing. |
| GetExistingFacetsAndTextureMap | Method that returns the specified set of existing display facets. Existing display facets are stored to single-precision floating point accuracy. This is typically adequate accuracy for display purposes. If a more accurate result is required you can use the CalculateFacets method which will calculate new facets to a given tolerance at double-precision accuracy. |
| GetExistingFacetTolerances | Method that gets the tolerances that were used to calculate the existing sets of display facets. These can be used to determine if any existing facets have been calculated within your desired accuracy. The tolerance value is also used as an index to specify which set of existing facets to retrieve when using the GetExistingFacets method. If you are using this method within Apprentice, you can use the DisplayAffinity property to optimize Apprentice for access to facets. Setting this property to True before you begin to traverse an assembly notifies Apprentice not to load any B-rep entities. |
| GetExistingStrokes | Method that returns the specified set of strokes from the SurfaceBody, Face or Edge the method was called from. Existing strokes are stored to single-precision floating point accuracy. This is typically adequate accuracy for display purposes. If a more accurate result is required you can use the CalculateStrokes method, which will calculate new strokes to a given tolerance at double-precision accuracy. If you are using this method within Apprentice, you can use the DisplayAffinity property to optimize Apprentice for access to strokes. Setting this property to True before you begin to traverse an assembly notifies Apprentice not to load any B-rep entities. |
| GetExistingStrokeTolerances | Method that gets the tolerances that were used to calculate the existing sets of display strokes. These can be used to determine if any existing strokes have been calculated within your desired accuracy. The tolerance value is also used as an index to specify which set of existing strokes to retrieve when using the GetExistingStrokes method. If you are using this method within Apprentice, you can use the DisplayAffinity property to optimize Apprentice for access to strokes. Setting this property to True before you begin to traverse an assembly notifies Apprentice not to load any B-rep entities. |
| GetReferenceKey | Method that generates and returns the reference key for this entity. |
| GetSourceFace | Method that gets the source face that has been overridden by this face. The method returns Nothing if this face is not an override. An error is returned if this method is called on a face in a part. |
| GetTextureScale | Method that returns U scale and V scale. |
Properties
| Name | Description |
| AlternateBody | Property that returns the alternate SurfaceBody. |
| Appearance | Gets and sets the current appearance of the face. |
| AppearanceSourceType | Gets and sets the source of the appearance for the face. |
| Application | Returns the top-level parent application object. When used the context of Inventor, an Application object is returned. When used in the context of Apprentice, an ApprenticeServer object is returned. |
| AttributeSets | Property that returns the AttributeSets collection object associated with this object. |
| CreatedByFeature | Property that returns the feature that resulted in the creation of this face. This property is not currently supported for FaceProxy objects and will return Nothing in those cases. It is also not currently supported for Assembly Features and will fail in that case. |
| EdgeLoops | Gets the EdgeLoops collection referenced by this Face. |
| Edges | Gets the Edges referenced by this Face. |
| Evaluator | Gets the surface evaluator for this face. |
| FaceShell | Property that returns the FaceShell object. |
| Geometry | Property that returns the underlying geometry of the face. |
| GeometryForm | Gets the form of the underlying geometry as a combination of one or more CurveGeometryFormEnum values. |
| HasReferenceComponent | Property that specifies if the object was created as the result of a derived part. |
| InternalName | Property that returns a unique string identifying this face. This identifier is valid only so long as there are no further modifications to the face. |
| IsParamReversed | Gets whether the parameterization of the geometry obtained from the Geometry property is aligned or opposed to the topological sense of this Face. |
| Parent | Property that returns the parent object from whom this object can logically be reached. |
| PointOnFace | Property that returns a characteristic somewhere on the interior of the Face. |
| ReferenceComponent | Property that returns the ReferenceComponent that resulted in the creation of this feature. |
| ReferencedEntity | Property that returns the referenced face(s) from the source part. This could be a proxy object in case of a derived assembly. The property returns Nothing if there isn't a referenced entity. |
| SurfaceBody | Property that returns the associated with this object or feature. |
| SurfaceType | Property that returns a SurfaceTypeEnum that specifies the surface type for this Face. |
| TangentiallyConnectedFaces | Property that returns a FaceCollection that contains the input face and all tangentially connected faces. The CollectionType of the output FaceCollection is set to kFaceTangentiallyConnected. |
| TextureMaps | Gets the texture maps associated with this face. |
| ThreadInfos | Property that returns a ThreadInfo object for each thread affecting this face. |
| TransientKey | Property that obtains an ID key that can be used to bind back to the live object. This transient key is only valid as long as the document state has not changed. For more information, see the ReferenceKeys overview. |
| Type | Returns an ObjectTypeEnum indicating this object's type. |
| Vertices | Gets the vertices for this Face. |
Accessed From
ASideDefinition.ASideFace, ChamferDefinition.Face, DecalFeature.Face, DecalFeatureProxy.Face, DistanceAndAngleChamferDef.Face, EdgeLoop.Face, EdgeLoopProxy.Face, EmbossFeature.WrapFace, EmbossFeatureProxy.WrapFace, Face.GetSourceFace, FaceProxy.GetSourceFace, FaceProxy.NativeObject, Faces.Item, FlatPattern.BaseFace, FlatPattern.BottomFace, FlatPattern.TopFace, LineAndFaceWorkPointDef.Face, LineAndFaceWorkPointDef.GetData, LineAndTangentWorkPlaneDef.Face, LineAndTangentWorkPlaneDef.GetData, LoftFeature.EndFace, LoftFeature.StartFace, LoftFeatureProxy.EndFace, LoftFeatureProxy.StartFace, MeshFace.Face, MeshFaceProxy.Face, MidSurfaceThickness.GetSourceFace, PlaneAndTangentWorkPlaneDef.Face, PlaneAndTangentWorkPlaneDef.GetData, PointAndTangentWorkPlaneDef.Face, PointAndTangentWorkPlaneDef.GetData, PublicationMeshFace.Face, RefoldFeature.StationaryFace, RefoldFeatureProxy.StationaryFace, RevolvedFaceWorkAxisDef.Face, RipDefinition.RipFace, RuledSurfaceEdgeFacePair.GetData, SphereCenterPointWorkPointDef.Face, SurfaceGraphicsFace.Face, TorusCenterPointWorkPointDef.Face, TorusMidPlaneWorkPlaneDef.Face, TwoDistancesChamferDef.Face, UnfoldFeature.StationaryFace, UnfoldFeatureProxy.StationaryFaceDerived Classes
FaceProxySamples
| Name | Description |
| Delete Face, Boundary Patch and Stitch features | Demonstrates creating Face, Boundary Patch and Stitch features. |
| Add a decal feature | This sample demonstrates the creation of a decal feature. |
| Create and Edit an Extrude Feature with a pocket | This sample demonstrates how to edit an extrude feature. It shows how to create a sketch plane at a specified orientation to existing geometry. |
| Sketch from Face Silhouette | This sample creates a cylindrical solid, creates a new sketch plane and creates some new sketch lines from the actual edges and the apparent (silhouette) edges of the cylinder. |
| Sketch Edit Orientation | This sample demonstrates modifying the orientation of a sketch. |
| Sketch Add | This sample demonstrates the creation of a sketch using the Sketches.Add method. |
| Sketch Add Oriented | This sample demonstrates the creation of a sketch using the Sketches.AddWithOrientation method. |
| Add a punch tool feature | This program demonstrates the creation of a punch tool feature. It uses one of the punch features that's delivered with Inventor. It assumes you already have an existing sheet metal part and have selected a face to place the punch feature on. The selected face should be large so there is room for the punch features. |
| Create sheet metal rip feature | This sample demonstrates the creation of a rip sheet metal feature. |
| Create sheet metal face and cut features | This sample demonstrates the creation of sheet metal face and cut features. |
| Create sheet metal face and flange features | This sample demonstrates the creation of sheet metal face and flange features. |
| Thread Feature Create | This sample demonstrates the creation of a thread feature. It creates a cylinder in a new part document and creates a thread feature on the cylinder. |