Softimage においてカスタム メニューは、自己インストール プラグインとしてのみ存在します。 カスタム メニューは、ロード時にプラグイン項目のリストに追加され、Softimage セッションの完了後に再び除去されます。
メニュー プラグインを正しく登録するには、ユーザ メニューの自己インストール方法を Softimage に指定するプラグイン メニュー コールバックを使用します。実装ファイル内に実装されている項目の数に関係なく、実装ファイル全体では1つの登録エントリポイント(XSILoadPlugin)しか存在しません。
このコールバックをベースに実装ファイルごとに 1 つの Plugin オブジェクトが作成され、implementation コールバックまたは PluginRegistrar オブジェクト上のメソッドを使用して、1 つまたは複数の PluginItem オブジェクトが定義されます。カスタム メニューの場合、RegisterMenu(PluginRegistrar) メソッドを使用します。
XSILoadPlugin コールバックが(Softimage で提供される)入力として取るのは、PluginRegistrar オブジェクトです。この PluginRegistrar オブジェクトを使用して、RegisterMenu メソッドにアクセスできます。 このメソッドが Softimage のコマンドの登録に使用する情報は、次のとおりです。
引数名 |
指定内容 |
---|---|
Anchor |
メニューが表示される場所(「メニュー アンカー ポイントについて」を参照)。 |
Name |
メニューの名前。 これは、メニューおよびサブメニューの識別に使用される名前になります。サブメニューのアンカー ポイントとして表示される名前です(「名前付け: ラベルを使用する」を参照)。 |
DisplayAsSubmenu |
True を設定すると、カスタム メニューがアンカー ポイントからのドロップダウン メニューとして表示されます「ネスト構造: サブメニューを使用する」を参照)。 |
Dynamic |
True を設定すると、そのメニューは親メニューが開くたびに再ビルドされます。 |
また、PluginRegistrar オブジェクトを使用して、プラグイン全体に関する何らかの一般情報(コマンド プラグイン項目固有の情報以外の情報)を設定することもできます。詳細については、「自己インストール プラグイン」を参照してください。