ウォークスルー: アドオンのビルド

 
 
 

このウォークスルーでは、アドオンおよび .xsiaddon ファイルを使った作業についての簡単なワークフローを示します。 このウォークスルーでは、MyTool という名前のツールをビルドし、.xsiaddon ファイルとして配布します。 MyTool の実際の内容は重要ではありません。重要なのは作業フローです。

ワークグループの作成

アドオンはユーザ ロケーション内でビルドできますが、ロケーションとして推奨されるのはワークグループです。 オリジナルのアドオン ファイルをワークグループ上に配置すれば、.xsiaddon のテストは容易になります。

ワークグループは多数のユーザに共有されることが多いので、ツール開発においては、ローカル マシンまたは共有ネットワーク上のプライベート ワークグループ内で作業する方が便利です。

  1. Softimage のメイン メニューバーで、[表示](View)[レイアウト](Layouts)[ツール開発環境](Tool Development Environment)を選択します。

    ツール開発環境は、よく使われる Softimage 開発ツール(たとえば、プラグイン マネージャ、スクリプト エディタ、SDK Explorer、NetView)を多数組み合わせたレイアウトです。

  2. プラグイン マネージャ で、[ワークグループ](Workgroup)タブをクリックし、[ファイル](File)[作成](Create)を選択します。

  3. [ワークグループの作成](Create Workgroup)ダイアログ ボックスで、次の操作を実行します。

    • [ワークグループ フォルダ名](Workgroup Folder Name)ボックスに、ワークグループの名前を入力します。

    • [ワークグループの位置](Location of Workgroup)ボックスの横にある をクリックし、ワークグループを含むフォルダの場所を指定します。

  4. [OK]をクリックし、ワークグループを作成します。Softimage がワークグループに自動的に接続し、ワークグループがプラグイン ツリーに表示されます。

アドオン ディレクトリの作成

ツールの配布を予定している場合、ワークグループ内にアドオン ディレクトリを作成することを推奨します。 これにより、該当のファイルがワークグループ内の他の内容と切り離され、.xsiaddon ファイルのパッケージングが容易になります。

  1. プラグイン ツリーでワークグループを右クリックし、[新規作成](New)[アドオンディレクトリ](Add- Directory)を選択します。

  2. [アドオン ディレクトリの作成](Create Add-on Directory)ダイアログ ボックスで、アドオンの名前として「MyTools」と入力します。

    プラグイン ツリーで、ワークグループの下部に、新規の[アドオン]フォルダ ノードが表示されます。

アドオン用ヘルプの追加

Softimage には、アドオン用ヘルプ ファイルおよび連絡先情報を設定するための、便利なワークフローが組み込まれています。 ヘルプ ファイルの標準命名規則を使用することにより、Softimage では内部機能に関してコンテキスト依存ヘルプを使用できるのと同様に、カスタム ツールに関してもコンテキスト依存ヘルプを使用できます。

  1. プラグイン ツリーで、MyTool[アドオン]を右クリックし、[新規作成](New)[アドオンヘルプ](Add-on Help)を選択します。

    [アドオン ドキュメンテーション ウィザード]が表示されます。

  2. アドオンのヘルプ ページのサンプルを表示したい場合、[ヘルプ](Help)タブをクリックし、[Show Me]をクリックします。

  3. [詳細](Description)ボックスに、アドオンの簡単な説明を入力します。

    この簡単な説明は、XSI Local のアドオン ページに表示され、アドオンのヘルプ ページ(HTML ファイル)に挿入されます。

  4. デフォルトのイメージおよびテンプレートを使用します。

    イメージは、アドオン用アイコンとして使用される 56x56 の JPG ファイルです。

    テンプレートは、単純な HTML ページです。 トークン %DESCRIPTION% および %ADDONIMAGE% は、ウィザードで指定された説明およびイメージで置き換えられます。

  5. [OK]をクリックすると、ヘルプ ページが生成されます。 このウィザードでは、html ファイルがテキスト エディタで開き、アドオンの説明に詳細が追加されます。

    このウィザードでは、プラグイン ソース コードは変更されません。 プラグインまたはプラグイン項目のヘルプ プロパティを設定しても、アドオン ヘルプは指定されません。

    代わりに、アドオン ディレクトリ内に次の 4 つのファイルが生成されます。

    • netview_<Addon>.htm

    • netview_<Addon>.jpg

    • netview_<Addon>.txt

    • netview_<Addon>.xml

    これらの 4 つのファイルは Softimage で自動的に検索され、存在している場合はアドオン ヘルプとして使用されます。 「アドオンを記録する」を参照してください。

  6. ヘルプを表示するには、次のいずれかの操作を実行します。

    • プラグイン ツリーで、[アドオン]を右クリックし、[ヘルプ](Help)を選択します。

    • NetView で、XSI Local のアドオン ページに移動します。

    • アドオンに自己インストール プロパティが組み込まれている場合、プロパティ ページで、タイトル バーの[?]アイコンをクリックします。

  7. 生成されたヘルプ ファイルはプラグイン ツリーに表示されませんが、[アドオン]コンテキスト メニューから[ブラウズ](Browse)を選択して、容易にアクセスすることができます。

    MyTool アドオンに関連付けられているフォルダおよびファイルがブラウザに表示されます。この MyTool アドオンは、現時点ではドキュメント ファイルのみから構成されています。

