Go to: Synopsis. Return value. Related.
Flags. Python
examples.
namespaceInfo([absoluteName=boolean], [currentNamespace=boolean],
[dagPath=boolean], [internal=boolean], [isRootNamespace=string],
[listNamespace=boolean],
[listOnlyDependencyNodes=boolean],
[listOnlyNamespaces=boolean],
[parent=boolean], [recurse=boolean], [shortName=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
namespaceInfo is undoable, NOT queryable, and NOT
editable.
This command displays information about the current namespace. A
namespace is a simple grouping of objects under a given name. Each
item in a namespace can then be identified by its own name, along
with what namespace it belongs to. Namespaces can contain other
namespaces like sets, with the restriction that all namespaces are
disjoint. Namespaces are primarily used to resolve name-clash
issues in Maya, where a new object has the same name as an existing
object (from importing a file, for example). Using namespaces, you
can have two objects with the same name, as long as they are
contained in different namespaces. Note that namespaces are a
simple grouping of names, so they do not effect selection, the DAG,
the Dependency Graph, or any other aspect of Maya. All namespace
names are colon-separated.
namespace
absoluteName, currentNamespace, dagPath, internal,
isRootNamespace, listNamespace, listOnlyDependencyNodes,
listOnlyNamespaces, parent, recurse,
shortName
| Long name (short name) |
Argument types |
Properties |
listNamespace(ls) |
boolean |
 |
|
List the contents of the current namespace. |
|
currentNamespace(cur) |
boolean |
|
|
Display the name of the current namespace. |
|
isRootNamespace(ir) |
string |
|
|
Returns true if the current namespace is root(":"), false if
not |
|
parent(p) |
boolean |
|
|
Display the parent of the current namespace. By default, the
list returned will not include internal nodes (such as
itemFilters). To include the internal nodes, use the -internal
flag. |
|
listOnlyDependencyNodes(
lod) |
boolean |
|
|
List all dependency nodes in the current namespace. |
|
listOnlyNamespaces(lon) |
boolean |
|
|
List all namespaces in the current namespace. |
|
recurse(r) |
boolean |
|
|
Can be specified with -listNamespace, -listOnlyNamespaces or
-listOnlyDependencyNode to cause the listing to recursively include
any child namespaces of the current namespaces. |
|
dagPath(dp) |
boolean |
|
|
This flag modifies the '-ls/-listNamespace' and
'-lod\-listOnlyDependencyNodes flags to indicate that the names of
any dag objects returned will include as much of the dag path as is
necessary to make the names unique. If this flag is not present,
the names returned will not include any dag paths. |
|
shortName(sn) |
boolean |
|
|
This flag modifies the '-p/-parent' and
'-cur\-currentNamespace' flags to indicate that the name returned
will be the base name of the namespace. If the flag is not present,
the names returned are full path of the namespace, including its
parent paths and base name It cannot be used together with
-absoluteName. |
|
absoluteName(an) |
boolean |
|
|
This flag modifies queries so that the namespace name returned
will be an absolute name. The absolute name is the full namespace
path, starting from the root namespace ":" and including all parent
namespaces. It cannot be used together with -shortName. |
|
internal(int) |
boolean |
|
|
This flag used together with listOnlyDependencyNodes. When this
flag is set, the returned list will include internal nodes (for
example itemFilters) that are not listed by default. |
|
| 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
# List the contents of the current namespace
#
cmds.namespaceInfo( listNamespace=True )
# List the parent of the current namespace
#
cmds.namespaceInfo( parent=True )
# List the parent of the current namespace with short name
#
cmds.namespaceInfo( parent=True, shortName=True )
# Determine if the current namespace is root
#
cmds.namespaceInfo( rootNamespace=True )
# List the parent of the current namespace with absolute name
#
cmds.namespaceInfo( parent=True, absoluteName=True )
// List dependency nodes including internal nodes
//
cmds.namespaceInfo(listOnlyDependencyNodes = True, internal = True);