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

Synopsis

polyCreateFacet [flags]

Create a new polygonal object with the specified face, which will be closed. List of arguments must have at least 3 points.

Return value

string string Object name and node name.

Related commands

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

Flags

constructionHistory, hole, name, point, subdivision, texture

Long name (short name)[argument types]Properties
-point (-p) float float floatcreatemultiuse
Adds a new point to the face. Coordinates of points are given in world reference.
-texture (-tx) intquerycreateedit
Specifies how the face is 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 subdivision. Subdivides edges into the given number of edges.
C: Default is 1 (no subdivision).
Q: When queried, this flag returns an int.
-hole (-hl) createmultiuse
Add a hole. The following points will define a hole. Holes can be defined either clockwise or counterclockwise.

Common flags

-name (-n) stringcreate
Name the resulting object.
-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


	// Create a triangular facet
	polyCreateFacet -p 0.0 0.0 0.0 -p 10.0 0.0 0.0 -p 10.0 10.0 0.0;

	// Create a quadrangular facet with two triangular holes inside
	polyCreateFacet -p 0 0 0 -p 10 0 0 -p 10 10 0 -p 0 10 0
		-hl -p 4 2 0 -p 5 4 0 -p 6 2 0 -hl -p 5 6 0 -p 4 8 0 -p 6 8 0;
	move -r 0 0 10;