アドオン コンテンツの作成

アドオンには、自己インストール プラグイン、シェーダ、ツールバー、スクリプト、イメージなどのコンテンツをいくつでも含めることができます。 基本的に、Softimage カスタマイズまたは補助ファイルはどのようなものもアドオンに格納することができます(SDK サンプル ワークグループには、想定されるアドオンの手本となる例がいくつか提供されています)。

ウィザードでのコンテンツ生成

Softimage には、自己インストール プラグイン(たとえば、シェーダ、コマンド、オペレータ、プロパティ、イベントなど)を生成するためのウィザードが組み込まれています。 たとえば、自己インストール コマンドをアドオン ディレクトリに生成するには、アドオン内の[プラグイン]フォルダを右クリックし、[新規作成](New)[コマンド](Command)を選択します。

Softimage にはツールバーを作成するためのウィザードも組み込まれています。 このウィザードを実行するには、[ツールバー]を右クリックします(ツールバー ウィザードの場合)。

アドオンにコンテンツを移動

プラグイン ツリーを使用して、プラグイン、ツールバー、およびビューを別の場所からアドオンにドラッグすることができます。

また、Windows Explorer、コマンド プロンプト、または他の外部ファイル マネージャを使用して、ファイルをアドオン ディレクトリに移動することもできます。 プラグイン ツリーは、想定されるタイプのアドオン コンテンツを必ずしもすべてサポートしているとは限りません。そのため、レイアウト、キーマップ、およびドキュメントのようなファイルを移動する際には、ファイル システムを経由する必要があります。

重要:

アドオンにファイルを追加するときは、ファイルを正しいフォルダに格納する必要があります。 Softimage はアドオン パスの特定のサブフォルダを調べてファイルを見つけます。 たとえば、ツールバー(.xsitb)ファイルがApplication¥Toolbarsフォルダにある場合、ツールバーはC:¥XSITools¥Addons¥Foo¥Application¥Toolbarsになければなりません。

.xsiaddon のパッケージング

アドオンを配布する準備ができたら、次のどちらかを選択します。

  • 社内にあるアドオンが社内での使用を目的としている場合、アドオンをネットワーク上の共有ワークグループ ロケーションにコピーして配布できます。 この操作は、Windows Explorer などの外部ファイル マネージャを使って実行できます。

  • 同じネットワークにアクセスできない外部ユーザにアドオンを配布する場合は、.xsiaddon ファイルを使用してください。

.xsiaddon ファイルとは、アドオン パスに含まれる全ファイルの圧縮バージョンを 1 つのファイルに格納したものです。

