Go to: Return value. Related commands. Flags. Examples.

Synopsis

polyAppend [flags]

Appends a new face to the selected polygonal object. The first argument must be a border edge. The new face will be automatically closed.
Only works with one object selected.

Return value

string The node name.

Related commands

polyAppendVertex, polyExtrudeEdge, polyExtrudeFacet, polyBevel, polySplit, polySplitVertex, polyCreateFacet, polySubdivideEdge, polySubdivideFacet, polyTriangulate, polySmooth, polyChipOff

Flags

constructionHistory, edge, hole, name, point, subdivision, texture

Long name (short name)[argument types]Properties
-edge (-ed) intcreatemultiuse
Adds the given edge of the selected object to the new face. This edge must be a border, which will be then shared by the new face and the neighboring one. The new face is oriented according to the orientation of the given edge(s).
-point (-p) float float floatcreatemultiuse
Adds a new point to the new face. Coordinates of free points are given in the local object reference.
-texture (-tx) intquerycreateedit
Specifies how new faces are mapped.
0 - None; 1 - Normalize; 2 - Unitize
C: Default is 0 (no mapping).
Q: When queried, this flag returns an int
-subdivision (-s) intquerycreateedit
This flag specifies the level of subdivisions. Automatically subdivides new edges into the given number of edges. Existing edges cannot be subdivided.
C : Default is 1 (no subdivision).
Q: When queried, this flag returns an int.
-hole (-hl) createmultiuse
Add a hole. The following points and edges will define a hole.

Common flags

-name (-n) stringcreate
Gives a name to the created node.
-constructionHistory (-ch) booleanquerycreate
Turn the construction history on or off (where applicable).
Q: When queried, this flag returns an int
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command

Examples


	polyCreateFacet -p 0 0 0 -p 10 0 0 -p 10 10 0 -p 0 10 0;

	//add a new triangular facet described by the edge #0, and a free point
	polyAppend -ed 0 -p 5 -5 0;

	//add a new quadrangular facet with 2 triangular holes.
	polyAppend -ed 1 -p 20 0 0 -p 20 10 0 
		-hl -p 12 6 0 -p 14 5 0 -p 12 4 0 
		-hl -p 16 5 0 -p 18 6 0 -p 18 4 0;