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;