以前のバージョンの Softimage に用意されていた[アドオンのパッケージ]ダイアログ ボックスでは、ファイルを一度に 1 つずつ追加する必要がありました。 このダイアログ ボックスは現在も使用できますが、現在のバージョンでは使いやすい[パッケージ位置]オプションが用意されました。

アドオンをパッケージングする前に、アドオン ディレクトリ内のファイルおよびフォルダが配布対象のものだけであることを確認してください。

  • 一時ファイルおよびフォルダがある場合はすべて削除します。

  • リリース バージョン(デバッグ バージョン以外)の DLL がある場合はすべてコンパイルします。

アドオン パッケージを作成するときは、ディレクトリを除外できることに注意してください。 たとえば、C++ ソース コードのどれかを別個のフォルダに保存する場合は、そのフォルダのみをパッケージから除外することもできます。

アドオンをパッケージングするには

  1. プラグイン ツリーで、MyTool アドオンを右クリックし、[アドオンのパッケージ](Package Add-on)を選択します。

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

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

    • [デスティネーション]は、.xsiaddon ファイルが作成される場所です。 .xsiaddon ファイルはバージョン管理をサポートしていないため、ファイル名にバージョン番号を追加することを推奨します。

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

    • [作成者]および[詳細]はオプションです。 ここに入力された情報は、netview_MyTool.xml に保存され、アドオンを再パッケージングするたびに再利用されます。 この情報は、XSI Local の[アドオン]ページにも表示されます。

  3. [OK]をクリックすると、.xsiaddon ファイルが生成されます。 ファイルに .dlls などの大容量コンテンツが格納されている場合は、出力ファイルの生成に数分かかることがあります。

    .xsiaddon ファイルは xml ファイルであるため、ファイルのコンテンツを表示して[使用法]や[プラットフォーム]の情報を入力するなどのわずかな修正を加えることも可能です。

アドオンのテスト

.xsiaddon をテストするには、別のコンピュータに移動することも、そのテストを誰かに依頼することも、また自分自身のコンピュータでテストすることもできます。

  1. 競合エラーなどの混乱を回避するために、オリジナルの MyTool をメモリから削除します。 アドオンはワークグループ内に存在するため、ワークグループをアンロード(無効化)するだけで済みます。

    [ワークグループ](Workgroups)タブで、XSITool ワークグループの横にあるチェック ボックスをオフにします。

    これで、自己インストール プラグインをはじめとするアドオンのコンテンツがアンロードされます。 使用頻度の低いワークグループ ファイル(たとえば、キーマップやレイアウト)は、Softimage の再起動後にはじめてアンロードされます。

  2. MyTool アドオンをユーザ ロケーションまたは別のワークグループ ロケーションにインストールします。 ロケーションを右クリックして、[.xsiaddon のインストール](Install .xsiaddon)を選択します。

  3. [アドオン ファイルの選択](Select Add-on File)ダイアログ ボックスで、MyTool.xsiaddon ファイルの場所(C:\My Documents\XSITools\Addons)を探して選択します。

    アドオンは、そのアドオンがインストールされている場所の下位のプラグイン ツリーに表示されます。

  4. これで、アドオンのテストが可能になりました。 たとえば、コマンドやツールバーなどのコンテンツがすべて正常に動作していることを確認してください。

    また、ヘルプについても動作確認が必要です。

    NetView で、[XSI Local]をクリックし、[アドオン](add-ons)をクリックして、アドオンがリストされていることを確認します。

  5. テストを終えたら、MyTool アドオンをアンインストールして、オリジナルのワークグループに再接続します。

.xsiaddon の再パッケージング

ツールの変更または更新(たとえば、コンテンツ/機能の新規追加やバグ修正)の際はいつでも、.xsiaddon をユーザに再配付できるように再パッケージングする必要があります。

アドオンの再パッケージングとは、単にアドオンをもう一度パッケージングすることですが、その際に通常、別のファイル名を付ける必要があります。 再パッケージングの場合、マウスクリックの所要回数はわずか 2 ~ 3 回です。これは、アドオンを初めてパッケージングしたときに入力した情報がすべて再パッケージング時に自動的に入力されるためです。