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. |
| 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 gets the list of attributes on a node or node type that are affected by 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. |
| artAttrTool | The artAttrTool command manages the list of tool types which are used for attribute painting. This command |
| 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. |
| 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. |
| 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, |
| 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. |
| 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. |
| 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 |
| 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. |
| 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 |
| 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 |
| 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. |
| 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. |
| 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 | |
| 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 | |
| MayaAttributeError([node]) | |
| MayaComponentError([node]) | |
| MayaNodeError([node]) | |
| MayaObjectError([node]) | |
| MayaSubObjectError([node]) |