Go to: Synopsis. Return value. Keywords.
Related. Flags.
Python examples.
polyClipboard([clear=boolean], [color=boolean], [copy=boolean], [paste=boolean], [shader=boolean], [uvCoordinates=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
polyClipboard is undoable, NOT queryable, and NOT
editable.
The command allows the user to copy and paste certain polygonal
attributes to a clipboard. These attributes are: 1) Shader (shading
engine) assignment. 2) Texture coordinate (UV) assignment. 3) Color
value assignment. Any combination of attributes can be chosen for
the copy or paste operation. If the attribute has not been copied
to the clipboard, then naturally it cannot be pasted from the
clipboard. The copy option will copy the attribute assignments from
a single source polygonal dag object or polygon component. If the
source does not have the either UV or color attributes, then
nothing will be copied to the clipboard. The paste option will
paste the attribute assignments to one or more polygon components
or polygonal dag objects. If the destination does not have either
UV or color attributes, then new values will be assigned as needed.
Additionally, there is the option to clear the clipboard contents
boolean |
Success or Failure |
poly, clipboard, uv, color, shaders
polyCylindricalProjection,
polyEditUV, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection,
polyUVSet, untangleUV
clear, color,
copy, paste,
shader, uvCoordinates
Long name (short name) |
Argument types |
Properties |
shader(sh) |
boolean |
|
|
When used, will be to copy or paste shader attributes |
|
color(clr) |
boolean |
|
|
When used, will be to copy or paste color attributes |
|
uvCoordinates(uv) |
boolean |
|
|
When used, will be to copy or paste texture coordinate
attributes |
|
copy(cp) |
boolean |
|
|
When used, will mean to copy the specified attribute
argument(s). |
|
paste(ps) |
boolean |
|
|
When used, will mean to paste the specified attribute
argument(s). |
|
clear(cl) |
boolean |
|
|
When used, will mean to clear the specified attribute
argument(s). |
|
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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# Copy uv, color and shader attributes
cmds.polyClipboard( copy=True, uv=True, color=True, shader=True )
# Paste only shader attribute
cmds.polyClipboard( paste=True, shader=True )
# Copy color attribute only
cmds.polyClipboard( copy=True, color=True )
# Clear all the clipboard attributes
cmds.polyClipboard( clear=True, uv=True, color=True, shader=True )