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


polyDuplicateAndConnect( object , [removeOriginalFromShaders=boolean], [renameChildren=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyDuplicateAndConnect is undoable, NOT queryable, and NOT editable.

This command duplicates the input polygonal object, connects up the outMesh attribute of the original polygonal shape to the inMesh attribute of the newly created duplicate shape and copies over the shader assignments from the original shape to the new duplicated shape.

The command will fail if no objects are selected or sent as argument or if the object sent as argument is not a polygonal object.

Return value



removeOriginalFromShaders, renameChildren
Long name (short name) Argument types Properties
removeOriginalFromShaders(ros) boolean create
Used to specify if the original object should be removed from the shaders (shadingGroups) that it is a member of. The shader associations will get transferred to the duplicated object, before they are removed from the original. If this flag is specified then the original polygonal object will be drawn in wireframe mode even if all objects are being drawn in shaded mode.
renameChildren(rc) boolean create
rename the children nodes of the hierarchy, to make them unique.

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

cmds.polyDuplicateAndConnect( 'pPlane1' )