Go to: Synopsis. Return value. Related.
Flags. Python
examples.
loadPlugin( string [string...] , [addCallback=script], [allPlugins=boolean], [name=string], [quiet=boolean], [removeCallback=script])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
loadPlugin is undoable, NOT queryable, and NOT
editable.
Load plug-ins into Maya. The parameter(s) to this command are
either the names or pathnames of plug-in files. The convention for
naming plug-ins is to use a .so extension on Linux, a .mll
extension on Windows and .bundle extension on Mac OS X.
MAYA_PLUG_IN_PATH will be searched looking for a file with the
given name. If you specified the plug-in without an extension, the
appropriate one for the platform will be automatically appended.
When the plug-in is loaded, the name used in Maya's internal
plug-in registry for the plug-in information will be the file name
with the extension removed. For example, if you load the plug-in
"newNode.mll" the name used in the Maya's registry will be
"newNode". This value as well as that value with either a ".so",
".mll" or ".bundle" extension can be used as valid arguments to
either the unloadPlugin or pluginInfo commands.
string[] |
the internal names of the successfully loaded plug-ins |
openMayaPref, pluginInfo, unloadPlugin
addCallback, allPlugins, name,
quiet, removeCallback
Long name (short name) |
Argument types |
Properties |
name(n) |
string |
|
|
Set a user defined name for the plug-ins that are loaded. If
the name is already taken, then a number will be added to the end
of the name to make it unique. |
|
allPlugins(a) |
boolean |
|
|
Cause all plug-ins in the search path specified in
MAYA_PLUG_IN_PATH to be loaded. |
|
quiet(qt) |
boolean |
|
|
Don't print a warning if you attempt to load a plug-in that is
already loaded. |
|
addCallback(ac) |
script |
|
|
Add a MEL or Python callback script to be called after a
plug-in is loaded. For MEL, the procedure should have the following
signature: global proc procedureName(string $pluginName). For
Python, you may specify either a script as a string, or a Python
callable object such as a function. If you specify a string, then
put the formatting specifier "%s" where you want the name of the
plug-in to be inserted. If you specify a callable such as a
function, then the name of the plug-in will be passed as an
argument. |
|
removeCallback(rc) |
script |
|
|
Removes a procedure which was previously added with
-addCallback. |
|
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
# Load the plug-in named "newNode" into Maya.
#
cmds.loadPlugin( 'newNode.py' )
# Load all the plug-ins found in all the directories that are
# included in MAYA_PLUG_IN_PATH.
#
cmds.loadPlugin( allPlugins=True )