シーンのロード完了後の値の設定(補助ファイル)

追加データファイルには、シーンのロード終了後に設定できる一連の値が含まれています。すべてのパラメータは、登録済みの On End Scene Open イベントの前に順次設定されます。

追加データを使用するとシーンファイルを変更せずにシーンのさまざまなパラメータを簡単に変更できるため、バッチレンダリングなどで特に便利です。

注:

SI3D シーンおよび SI3D モデルに追加データを直接適用することはできません。まず SI3D シーンまたは SI3D モデルを読み込み、Softimage シーンフォーマットで保存する必要があります。

追加データをロード、適用する

Softimage で追加データを適用するには、-auxiliary_data スイッチで設定したい値を含むファイルを指定する必要があります。

追加データファイルの名前が c:¥myData.txt の場合は、次のコマンドを入力します。
```
xsi -auxiliary_data c:\myData.txt
```
これで、[シーンを開く]ダイアログボックスに[Apply Auxiliary Data]という新しいチェックボックスが作成されます。
このオプションをオンにして、シーンを開く際に追加データを適用します。追加データが正確に適用されたかをテストする非常に便利な方法です。

スクリプトで追加データを適用するには

スクリプトを使用して、あらかじめロードされた追加データを適用できます。たとえば、追加データを c:¥MyProject¥Scenes¥MyScene.scn というシーンに適用したい場合は、次のコマンドを入力します。

OpenScene "c:\MyProject\Scenes\MyScene.scn",,TRUE

注:

インタフェースとスクリプトのどちらを使用した場合でも、既定で追加データは適用されません。

コマンドラインから追加データを適用するには

コマンドラインから追加データをシーンに自動的に適用するには、プロンプトで次のいずれかの行を入力します。

xsi c:\MyProject\Scenes\MyScene.scn -auxiliary_data c:\myData.txt

または

XSIBatch -r -scene c:\MyProject\Scenes\MyScene.scn -auxiliary_data c:/myData.txt

追加データファイルを定義する

追加データのファイルフォーマットは、単純な ASCII ファイルです。このファイルの冒頭には、次のヘッダーを付ける必要があります。

XSI_AuxiliaryDataFile ASCII 1 0

このヘッダで、ファイルが単純な ASCII 形式の v1.0 の追加データファイルとして識別されます。現在のところ他のフォーマットはありませんが、将来的には他のフォーマットが導入される可能性があります。

ヘッダに続く行は次のようになります。