polyCollapseTweaks

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

Synopsis

polyCollapseTweaks [-hasVertexTweaks]

polyCollapseTweaks is undoable, queryable, and NOT editable.

This command is only useful in cases where no construction history is associated with the shape node.

If a mesh name is not specified as input, a singly selected mesh (if any) will have its tweaked vertices baked.

Return value

None

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-hasVertexTweaks(-hvt)
Determines whether an individual mesh has vertex tweaks.

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.

MEL examples

// Create a plane.
polyPlane -sx 10 -sy 10 -h 20 -w 20 -ch 0;

// Query the existence of vertex tweaks for pPlane1
polyCollapseTweaks -q -hvt "pPlane1";
// Result: 0

// Move a vertex.
select -r "pPlane1.vtx[8]";
move -r 10 20 30;

// Query vertex tweaks for vertex id 8
getAttr "pPlane1.vtx[8]";
// Result: 10 20 30

// Query the existence of vertex tweaks for pPlane1
polyCollapseTweaks -q -hvt "pPlane1";
// Result: 1

// Bake all vertex tweaks into their respective vertices.
polyCollapseTweaks "pPlane1";

// Query vertex tweaks for vertex id 8
getAttr "pPlane1.vtx[8]";
// Result: 0 0 0

// Query the existence of vertex tweaks for pPlane1
polyCollapseTweaks -q -hvt "pPlane1";
// Result: 0