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

Synopsis

pluginInfo [-activeFile] [-allEvaluators] [-animCurveInterp string] [-apiVersion] [-autoload boolean] [-cacheFormat] [-changedCommand script] [-command string] [-constraintCommand] [-controlCommand] [-data string string] [-dependNode] [-dependNodeByType string] [-dependNodeId string] [-device] [-dragAndDropBehavior] [-evaluator] [-iksolver] [-listPlugins] [-listPluginsPath] [-loadPluginPrefs] [-loaded] [-modelEditorCommand] [-name string] [-path string] [-pluginsInUse] [-referenceTranslators boolean] [-registered] [-remove] [-renderer] [-savePluginPrefs] [-serviceDescriptions] [-settings] [-tool string] [-translator] [-unloadOk] [-userNamed] [-vendor string] [-version] [-writeRequires boolean] [string]

pluginInfo is undoable, queryable, and editable.

This command provides access to the plug-in registry of the application. It is used mainly to query the characteristics of registered plug-ins. Plugins automatically become registered the first time that they are loaded.

The argument is either the internal name of the plug-in or the path to access it.

Return value

AnyDependent upon the action requested.

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

Related

loadPlugin, openMayaPref, unloadPlugin

Flags

activeFile, allEvaluators, animCurveInterp, apiVersion, autoload, cacheFormat, changedCommand, command, constraintCommand, controlCommand, data, dependNode, dependNodeByType, dependNodeId, device, dragAndDropBehavior, evaluator, iksolver, listPlugins, listPluginsPath, loadPluginPrefs, loaded, modelEditorCommand, name, path, pluginsInUse, referenceTranslators, registered, remove, renderer, savePluginPrefs, serviceDescriptions, settings, tool, translator, unloadOk, userNamed, vendor, version, writeRequires
Long name (short name) Argument types Properties
-activeFile(-af) query
Restricts the command to the active file only, not the entire scene. This only affects the dependNode/dn and pluginsInUse/pu flags. For use during export selected.
-allEvaluators(-ae) query
Returns a string array containing the names of all of the evaluator types registered to any plug-in.
-animCurveInterp(-aci) string query
Returns a string array containing the names of all of the animation curve interpolators registered by this plug-in.
-apiVersion(-av) query
Returns a string containing the version of the API that this plug-in was compiled with. See the comments in MTypes.h for the details on how to interpret this value.
-autoload(-a) boolean createqueryedit
Sets whether or not this plug-in should be loaded every time the application starts up. Returns a boolean in query mode.
-cacheFormat(-cf) query
Returns a string array containing the names of all of the registered geometry cache formats
-changedCommand(-cc) script create
Adds a callback that will get executed every time the plug-in registry changes. Any other previously registered callbacks will also get called.
-command(-c) string querymultiuse
Returns a string array containing the names of all of the normal commands registered by this plug-in. Constraint, control, context and model editor commands are not included.
-constraintCommand(-cnc) query
Returns a string array containing the names of all of the constraint commands registered by this plug-in.
-controlCommand(-ctc) query
Returns a string array containing the names of all of the control commands registered by this plug-in.
-data(-d) string string querymultiuse
Returns a string array containing the names of all of the data types registered by this plug-in.
-dependNode(-dn) querymultiuse
Returns a string array containing the names of all of the custom nodes types registered by this plug-in.
-dependNodeByType(-dnt) string query
Returns a string array of all registered node types within a specified class of nodes. Each custom node type registered by a plug-in belongs to a more general class of node types as specified by its MPxNode::Type. The flag's argument is an MPxNode::Type as a string. For example, if you want to list all registered Locator nodes, you should specify kLocatorNode as a argument to this flag.
-dependNodeId(-dni) string query
Returns an integer array containing the ids of all of the custom node types registered by this plug-in.
-device(-dv) query
Returns a string array containing the names of all of the devices registered by this plug-in.
-dragAndDropBehavior(-ddb) query
Returns a string array containing the names of all of the drag and drop behaviors registered by this plug-in.
-evaluator(-e) query
Returns a string array containing the names of all of the evaluator types registered by this plug-in.
-iksolver(-ik) query
Returns a string array containing the names of all of the ik solvers registered by this plug-in.
-listPlugins(-ls) query
Returns a string array containing all the plug-ins that are currently loaded.
-listPluginsPath(-lsp) query
Returns a string array containing the full paths of all the plug-ins that are currently loaded.
-loadPluginPrefs(-lpp) create
Loads the plug-in preferences (ie. autoload) from pluginPrefs.mel into Maya.
-loaded(-l) query
Returns a boolean specifying whether or not the plug-in is loaded.
-modelEditorCommand(-mec) query
Returns a string array containing the names of all of the model editor commands registered by this plug-in.
-name(-n) string query
Returns a string containing the internal name by which the plug-in is registered.
-path(-p) string query
Returns a string containing the absolute path name to the plug-in.
-pluginsInUse(-pu) query
Returns a string array containing all the plug-ins that are currently being used in the scene.
-referenceTranslators(-rtr) boolean query
If this flag is used in conjunction with the pluginsInUse/pu flag then it will modify the output. When true it will only show plug-ins currently in use containing translators that are used to load referenced files. When false it will only show plug-ins not containing such translators.
-registered(-r) query
Returns a boolean specifying whether or not plug-in is currently registered with the system.
-remove(-rm) edit
Removes the given plug-in's record from the registry. There is no return value.
-renderer(-rdr) query
Returns a string array containing the names of all of the renderers registered by this plug-in.
-savePluginPrefs(-spp) create
Saves the plug-in preferences (ie. autoload) out to pluginPrefs.mel
-serviceDescriptions(-sd) query
If there are services in use, then this flag will return a string array containing short descriptions saying what those services are.
-settings(-set) query
Returns an array of values with the loaded, autoload, registered flags
-tool(-t) string querymultiuse
Returns a string array containing the names of all of the tool contexts registered by this plug-in.
-translator(-tr) query
Returns a string array containing the names of all of the file translators registered by this plug-in.
-unloadOk(-uo) query
Returns a boolean that specifies whether or not the plug-in can be safely unloaded. It will return false if the plug-in is currently in use. For example, if the plug-in adds a new dependency node type, and an instance of that node type is present in the scene, then this query will return false.
-userNamed(-u) query
Returns a boolean specifying whether or not the plug-in has been assigned a name by the user.
-vendor(-vd) string query
Returns a string containing the vendor of the plug-in.
-version(-v) query
Returns a string containing the version the plug-in.
-writeRequires(-wr) boolean createqueryedit
Sets whether or not this plug-in should write "requires" command into the saved file. "requires" command could autoload the plug-in when you open or import that saved file. This way, Maya will load the plug-in when a file is being loaded for some specified reason, such as to create a customized UI or to load some plug-in data that is not saved in any node or attributes. For example, "stereoCamera" is using this flag for its customized UI.

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.

MEL examples

// List the plug-ins that are currently loaded
pluginInfo -query -listPlugins;

// Find the vendor of a plug-in
pluginInfo -query -vendor newNode;

// Find the commands provided by a given plug-in
pluginInfo -query -command helloCmd;

// Turn on autoloading for a plug-in
pluginInfo -edit -autoload true newNode;

// Make maya write requires command in the saved file for a plug-in
pluginInfo -edit -writeRequires true pluginName;

// Return all custom locators registered by plug-ins.
pluginInfo -query -dependNodeByType "kLocatorNode";