AcadDFace Object

The Acad3DFace object represents a 3-D triangle or a quadrilateral plane section. You create it using the Add3DFace method of the AcadBlock, AcadModelSpace, or AcadPaperSpace object. You can specify different Z coordinates for each corner point of a Acad3DFace object, and you can build solid objects by joining 3-D faces together (e.g., a cube consists of six 3-D faces joined together). You control which edges of the face are visible through the SetInvisibleEdge method, which allows accurate modeling of objects with holes.

Acad3DFace Object Methods

The Acad3DFace object inherits all the methods of the AcadEntity and AcadObject objects. It also supports the following methods.

Name_Returns Description_

GetInvisibleEdge Boolean Gets the visibility setting for an edge of a Acad3DFace object at a given index. It's True if the edge is invisible and False otherwise. Parameter: Index As Integer.

SetInvisibleEdge Sets the visibility state of an edge at a given index. To see any changes in visibility, the drawing must be regenerated. Parameters: Index As Integer and State As Boolean. The Index parameter must be in the range 0 to 3. Set the State parameter to True for an invisible edge and False otherwise.

Acad3DFace Object Properties

The Acad3DFace object inherits all the properties of the AcadEntity and AcadObject objects, as well as the common Application property. It also supports the following properties.

Name

Returns

Description

Coordinate

Variant

Gets or sets the coordinate of a single vertex in the object. This will replace the specified vertex of the object. Use standard array-handling techniques to process the values contained in this property. It returns a three-element array of Doubles containing 3-D coordinates in WCS. Note that the Z coordinate will default to 0 on the active UCS. Parameter: Index As Integer (the index in the zero-based array of vertices for the vertex you want to set or query).

Coordinates

Variant

Gets or sets the coordinates for each vertex in the object. This will replace any existing coordinates for the specified object. Use standard array-handling techniques to process the coordinates contained in this property. Note that you can't change the number of coordinates in the object by using this property; you can change only the location of existing coordinates. It returns a three-element array of Doubles containing 3-D coordinates in WCS. Note also that he Z coordinate will always default to 0 on the active UCS.

VisibilityEdge1

Boolean

Gets or sets whether edge 1 is visible. For this property and the three that follow, True means the edge is visible and False means the edge isn't visible.

VisibilityEdge2

Boolean

Gets or sets whether edge 2 is visible.

VisibilityEdge3

Boolean

Gets or sets whether edge 3 is visible.

VisibilityEdge4

Boolean

Gets or sets whether edge 4 is visible. In the case of a triangle, this property will still return a value, because a triangle is defined as a quadrilateral in which point 3 is equal to point 4.

Note Because this object inherits from AcadObject, it supports the Modified event.

0 0

Post a comment