VCAddPolygon3D


Version:

1.2

Description:

Add a 3D polygon to the drawing database that is not constrained to the z=0 plane.

Declaration:

 

C/C++

extern "C" void WINAPI VCAddPolygon3D(short* iError, short iSymbolIndex, Point3D* dpP, short iNumPnts);

Delphi

procedure VCAddPolygon3D(var iError: Smallint; iSymbolIndex: Smallint; var dpP: Point3D; iNumPnts: Smallint); stdcall;

ActiveX/COM

Sub AddPolygon3D(ByVal iSymbolIndex As Integer, dpP As IVCPoint3D, ByVal iNumPnts As Integer)

Parameters:

iSymbolIndex - index location for adding the entity.
-1 - NONDEFENTITY (Drawing)
-2 - HATCHFILLENTITY
>0 - Use VCGetSymbolIndex to retrieve the symbol index for creating a symbol definition.
dpP
- a array of user defined Point3D structures.
iNumPnts
- the number of points contained in the array.

Notes:

Any entity added to the Visual CADD™ drawing database or to a symbol definition will take on the current properties for line type, color, layer, and width. These properties should be set before adding the entity or they may be changed after creation with the change commands. All point locations including those within a symbol definition are relative to the drawing origin. Each entity added will be appended to the end of the database and take on the entity handle of one higher than the last entity in the drawing before the addition. Once a polygon3D is added to the drawing it contains no points and must have points added using VCSetCurrentEntityPoint3D. To add entities to a symbol definition, the index of an existing symbol is retrieved with VCGetSymbolIndex while VCCreateSymbolDef make an empty symbol definition for creating a new symbol

See Also:

VCAddPoint3D , VCAddLine3D, VCCreateSymbolDef, VCGetSymbolIndex, VCSetCurrentEntityPoint3D