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

Synopsis

unknownNode([plugin=boolean], [realClassName=boolean], [realClassTag=boolean])

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

unknownNode is undoable, queryable, and NOT editable.

Allows querying of the data stored for unknown nodes (nodes that are defined by a plug-in that Maya could not load when loading a scene file).

Return value

string[]in query mode

In query mode, return type is based on queried flag.

Related

requires, unknownPlugin

Flags

plugin, realClassName, realClassTag
Long name (short name) Argument types Properties
plugin(p) boolean query
In query mode return the name of the plug-in from which the unknown node originated. If no plug-in then the empty string is returned.
realClassName(rcn) boolean query
Return the real class name of the node.
realClassTag(rct) boolean query
Return the real class IFF tag of the node.
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

# query the unknown node's real class name
#
cmds.unknownNode( 'testIterator1', q=True, rcn=True )
# Result: testIterator #

# query the unknown node's class IFF tag
# if the node was loaded from a Maya ASCII file
#
cmds.unknownNode( 'testIterator1', q=True, rct=True )
# Warning: line 1: No class tag available for node 'testIterator1'. #
# Result: 0 #

# if the node was loaded from a Maya Binary file
#
cmds.unknownNode( 'testIterator1', q=True, rct=True )
# Result: 10 #

# query the plug-in that defined the unknown node
#
cmds.unknownNode( 'testIterator1', q=True, p=True )
# Result: testIteratorNode #