カスタム頂点データ

mental ray for Maya は、ポリゴン メッシュに対して、固定のプリフィックス「miCustomTex」がついた追加のカスタム アトリビュートをチェックします。

このプリフィックスの後の文字は、すべてカスタム データの名前とみなされます。たとえば、MyData は「miCustomTexMyData」のアトリビュート名です。次の要件を満たす場合に、これらのデータ アトリビュートは認識され、追加の mental ray テクスチャ空間に変換されます。

• データ アトリビュートが次の型のとき(MEL で):
  • Int32Array
  • doubleArray
  • vectorArray
  • pointArray
• 個々のアトリビュート(Maya API で):
  • MFnIntArrayData
  • MFnDoubleArrayData
  • MFnVectorArrayData
  • MFnPointArrayData
• 配列データ要素数は、メッシュ オブジェクト内の頂点数にぴったり一致します。

これらの配列アトリビュートは、MEL かあるいは Maya API で作成できます。こういった配列アトリビュートには、起動処理時に値が必要となります。値が入っていない場合は無視されます。

配列アトリビュートのデータ要素は、提示されている順序でメッシュの頂点にアタッチされます。配列アトリビュートのデータ型は、データ型に従って、mental ray の 1 つまたは複数のテクスチャ空間を占めます。これは、いずれの場合も float (浮動小数点数)フォーマットにデータ型変換が行われることを示しています。また、この機能により頂点データは三角形上の現在の交差ポイントに対して自動的に補間されます。

特定のカスタム配列で実際に使用されるテクスチャ スペースの情報はまだありません。現在の mental ray for Maya では、既定でテクスチャ スペースがちょうど 1 つだけ、テクスチャリング向けに予約されていますしかし、メッシュは複数の UV 空間を保持できます。したがって、すべてのカスタム頂点データは任意のテクスチャ空間のオフセットで開始されます。複数のカスタム配列がメッシュにアタッチされている場合は、ノード上に一覧化されているアトリビュートの順序が、mental ray のテクスチャ空間シーケンスを定義します。

データにおけるこの実際のレイアウトは、このデータを使用するシェーダに提供される必要があります。これに対しては、現状では 2 つの方法が実装されています。ユーザ データとカスタム テキスト置換です。ユーザ データのアプローチは、ユーザのデータ ブロックを mental ray のメッシュ オブジェクトにアタッチするものです。このデータ ブロックはシェーダから取り出すことができます。データ ブロック maya_vertexdata の宣言は、mayabase.mi 宣言ファイルに入っています。

カスタム テキストがメッシュのマテリアルに適用されている場合は、特殊なプレースホルダ構文により、パラメータ値の便利な割り当てが可能になります。次のプレースホルダがサポートされています(以下の例では、最初のカスタム アトリビュートとして「MyData」という名前が検出された、vector 型のカスタム データを想定しています)。

int "$MyInt"
int offset "$MyIntOffset"
int type "$MyIntType"
int size "$MyIntSize"
double "$MyDouble"
double offset "$MyDoubleOffset"
double type "$MyDoubleType"
double size "$MyDoubleSize"
vector "$MyVector"
vector offset "$MyVectorOffset"
vector type "$MyVectorType"
vector size "$MyVectorSize"
point "$MyPoint"
point offset "$MyPointOffset"
point type "$MyPointType"
point size "$MyPointSize"
"offsets" [$MyInt $MyDouble $MyVector $MyPoint]
"sizes" [$MyIntSize $MyDoubleSize $MyVectorSize $MyPointSize]
"types" [$MyIntType $MyDoubleType $MyVectorType $MyPointType]

int "1"
int offset "1"
int type "1"
int size "1"
double "2"
double offset "2"
double type "2"
double size "1"
vector "3"
vector offset "3"
vector type "3"
vector size "3"
point "4"
point offset "4"
point type "4"
point size "4"
"offsets" [1 2 3 4]
"sizes" [1 1 3 4]
"types" [1 2 3 4]

data "plane:vxdata"
	"maya_vertexdata" (
		"magic" 1298749048,
		"data" [{
				"name" "Int",
				"type" 1,
				"size" 1,
				"offset" 1
				},{
				"name" "Double",
				"type" 2,
				"size" 1,
				"offset" 2
				},{
				"name" "Vector",
				"type" 3,
				"size" 3,
				"offset" 3
				},{
				"name" "Point",
				"type" 4,
				"size" 4,
				"offset" 4
				}
			]
		)