Go to: Synopsis. Flags. Return value. Related. MEL examples.

Synopsis

polyPoke [-constructionHistory boolean] [-localTranslate linear linear linear] [-localTranslateX linear] [-localTranslateY linear] [-localTranslateZ linear] [-name string] [-translate linear linear linear] [-translateX linear] [-translateY linear] [-translateZ linear] [-worldSpace boolean] face selection

polyPoke is undoable, queryable, and editable.

Introduces a new vertex in the middle of the selected face, and connects it to the rest of the vertices of the face.

Flags

constructionHistory, localTranslate, localTranslateX, localTranslateY, localTranslateZ, name, translate, translateX, translateY, translateZ, worldSpace
Long name (short name) [argument types] Properties
-name(-n) string create
Name the resulting object.
-constructionHistory(-ch) boolean create
Turn the construction history on or off (where applicable).
-localTranslate(-lt) linear linear linear create
translate the new vertex in the local face coordinate.
-localTranslateX(-ltx) linear create
translate the new vertex in the local face coordinate along X.
-localTranslateY(-lty) linear create
translate the new vertex in the local face coordinate along Y.
-localTranslateZ(-ltz) linear create
translate the new vertex in the local face coordinate along Z.
-translate(-t) linear linear linear create
translate the new vertex in the world space.
-translateX(-tx) linear create
translate the new vertex in the world space along X.
-translateY(-ty) linear create
translate the new vertex in the world space along Y.
-translateZ(-tz) linear create
translate the new vertex in the world space along Z.
-worldSpace(-ws) boolean create
This flag specifies if the operation has to be performed in the world space or not.

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

Return value


string (The node name)

Related

polySubdivideFacet

MEL examples

// To poke all the faces of a polyCube...
//
polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 1 0 -tx 1 -ch 1 -n pCube;
polyPoke -ch 1 pCube.f[0:5];

// To poke all the faces of a polyCube, and pull the
// new vertices by one unit along the face normal
//
polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 1 0 -tx 1 -ch 1 -n pCubePull;
polyPoke -ltx 0 -lty 0 -ltz 1 -ch 1 pCubePull.f[0:5];