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.
None
removeOriginalFromShaders, renameChildren
| Long name (short name) |
Argument types |
Properties |
|
removeOriginalFromShaders(ros)
|
boolean
|
|
|
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
|
|
|
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.
|
import maya.cmds as cmds
cmds.polyDuplicateAndConnect( 'pPlane1' )