Go to: Synopsis. Return value. Related.
Flags. MEL
examples.
loadPlugin [-addCallback script] [-allPlugins] [-name
string] [-quiet] [-removeCallback script] string
[string...]
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) |
|
|
|
Cause all plug-ins in the search path specified in
MAYA_PLUG_IN_PATH to be loaded. |
|
-quiet(-qt) |
|
|
|
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 be used more than once in a
command. |
// Load the plugin named "newNode" into Maya.
//
loadPlugin newNode;
// Load all the plug-ins in the specified directory.
//
loadPlugin "$MYPATH/plugins/*.so";
// Load all the plug-ins found in all the directories that are
// included in MAYA_PLUG_IN_PATH.
//
loadPlugin -allPlugins;