Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.

Synopsis

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

Return value

boolean Success or Failure

Keywords

poly, clipboard, uv, color, shaders

Related

polyCylindricalProjection, polyEditUV, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection, polyUVSet, untangleUV

Flags

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

Python examples

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 )