Softimage SDK プログラミング ガイド > SDK によるカスタマイズ > カスタマイズのビルドおよび配布 > 

プラグイン ツリーを使った作業

 
 
 

プラグインツリーは、Softimage にインストールされているプラグインを含んだ階層ビューです。 ツリーには、ファイル システム上のさまざまな場所にあるプラグイン、ツールバー、ビュー、およびアドオンが一覧表示されます。

プラグイン ツリーは、Softimage にインストールされているプラグインのフォーカス ビューです。 このツリーには、各場所のファイルおよびフォルダが必ずしもすべて表示されるとは限りません。その代わりに、ツリーに表示されるビューはハイレベルになります。 たとえば、ツリーにはプラグインおよびプラグイン項目(コマンド、オペレータ、プロパティなど)は表示されますが、プラグイン実装が含まれる個々のソース ファイルは表示されません。

ただし、ファイル システムにアクセスする必要のある場合は、プラグイン ツリーから Softimage コマンド プロンプト、Softimage ファイル ブラウザ、および Microsoft Explorer ウィンドウを開くことができます。

プラグイン ツリーでは、プラグインをはじめとするカスタマイズを編集し、作成し、管理することができます。 たとえば、ウィザードを使ったコマンド、オペレータ、プロパティの作成、プラグインのロード/アンロード、アドオンのインストール、新しいツールバーの作成、ツールバーへのコマンドのドラッグ、ある場所から別の場所へのプラグインのドラッグなどが可能です。

プラグイン ツリーでアクションを実行するには、[プラグイン]タブ上部のコマンド ボタン([ファイル]や[選択]など)を使用する方法と、ツリー内のノードを右クリックしてコンテキスト メニューを表示する方法があります。

レガシー アドオンはアドオンであっても、次のワークグループ フォルダにはインストールされません。

たとえば、MyWorkgroup¥Addons¥Application¥Plugins フォルダにファイルをインストールするアドオンの場合、プラグイン ツリー内のレガシー アドオンの下に、そのアドオンが表示されます。

プラグイン ツリーのコマンド ボタン

ボタン

説明

ファイル

すべてのプラグインまたはプラグイン ツリー全体に適用される汎用コマンドが、提供されています。

  • [ファイル](File) [新規作成](New)を選択すると、プラグイン、シェーダ、およびツールバー作成用のウィザードへアクセスできます。 ウィザードを使用した場合、デフォルトではユーザ パス内にプラグインが作成されます。

    特定の場所にプラグインを作成するには、ツリー内のその場所を展開し、[プラグイン]フォルダを右クリックし、[新規作成]をクリックして、作成するプラグインの種類を選択します。

  • [ファイル](File) [プラグインのロード](Load Plug-in)を選択すると、プラグインの場所を指定してロードするためのブラウザが開きます。

  • [ファイル](File) [すべて更新](Update All)を選択すると、自己インストール プラグインがすべて再ロードされます。

  • [ファイル](File) [エラーの表示](Show Errors)を選択すると、プラグイン ツリーを展開して、ロード中にエラーの発生したプラグインを表示できます。

  • [ファイル](File) [設定](Preferences)を選択すると、同じプラグインのコピーが複数見つかったときに Softimage がどのような方法で競合を解決するか、またどのような情報をプラグイン ツリーに表示するかを設定できます。

選択

プラグイン ツリーで現在選択されているノードに適用されるコマンドを指定します。

同じコマンドにアクセスするには、ツリー内のノードを右クリックする方法があります。 たとえば、ワークグループ内に新規ツールバーを作成するには、[ツールバー]フォルダを右クリックして[新規作成](New)[ツールバー](Toolbar)を選択します。

ロード

自己インストール プラグインをロードします。

すべて更新

自己インストール プラグインをすべて再ロードします。

プラグインを使った作業

実行内容

マウス/キー操作

自己インストール プラグインの作成

プラグイン ツリーで、ロケーション(たとえば、ワークグループやアドオン ディレクトリ)を展開し、[プラグイン]フォルダを右クリックします。 [新規作成]をクリックし、作成するプラグインの種類(コマンド、オペレータ、プロパティ、またはイベント)を選択します。

別の種類のプラグイン(フィルタなど)を作成する場合は、[新規作成](New)[空のプラグイン](Empty Plug-in)を選択します。

自己インストール プラグインの編集

次のいずれかの操作を実行します。

  • プラグインを展開し、プロパティを右クリックして、[編集](Edit)を選択します。

  • プラグインを Script Editor へドラッグします。

コマンドの実行

プラグインを展開し、カスタム コマンドを右クリックして、[実行<Command-Name>](Invoke <Command-Name>)(<Command-Name>はコマンドの実際の名前)を選択します。

プロパティの作成

