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 |
clear(cl)
|
boolean
|
|
|
When used, will mean to clear the specified attribute argument(s).
|
|
color(clr)
|
boolean
|
|
|
When used, will be to copy or paste color 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).
|
|
shader(sh)
|
boolean
|
|
|
When used, will be to copy or paste shader attributes
|
|
uvCoordinates(uv)
|
boolean
|
|
|
When used, will be to copy or paste texture coordinate attributes
|
|
|
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 )