Go to: Synopsis. Return value. Flags. MEL examples.
polyTransfer [-alternateObject string]
[-caching boolean] [-constructionHistory boolean]
[-name string] [-nodeState int] [-uvSets boolean] [-vertexColor boolean] [-vertices boolean]
polyTransfer is undoable, queryable, and editable.
Transfer information from one polygonal object to another one. Both
objects must have identical topology, that is same vertex, edge,
and face numbering. The flags specify which of the vertices, UV
sets or vertex colors will be copied.
| string |
representing the node name. |
In query mode, return type is based on queried flag.
alternateObject, caching, constructionHistory, name, nodeState,
uvSets, vertexColor, vertices
| Long name (short name) |
Argument types |
Properties |
-alternateObject(-ao) |
string |
   |
|
Name of the alternate object. |
|
-uvSets(-uv) |
boolean |
|
|
When true, the UV sets are copied from the alternate
object.
C: Default is "on". |
|
-vertices(-v) |
boolean |
|
|
When true, the vertices positions are copied from the alternate
object.
C: Default is "off". |
|
-vertexColor(-vc) |
boolean |
|
|
When true, the colors per vertex are copied from the alternate
object.
C: Default is "off". |
|
| Common flags |
-name(-n) |
string |
|
|
Give a name to the resulting node. |
|
-constructionHistory(-ch) |
boolean |
|
|
Turn the construction history on or off (where applicable). If
construction history is on then the corresponding node will be
inserted into the history chain for the mesh. If construction
history is off then the operation will be performed directly on the
object.
Note: If the object already has construction history then
this flag is ignored and the node will always be inserted into the
history chain. |
|
-caching(-cch) |
boolean |
|
|
Toggle caching for all attributes so that no recomputation is
needed |
|
-nodeState(-nds) |
int |
|
|
Defines how to evaluate the node.
- 0: Normal
- 1: PassThrough
- 2: Blocking
- 3: Internally disabled. Will return to Normal state when
enabled
- 4: Internally disabled. Will return to PassThrough state when
enabled
- 5: Internally disabled. Will return to Blocking state when
enabled
|
|
| 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. |
// 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;