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

Synopsis

polyAppendVertex [flags]

Appends a new face to the selected polygonal object. The direction of the normal is given by the vertex order: the face normal points towards the user when the vertices rotate counter clockwise. Note that holes must be described in the opposite direction.
Only works with one object selected.

Return value

string The node name.

Related commands

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

Flags

constructionHistory, hole, name, point, texture, vertex

Long name (short name)[argument types]Properties
-vertex (-v) intcreatemultiuse
Adds the given vertex of the selected object to the new face.
-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
-hole (-h) 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


	polyPlane -sx 3 -sy 3;

	// add a new face
	polyAppendVertex -v 6 -v 10 -p .167 .3 -.167 -p .167 .3 .167;

	// add a new holed face
	polyAppendVertex -v 9 -v 5 -p -.167 .3 .167 -p -.167 .3 -.167 -h -p -.167 .2 .1 -p -.167 .1 0 -p -.167 .2 -.1;

	// connect the two new faces
	polyAppendVertex -v 18 -v 17 -v 16 -v 19;

	// add a new unconnected quad
	polyAppendVertex -p -.5 .5 -.5 -p .5 .5 -.5 -p .5 .5 .5 -p -.5 .5 .5;