polyTransfer

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

Synopsis

polyTransfer [-alternateObject string] [-constructionHistory boolean] [-name string] [-triangles boolean] [-uvSets boolean] [-vertexColor boolean] [-vertices boolean]

polyTransfer is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
-alternateObject(-ao)	string
Name of the alternate object. In query mode, this flag needs a value.
-uvSets(-uv)	boolean
When true, the UV sets are copied from the alternate object. C: Default is "on". In query mode, this flag needs a value.
-vertices(-v)	boolean
When true, the vertices positions are copied from the alternate object. C: Default is "off". In query mode, this flag needs a value.
-vertexColor(-vc)	boolean
When true, the colors per vertex are copied from the alternate object. C: Default is "off". In query mode, this flag needs a value.
-triangles(-t)	boolean
When true, the triangulation is copied from the alternate object. This is only useful if the node is the last operation in the obejct history. Any subsequent operation may change the triangulation. Warning: Copying the triangulation from an object to another may result in rendering artifacts for holed or concave faces. C: Default is "off". In query mode, this flag needs a value.
-name(-n)	string
Name the resulting object.
-constructionHistory(-ch)	boolean
Turn the construction history on or off (where applicable). Q: When queried, this flag returns an int. In query mode, this flag needs a value.

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

MEL examples

// Create two objects with same a cube.
polyCube -sx 5 -sy 5 -sz 5 -n plg;
polyCube -sx 5 -sy 5 -sz 5 -n atlPlg;

// Tweak the geometry of the first object
select -r plg.vtx[0:50];
move -r .1 .2 .3;

// Spherical mapping on the alternate object
polyProjection -type Spherical atlPlg.f[0:149];

// Copy the UVs from the alternate to the first object.
polyTransfer -uv 1 -ao atlPlg plg;