ユーザデータとは

ユーザデータとは、Autodesk Softimage シーン内のコンポーネントまたはオブジェクトに格納する任意のデータを指します。ユーザデータは、BLOB(Binary Large OBject)またはデータ値(整数、ブール値、文字列など)として保存できます。

ヒント:

www.msdn.microsoft.comでは、BLOB をバイナリデータ(グラフィックス、サウンド、コンパイルコードなど)を含むデータ列のタイプと定めています。

これらのデータ形式は、主に以下の 4 つのカテゴリに分類されます。

オブジェクトレベルのバイナリユーザデータ:「カスタムプロパティ」を参照してください。

非バイナリのユーザデータ(文字列値、数値、ブール値など)は、スクリプトコマンドまたはオブジェクトモデルから直接アクセスできるカスタムプロパティを使ってオブジェクトに格納できます。

これらのマップはオブジェクトに直接アタッチされます(「バイナリユーザデータを格納できるエレメント」を参照)。データは、プロパティページを使って表示、更新できます。
オブジェクトレベルのバイナリユーザデータ:「バイナリユーザデータをオブジェクトにアタッチする」を参照してください。

UserDataBlobs または UserDataBlobs にはバイナリユーザデータ(BLOB)が含まれ、スクリプトコマンドまたはオブジェクトモデルを使用して直接アクセスできます。

これらの BLOB はオブジェクトに直接アタッチされ(「バイナリユーザデータを格納できるエレメント」を参照)、Softimage から mental ray にレンダリングデータを移動するように設計されています。

注:
UserDataBlob オブジェクトはスクリプトで使用するより、C++ と一緒に使用する方がより簡単かつ効率的です。そのため、C++ API バージョンの実装をお勧めします。
コンポーネントレベルのバイナリユーザデータ:「コンポーネント上のバイナリユーザデータにアクセスする」を参照してください。

UserDataMaps または UserDataMaps にバイナリユーザデータ(BLOB)に対するコンテナであり、スクリプトコマンドまたはオブジェクトモデルを使用して直接アクセスできます。

これらのマップはサブコンポーネントのクラスタにアタッチされます(「バイナリユーザデータを格納できるエレメント」を参照)。マップ内にあるデータの表示や更新は、ユーザインターフェイスから行うことはできません。
テンプレート化されたコンポーネントレベルのバイナリユーザデータ:「コンポーネント上のユーザデータテンプレートにアクセスする」を参照してください。

このタイプのユーザデータコンテナにより、プラグイン開発者は、ユーザが指定されたオブジェクトにデータを関連付ける前に、割り当てるデータのタイプを決めておくことができます。つまり、これは、指定されたクラスタに関連付けることができるユーザデータのタイプを宣言するテンプレートまたはマスクを作成するメカニズムです。

プラグイン開発者がユーザデータテンプレートを作成するには、ユーザインターフェイスでカスタムパラメータページを作成してから、スクリプトコマンドやオブジェクトモデルを介してそのパラメータセットをユーザデータマップに割り当てます。

バイナリユーザデータを格納できるエレメント

Autodesk Softimage では、あらゆるシーンオブジェクトやマテリアル、シェーダ、アクションのユーザデータをサポートしています。また、ポイント、頂点、ノット、セグメント、エッジ、カーブ、ファセット、サーフェイスなど、あらゆるサブコンポーネントエレメントのユーザデータもサポートしています。

注:

SI|3D と Autodesk Softimage はどちらもユーザデータをサポートし、SI|3D のユーザデータを Softimage に読み込むことができます。詳細については、「SOFTIMAGE|3D のユーザデータを読み込む」を参照してください。

ユーザデータをオブジェクトに格納するには UserDataBlobs または UserDataBlobs を使用し、コンポーネントに格納するには UserDataMaps または UserDataMaps を使用します。

バイナリユーザデータの一般的な使用方法

ユーザデータは、SI|3D や Autodesk Softimage、独自仕様のソフトウェア、あるいはゲームのプラットフォームやプラグインに存在するため、シーンデータ間で送受信できる情報として使用できます。

シナリオ	ユーザデータを使った実行方法
ポリゴンにフラグを追加する	ゲームでは、メッシュ内の特定のポリゴンに適用する必要があるさまざまなレンダリング機能をリアルタイムで使用します。たとえば、自動車のウィンドウに対して反射するレンダリングを実行したり、放射カラーエフェクトをエンジンの排気エリアに追加したりすることができます。また、ポリゴンを選択し、選択したポリゴンに衝突回避のタグを付ければ、廊下の天井からつり下げたくもの巣をプレイヤーと衝突させないようにすることができます。
メッシュ内の頂点にタグを付けて番号付けする	特定の方法でエフェクトがメッシュ内を移動しなければならない場合があります。この処理は、エフェクトがメッシュ内を進む順番で頂点にフラグを付けることで実現されます。たとえば、稲妻の衝撃は、メッシュ上のフラグが付いたポイント間をジャンプするよう設定できます。
変数のウェイティングをメッシュの指定された領域に組み込む	ボーンの回転に基づいて、変数のウェイティングをポイントに割り当てておくと便利です。これで、キャラクタの肘や膝をアニメートしやすくなるため、ポリゴンが不完全に交差することはなくなります。ポイント上のこれらの注釈情報を使用して、エンジンは変数のセットからポイントを読み取り、エンジン内でアクションを実行できます。
mental ray までシェーダ情報を伝える	オブジェクトのシェーダ情報を格納するように記述できます。この情報は後でレンダ(mental ray など)で取得することができます。
プラグインがシーン内で独自の状態を維持する	状態情報は簡単なデータ値(CustomProperty オブジェクトの使用により)またはバイナリ値(UserDataBlob の使用により)としてシーン内部に格納できます。このため、カスタムコマンドやそのほかのプラグインが実行されるたびに、前回の終了状態から継続することができます。

ユーザ データとは

ユーザデータとは