Contains general node and attribute functions, as well as the main PyNode base class.
For the rest of the class hierarchy, including DependNode, Transform, and Attribute, see pymel.core.nodetypes.
Functions
| about | This command displays version information about the application if it is executed without flags. | ||
| addAttr | This command is used to add a dynamic attribute to a node or nodes. | ||
| addExtension | This command is used to add an extension attribute to a node type. | ||
| affectedNet | This command gets the list of attributes on a node or node type and creates nodes of type TdnAffect, one for each | ||
| affects | This command returns the list of attributes on a node or node type which affect the named attribute. | ||
| aliasAttr | Allows aliases (alternate names) to be defined for any attribute of a specified node. | ||
| align | Align or spread objects along X Y and Z axis. | ||
| applyAttrPattern | 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). | ||
| artAttrTool | The artAttrTool command manages the list of tool types which are used for attribute painting. This command supports | ||
| assignCommand | This command allows the user to assign hotkeys and manipulate the internal array of named command objects. | ||
| attributeInfo | This command lists all of the attributes that are marked with certain flags. | ||
| attributeName | This command takes one “node.attribute”-style specifier on the command line and returns either the attribute’s long, short, or nice name. | ||
| attributeQuery | attributeQuery returns information about the configuration of an attribute. It handles both boolean flags, returning | ||
| bakePartialHistory | This command is used to bake sections of the construction history of a shape node when possible. | ||
| baseTemplate | This is the class for the commands that edit and/or query templates. | ||
| baseView | A view defines the layout information for the attributes of a particular node type or container. | ||
| color | This command sets the dormant wireframe color of the specified objects to be their class color or if the -ud/userDefined | ||
| colorIndex | The index specifies a color index in the color palette. | ||
| commandEcho | This command controls what is echoed to the command window. | ||
| commandPort | Opens or closes the Maya command port. The command port comprises a socket to which a client program may connect. An | ||
| condition | This command creates a new named condition object whose true/false value is calculated by running a mel script. | ||
| connectAttr | Connect the attributes of two dependency nodes and return the names of the two connected attributes. | ||
| connectionInfo | The connectionInfocommand is used to get information about connection sources and destinations. Unlike the isConnected | ||
| container | This command can be used to create and query container nodes. | ||
| containerBind | This is an accessory command to the container command which is used for some automated binding operations on the container. | ||
| containerProxy | Creates a new container with the same published interface, dynamic attributes and attribute values as the specified container but with fewer container members. | ||
| containerPublish | This is an accessory command to the container command which is used for some advanced publishing operations on the container. | ||
| containerTemplate | A container template is a description of a container’s published interface. | ||
| containerView | A container view defines the layout information for the published attributes of a particular container. | ||
| contextInfo | This command allows you to get information on named contexts. | ||
| copyAttr | Given two nodes, transfer the connections and/or the values from the first node to the second for all attributes whose names and data types match. | ||
| createAttrPatterns | Create a new instance of an attribute pattern given a pattern type (e.g. | ||
| createDisplayLayer | Create a new display layer. | ||
| createNode | This command creates a new node in the dependency graph of the specified type. | ||
| currentUnit | This command allows you to change the units in which you will work in Maya. There are three types of units: linear, | ||
| curveRGBColor | This command creates, changes or removes custom curve colors, which are used to draw the curves in the Graph Editor. The | ||
| cycleCheck | This command searches for plug cycles in the dependency graph. | ||
| delete | This command is used to delete selected objects, or all objects, or objects specified along with the command. | ||
| deleteAttr | This command is used to delete a dynamic attribute from a node or nodes. | ||
| deleteAttrPattern | After a while the list of attribute patterns could become cluttered. | ||
| deleteExtension | This command is used to delete an extension attribute from a node type. | ||
| disconnectAttr | Disconnects two connected attributes. | ||
| displayAffected | Turns on/off the special coloring of objects that are affected by the objects that are currently in the selection list. | ||
| displayColor | This command changes or queries the display color for anything in the application that allows the user to set its color. | ||
| displayCull | This command is responsible for setting the display culling property of back faces of surfaces. | ||
| displayLevelOfDetail | This command is responsible for setting the display level-of-detail for edit refreshes. | ||
| displayPref | This command sets/queries the state of global display parameters. | ||
| displayRGBColor | This command changes or queries the display color for anything in the application that allows the user to set its color. | ||
| displaySmoothness | This command is responsible for setting the display smoothness of NURBS curves and surfaces to either predefined or | ||
| displayStats | Flags: | ||
| displaySurface | This command toggles display options on the specified or active surfaces. | ||
| distanceDimension | This command is used to create a distance dimension to display the distance between two specified points. | ||
| duplicate | This command duplicates the given objects. | ||
| editDisplayLayerGlobals | Edit the parameter values common to all display layers. | ||
| editDisplayLayerMembers | This command is used to query and edit membership of display layers. | ||
| encodeString | This action will take a string and encode any character that would need to be escaped before being sent to some other command. | ||
| evalDeferred | This command takes the string it is given and evaluates it during the next available idle time. | ||
| exactWorldBoundingBox | This command figures out an exact-fit bounding box for the specified objects (or selected objects if none are specified) | ||
| format | This command takes a format string, where the format string contains format specifiers. | ||
| getAttr | This command returns the value of the named object’s attribute. | ||
| getClassification | Returns the classification string for a given node type. | ||
| getEnums |
|
||
| group | This command groups the specified objects under a new group and returns the name of the new group. | ||
| hasAttr | convenience function for determining if an object has an attribute. | ||
| hide | The hidecommand is used to make objects invisible. | ||
| hilite | Hilites/Unhilites the specifed object(s). Hiliting an object makes it possible to select the components of the object. | ||
| inheritTransform | This command toggles the inherit state of an object. | ||
| instance | Instancing is a way of making the same object appear twice in the scene. | ||
| instanceable | Flags one or more DAG nodes so that they can (or cannot) be instanced. This command sets an internal state on the | ||
| instancer | This command is used to create a instancer node and set the proper attributes in the node. | ||
| isConnected | The isConnectedcommand is used to check if two plugs are connected in the dependency graph. The return value is falseif | ||
| isDirty | The isDirtycommand is used to check if a plug is dirty. The return value is 0 if it is not and 1 if it is. If more than | ||
| isTrue | This commmand returns the state of the named condition. | ||
| isolateSelect | This command turns on/off isolate select mode in a specified modeling view, specified as the argument. | ||
| itemFilter | This command creates a named itemFilter object. This object can be attached to selectionConnection objects, or to | ||
| itemFilterAttr | This command creates a named itemFilterAttr object. This object can be attached to editors, in order to filter the | ||
| itemFilterRender | This command creates a named renderTypeFilter object. This object can be attached to selectionConnection objects, or to | ||
| itemFilterType | This command queries a named itemFilter object. This object can be attached to selectionConnection objects, or to | ||
| license | This command displays version information about the application if it is executed without flags. | ||
| listAttr | This command lists the attributes of a node. | ||
| listAttrPatterns | Attribute patterns are plain text descriptions of an entire Maya attribute forest. (“forest” because there could be an | ||
| listConnections | This command returns a list of all attributes/objects of a specified type that are connected to the given object(s). | ||
| listFuture | Modifications: | ||
| listHistory | This command traverses backwards or forwards in the graph from the specified node and returns all of the nodes whose construction history it passes through. | ||
| listNodeTypes | Lists dependency node types satisfying a specified classification string. | ||
| listRelatives | This command lists parents and children of DAG objects. The flags -c/children, -ad/allDescendents, -s/shapes, -p/parent | ||
| listSets | The listSets command is used to get a list of all the sets an object belongs to. To get sets of a specific type for an | ||
| listTransforms | Modifications: | ||
| lockNode | Locks or unlocks one or more dependency nodes. | ||
| ls | The lscommand returns the names (and optionally the type names) of objects in the scene. | ||
| makeIdentity | The makeIdentity command is a quick way to reset the selected transform and all of its children down to the shape level | ||
| makeLive | This commmand makes an object live. | ||
| makePaintable | Make attributes of nodes paintable to Attribute Paint Tool. This command is used to register new attributes to the | ||
| move | The move command is used to change the positions of geometric objects. | ||
| nodeCast | Given two nodes, a source node of type A and a target node of type B, where type A is either type B or a sub-type of B, | ||
| nodeType | This command returns a string which identifies the given node’s type. | ||
| objExists | This command simply returns true or false depending on whether an object with the given name exists. | ||
| objectCenter | This command returns the coordinates of the center of the bounding box of the specified object. | ||
| objectType | This command returns the type of elements. | ||
| paramDimension | This command is used to create a param dimension to display the parameter value of a curve/surface at a specified point on the curve/surface. | ||
| paramLocator | The command creates a locator in the underworld of a NURBS curve or NURBS surface at the specified parameter value. If | ||
| parent | This command parents (moves) objects under a new group, removes objects from an existing group, or adds/removes parents. | ||
| partition | This command is used to create, query or add/remove sets to a partition. | ||
| pause | Pause for a specified number of seconds for canned demos or for test scripts to allow user to view results. | ||
| performanceOptions | Sets the global performance options for the application. | ||
| pickWalk | The pickWalk command allows you to quickly change the selection list relative to the nodes that are currently selected. | ||
| pixelMove | The pixelMove command moves objects by what appears as pixel units based on the current view. It takes two integer | ||
| polySplitCtx2 | Create a new context to split facets on polygonal objects In query mode, return type is based on queried flag. | ||
| refresh | This command is used to force a redraw during script execution. | ||
| relationship | This is primarily for use with file IO. Rather than write out the specific attributes/connections required to maintain a | ||
| removeMultiInstance | Removes a particular instance of a multiElement. This is only useful for input attributes since outputs will get | ||
| rename | Renames the given object to have the new name. | ||
| renameAttr | Renames the given user-defined attribute to the name given in the string argument. | ||
| reorder | This command reorders (moves) objects relative to their siblings. | ||
| reorderContainer | This command reorders (moves) objects relative to their siblings in a container. | ||
| resetTool | This command resets a tool back to its “factory settings” | ||
| rotate | The rotate command is used to change the rotation of geometric objects. | ||
| saveToolSettings | This command causes all the tools not on the shelf to save their settings as optionVars. This is called automatically by | ||
| scale | The scale command is used to change the sizes of geometric objects. | ||
| scaleComponents | This is a limited version of the scale command. | ||
| select | This command is used to put objects onto or off of the active list. | ||
| selectKey | This command operates on a keyset. | ||
| selectMode | The selectModecommand is used to change the selection mode. Object, component, root, leaf and template modes are | ||
| selectPref | This command controls state variables used to selection UI behavior. | ||
| selectPriority | The selectPrioritycommand is used to change the selection priority of particular types of objects that can be selected | ||
| selectType | The selectTypecommand is used to change the set of allowable types of objects that can be selected when using the select | ||
| selected | ls -sl | ||
| selectedNodes | Flags: | ||
| selectionConnection | This command creates a named selectionConnection object. This object is simply a shared selection list. It may be used | ||
| setAttr | Sets the value of a dependency node attribute. | ||
| setEnums | |||
| setToolTo | This command switches control to the named context. | ||
| sets | This command is used to create a set, query some state of a set, or perform operations to update the membership of a set. | ||
| shapeCompare | Compares two shapes. | ||
| showHidden | The showHiddencommand is used to make invisible objects visible. If no flags are specified, only the objects given to | ||
| snapMode | The snapMode command is used to control snapping. It toggles the snapping modes in effect and sets information used for | ||
| softSelect | This command allows you to change the soft modelling options. | ||
| spaceLocator | The command creates a locator at the specified position in space. | ||
| strDeprecateDecorator | |||
| stringArrayIntersector | The stringArrayIntersector command creates and edits an object which is able to efficiently intersect large string | ||
| symmetricModelling | This command allows you to change the symmetric modelling options. | ||
| threadCount | This command sets the number of threads to be used by Maya in regions of code that are multithreaded. By default the | ||
| timeCode | Use this command to query and set the time code information in the file | ||
| toggle | The toggle command is used to toggle the display of various object features for objects which have these components. | ||
| toggleAxis | Toggles the state of the display axis. | ||
| toolDropped | This command builds and executes the commands necessary to recreate the specified tool button. | ||
| toolHasOptions | This command queries a tool to see if it has options. | ||
| toolPropertyWindow | End users should only call this command as 1. | ||
| transformCompare | Compares two transforms passed as arguments. | ||
| transformLimits | The transformLimits command allows us to set, edit, or query the limits of the transformation that can be applied to | ||
| ungroup | This command ungroups the specified objects. | ||
| upAxis | The upAxis command changes the world up direction. Current implementation provides only two choices of axis (the Y-axis | ||
| validComponentIndexType | True if argObj is of a suitable type for specifying a component’s index. | ||
| xform | This command can be used query/set any element in a transformation node. |
Classes
| Attribute | Attribute class |
| AttributeDefaults | |
| Component | Abstract base class for pymel components. |
| Component1D | |
| Component1D64 | |
| Component1DFloat | |
| Component2D | |
| Component2DFloat | |
| Component3D | |
| ComponentArray | |
| ComponentIndex | Class used to specify a multi-dimensional component index. |
| ContinuousComponent | Components whose dimensions are continuous. |
| DimensionedComponent | Components for which having a __getitem__ of some sort makes sense |
| DiscreteComponent | Components whose dimensions are discretely indexed. |
| HashableSlice | |
| LatticePoint | |
| MItComponent | Abstract base class for pymel components that can be accessed via iterators. |
| MItComponent1D | |
| MeshEdge | |
| MeshFace | |
| MeshUV | |
| MeshVertex | |
| MeshVertexFace | |
| NurbsCurveCV | |
| NurbsCurveEP | |
| NurbsCurveKnot | |
| NurbsCurveParameter | |
| NurbsSurfaceCV | |
| NurbsSurfaceEP | |
| NurbsSurfaceFace | |
| NurbsSurfaceIsoparm | |
| NurbsSurfaceKnot | |
| NurbsSurfaceRange | |
| Pivot | |
| ProxySlice | slice([start,] stop[, step]) |
| PyNode | Abstract class that is base for all pymel nodes classes. |
| Scene | The Scene class provides an attribute-based method for retrieving PyNode instances of |
| SubdEdge | |
| SubdFace | |
| SubdUV | |
| SubdVertex |
Exceptions
| AmbiguityWarning | |
| MayaAttributeEnumError([node, enum]) | |
| MayaAttributeError([node]) | |
| MayaComponentError([node]) | |
| MayaNodeError([node]) | |
| MayaObjectError([node]) |