Attribute Mapping with tspace_id(tspace_idによる属性マッピング)

マテリアルが複数のオブジェクトによって共有されている場合、テクスチャプロジェクションを持つアタッチされたシェーダにシェーダインスタンスデータがあると考えられます。このインスタンスデータを使用すると、マテリアルを共有する各オブジェクトに対してどのテクスチャプロジェクションを使用すべきか、シェーダに指定することができます。

インスタンスデータ値を直接参照できるシェーダコードを記述することができます。このためには、角括弧の間に tspace_id パラメータの名前を指定します。たとえば、[MyRTSNodeThatHasATexture.tspace_id]のようになります。tspace_id が現在のリアルタイムシェーダツリーにある場合、[GLSLProgram]ノードのハードウェア属性マッピングテーブルには、便宜上 tspace_id が属性として一覧表示されます。

たとえば、シェーダツリーでは以下のようになります。

ハードウェア属性マッピングテーブルは以下のようになります。

[GLSLProgram]シェーダは[OGLTexture]シェーダの tspace_id を参照し、その tspace_id に指定されているテクスチャプロジェクションを、texcoord0.xyz という名前のテクスチャ座標ハードウェアレジスタにマッピングします。

例 1

// Example of a custom realtime shader that uses hardcoded hardware mapping
extern "C" RTSHADER_API XSI_RTS_Attribute* MyNormalMapShader_GetAttributeList
(
	IRTSExecutionState *in_pExecState,
	MyNormalMapParameters_t *in_pParams,
	void **io_pInstanceData
)
{
// This shader needs vertex position and normals and 1 texture projection.
// The texture projection must be an existing parameter
// attached to the shader tree. In this example, the parameter
//called 'OGLTexture.tspace_id'
	char * l_szNormalShaderDataNeeded = "PointPosition,position.xyz,PointNormal,normal.xyz,[OGLTexture.tspace_id],texcoord0.xyz";
// The RTS 3.0 architecture expects an array of XSI_RTS_Attributes, you can use the
// GetAttributeDescriptorFromMapping API provided by the ExecutionState to create this structure for you.
	XSI_RTS_Attribute* dataNeeded = in_pExecState->GetAttributeDescriptorFromMapping ( l_szNormalShaderDataNeeded );
	return dataNeeded;
}

例 2

// Example of a custom realtime shader that uses ui-assisted hardware mapping
XSI_RTS_Attribute g_MyNormalMapShader_HardCoded_Attributes[] =
{
	XSI_RTS_ATTRIBUTE_POSITION, ePOSITION,
	"PointNormal", eNORMAL,
	"Texture_Projection", eTEXCOORD0,
	0,  eMAX_STANDARD_VERTEX_ATTRIBUTE
};
extern "C" RTSHADER_API XSI_RTS_Attribute* MyNormalMapShader_GetAttributeList
(
	IRTSExecutionState *in_pExecState,
	MyNormalMapParameters_t *in_pParams,
	void **io_pInstanceData
)
{
// A parameter on the PPG drives which attributes are needed to execute the shader
	if ( in_pParams->MyShaderTechnique == HighRes )
	{
	return in_pExecState->GetAttributeDescriptorFromMapping ( in_pParams->MyHardwareMappingWidget );
	} else{
	return g_MyNormalMapShader_HardCoded_Attributes;
	}
}