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

Synopsis

applyAttrPattern([nodeType=string], [patternName=string])

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

applyAttrPattern is undoable, NOT queryable, and NOT editable.

Take the attribute structure described by a pre-defined pattern and apply it either to a node (as dynamic attributes) or a node type (as extension attributes). The same pattern can be applied more than once to different nodes or node types as the operation duplicates the attribute structure described by the pattern. See the 'createAttrPatterns' command for a description of how to create a pattern.

Return value

int Number of nodes or node types to which the attribute were added

Keywords

attribute, pattern

Related

addAttr, addExtension, createAttrPatterns, deleteAttrPattern, listAttrPatterns

Flags

nodeType, patternName
Long name (short name) Argument types Properties
patternName(pn) string create
The name of the pattern to apply. The pattern with this name must have been previously created using the createAttrPatterns command.
nodeType(nt) string create
Name of the node type to which the attribute pattern is to be applied. This flag will cause a new extension attribute tree to be created, making the new attributes available on all nodes of the given type. If it is not specified then either a node name must be specified or a node must be selected for application of dynamic 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.

Python examples

import maya.cmds as cmds

import maya.cmds as cmds
cmds.polySphere( name="sphere1" )
cmds.applyAttrPattern( patternName="myXMLPattern" )
// Result: 1 //
name2 = cmds.polySphere( name="sphere2" )
name3 = cmds.polySphere( name="sphere3" )
cmds.select( [name2, name3] )
cmds.applyAttrPattern( patternName="myXMLPattern" )
// Result: 2 //
cmds.applyAttrPattern( patternName="myXMLPattern", nodeType="transform" )
// Result: 1 //