ジャンプ先: 概要. 戻り値.
関連項目. フラグ. MEL 例.
loadPlugin [-addCallback script] [-allPlugins] [-name
string] [-quiet] [-removeCallback script] string
[string...]
loadPlugin は 「元に戻す」が可能、「照会」が不可能、「編集」が不可能 です。
Maya にプラグインがロードされます。このコマンドのパラメータは、プラグイン
ファイルの名前かパス名のどちらかです。プラグインの命名規則として、Linux では .so 拡張子、Windows では .mll
拡張子、Mac OS X では .bundle
拡張子が使用されます。拡張子がない場合、プラットフォームのデフォルト拡張子が使用されます。 Python
プラグインをロードするには、明示的に「.py」拡張子を使用する必要があります。
パス名をつけてプラグインを指定すると、それがプラグインを検索する場所になります。 パス名を指定しない場合、カレントの作業ディレクトリ
(つまり、Maya の「pwd」コマンドで返されるディレクトリ)が検索され、 次に MAYA_PLUG_IN_PATH
環境変数のディレクトリが検索されます。 プラグインがロードされると、プラグイン情報に Maya の内部プラグイン
レジストリで使用される名前は、拡張子が削除されたファイル名になります。たとえば、プラグイン「newNode.mll」をロードすると、Maya
のレジストリで使用される名前は「newNode」になります。この値は、「.so」、「.mll」、「.bundle」のいずれかの拡張子が付いた値と同様に、unloadPlugin
コマンドか pluginInfo コマンドの有効な引数として使用できます。
string[] |
正常にロードされたプラグインの内部名 |
openMayaPref, pluginInfo, unloadPlugin
addCallback, allPlugins, name,
quiet, removeCallback
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
-name(-n) |
string |
|
|
ロードされたプラグインに対してユーザ定義の名前を設定します。その名前がすでに使用されている場合は、名前の末尾に数値が追加されて固有になります。 |
|
-allPlugins(-a) |
|
|
|
MAYA_PLUG_IN_PATH で指定した検索パスにあるすべてのプラグインがロードされます。 |
|
-quiet(-qt) |
|
|
|
すでにロードされているプラグインをロードしようとしても、警告メッセージは出力されません。 |
|
-addCallback(-ac) |
script |
|
|
MEL または Python のコールバック スクリプトを追加し、プラグインがロードされた後でコールされるようにします。
MEL では、このプロシージャには次のシグニチャが必要です。global proc procedureName(string
$pluginName) Python では、スクリプトを文字列として指定するか、または関数などのコール可能な Python
オブジェクトを指定することができます。文字列を指定する場合は、プラグイン名を挿入する場所にフォーマット識別子「%s」を配置します。関数などのコール可能なオブジェクトを指定する場合は、プラグイン名を引数として渡します。 |
|
-removeCallback(-rc) |
script |
|
|
以前に -addCallback で追加されたプロシージャを削除します。 |
|
: コマンドの作成モードで使用可能なフラグ |
: コマンドの編集モードで使用可能なフラグ |
: コマンドの照会モードで使用可能なフラグ |
: 1 つのコマンドで複数回使用可能なフラグ |
// 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;