プラグインを展開し、プロパティを右クリックして、[プロパティの作成](Create Property)を選択します。 これにより、シーン ルートにカスタム プロパティが追加され、プロパティ ページが開きます。

プラグインのアンロード

プラグインを右クリックして、[アンロード](Unload)を選択します。

プラグインを再びロードするには、[ロード](Load)または[すべて更新](Update All)をクリックするか、[LoadPlugin] コマンドを使用します。プラグインがワークグループ内にある場合は、ワークグループを無効にしてから再び有効にしてください(ワークグループの再スキャンによって、ワークグループが[すべて](all)再ロードされます)。

プラグインの更新

プラグインを右クリックして、[更新](Update)を選択します。 プラグインがアンロードされてから再ロードされます。

プラグインの削除

プラグインを右クリックして、[削除](Delete)を選択します。

キャッシュ済み

プラグインを右クリックし、[キャッシュ済み](Cached)をクリックして、チェックマークをクリアします。

ツールバーを使った作業

実行内容

プラグイン ツリーでの操作

ツールバーの作成

ロケーション(たとえば、ワークグループやアドオン ディレクトリ)を展開し、[ツールバー]フォルダを右クリックします。 [新規作成](New)[ツールバー](Toolbar)を選択します。

ツールバーにコマンドを追加

ツールバーをダブルクリックして開きます。 カスタム コマンドをプラグイン ツリーからツールバーへドラッグします。

ツールバーの編集

ツールバーをカスタマイズするには、ツールバーをダブルクリックして開いてから、 右クリックして[ツールバーのカスタマイズ](Customize)を選択します。

.xsitb ファイルを編集するには、次のいずれかの操作を実行します。

  • ツールバーを右クリックして、[編集](Edit)を選択します。

  • ツールバーを Script Editor へドラッグします。

    注:

    (ファイルが読み取り専用でない限り)ワークグループでツールバーを直接編集することができます。

アドオンを使った作業

実行内容

プラグイン ツリーでの操作

アドオンのパッケージング

アドオンを右クリックし、[アドオンのパッケージ](Package Add-on)を選択します。

[Package Location Options] ダイアログ ボックスで、次のパッケージング オプションを設定します。

  • [ソース]はアドオン ディレクトリの名前です。 .xsiaddon ファイルには、ソース フォルダの下にある内容がすべて格納されています。

  • [デスティネーション]は、.xsiaddon ファイルが作成される場所です。

  • [除外するディレクトリ]には、.xsiaddon ファイルを格納しないフォルダをセミコロン(;)で区切って列挙します。

アドオンのインストール

ワークグループ内の[最初](first)のプラグインを右クリックして、[.xsiaddon のインストール](Install .xsiaddon)を選択します。 [アドオン ファイルの選択](Select Add-on File)で、.xsiaddon ファイルの場所を指定して[OK]をクリックします。

別のワークグループ(ツリー内の先頭に位置しないワークグループ)にアドオンをインストールする場合、[ワークグループ](Workgroup)タブで、ワークグループをクリックし、そのワークグループがツリー内の先頭に位置するまで[上に移動](Move Up)をクリックします。

アドオンのアンインストール

アドオン ノードを右クリックし、[アドオンのアンインストール](Uninstall Add-on)を選択します。

アドオン用ヘルプ ページの生成

アドオンを右クリックし、[新規作成](New)[アドオン ヘルプ](Add-on Help)を選択します。 簡単な説明を入力して、[OK]をクリックします。

コマンド プロンプトを開く

プラグイン ツリーから、さまざまな場所(ワークグループ フォルダやアドオン ディレクトリなど)にある Softimage コマンド プロンプトを起動できます。

コマンド プロンプトを開くには、ワークグループ、アドオン、プラグイン、または他のノードを右クリックし、[コマンド プロンプト](Command Prompt)を選択します。

プラグイン ツリーからコマンド プロンプトを開くと、そのコマンド プロンプトに Softimage 環境変数の設定が継承されます。 Softimage の稼働中でも、ユーザ環境変数 TMP および TEMP は、Softimage で作成された一時フォルダを指すように修正することができます。

コマンド プロンプトから Microsoft Visual Studio を起動すると、中間ファイル用 TMP フォルダが Visual Studio で使用されます。 これ自体は問題ではありませんが、次回(数日後に)Visual Studio を起動したり、Softimage を終了してから Visual Studio を開いたままにしたりすると、TMP 環境変数が変更されてしまい、プロジェクトをビルドしようとしたときに次のようなエラーが発生します。 

c1xx : fatal error C1083: Cannot open compiler intermediate file: 'C:\DOCUME~1\sblair\LOCALS~1\Temp\XSI_Temp_2116\_CL_aaa04008ex': No such file or directory
このトピックについてのコメントをお送りください