ビューポート 2.0 の dx11Shader および glslShader プラグインによってサポートされるセマンティックと注釈

アトリビュート エディタ(Attribute Editor)でパラメータの順序を変更できます。これは特に、コンパイラから返されるパラメータの順序が常に FX ファイルの宣言の順序に従っているわけではないため便利です。UIOrder が最小のパラメータが AE の最上位に示され、UIOrder が増えると他のパラメータが追加されます。

設定しない場合は、パラメータはシェーダ ファイルに表示されるのと同じ順序で配置されますが、UIOrder が指定されているパラメータの後になります。

同じ UIGroup アトリビュートを持つすべてのパラメータが、集約可能な別のパネルに並べられ、そのラベルは UIGroup 値になります。パネルは、UIOrder 値が最小のグループ パラメータの位置に挿入されます。

設定しない(または空の)場合は、パラメータは名前の付いたグループには配置されません。

SasUiMin

UIMin

uimin

float/int

(パラメータと同じ)

最小範囲値。

MUniformParameter::setRangeMin()に対応しています。

UISoftMin

uisoftmin

float/int

(パラメータと同じ)

範囲の最小スライダ値。UISoftMin より小さい値(ただし、指定されている場合は UIMin より大きい値)をパラメータの数値入力に入力できます。

MUniformParameter::setSoftRangeMin()に対応しています。

アトリビュート値で見つかった設定を使用して、int パラメータのドロップダウン メニューを作成します。

形式は MEL コマンド「attributeQuery -listEnum」と同じです。この形式は、等号記号「=」で分けられたインデックス値を指定できる、コロン「:」で区切られたフィールド名の文字列です。インデックスは 0 から始まり、アイテムのインデックス値は、明示的に指定されない場合、以前のアイテム(ある場合)が 1 ずつ増分されるインデックスになります。

たとえば、"Shaded:Wireframe=8:Bounding Box"では、値が 0、8、および 9 の 3 つのアイテムが定義されます。

TextureType

ResourceType

変数が texture[1D|2D|3D|Cube]ではなく、未指定のテクスチャとして記述されている場合、この注釈を使用してテクスチャ タイプを指定できます。有効な値は、「1D」、「2D」、「3D」、「Cube」です。

Dx11Shader では、テクニックまたはテクスチャ説明レベルのどちらかで、ロードまたは生成しなくてはならない Mip-map レベルの数をコントロールすることができます。

テクスチャ説明でこの注釈を使用します。有効な値は次のとおりです。

• <val> = 0: 影響を受けるテクスチャのすべての mip map レベルが生成されます。テクスチャに既存の mip map がある場合、それらがロードされます。たとえば、DDS テクスチャの事前計算された mip map をロードすることができます。

• <val> = 1-10 : 指定されたレベルまでの mipmap だけを生成します。

テクスチャ メモリを削減するには、dx11Shader プラグインの既定値を 1 に設定すると、最初の mip map レベル(<val>=1)だけがロード、計算されます。

これをテクスチャごとに強制して明示的にメモリの使用量を削減することもできます。

実装例を次に示します:

Texture2D DiffuseTexture
<
    string UIName = "Diffuse Map";
    string ResourceType = "2D";
    int mipmaplevels = <val>; 
>; 

この値は、テクニック注釈に設定された値よりも優先されます(texture_mipmaplevels)。詳細については、「サポートされるテクニック注釈」 を参照してください。

この注釈のサンプルについては、Maya インストールの presets¥HLSL11¥examples フォルダの AutodeskUberShader.fx を参照してください。

float3/4 (dx11Shader)

vec3/4 (glslShader)

float3/4 (dx11Shader)

vec3/4 (glslShader)

深度ピーリングおよびウェイト付けした平均値透明度アルゴリズムに使用されるテクスチャです。

LightColor、Color、

LightDiffuseColor、Diffuse、

LightAmbientColor、Ambient、

LightSpecularColor、Specular

float3/4 (dx11Shader)

vec3/4 (glslShader)

カラー パラメータ: アトリビュート エディタ(Attribute Editor)のカラー チューザ ウィジェットを使用します。

値はライトの強度でプリマルチプライされません。

float3/4 (dx11Shader)

vec3/4 (glslShader)

エリア ライトの場合、位置はエリア ライトの中心です。

リファレンス空間を注釈で指定できます。

float3/4 (dx11Shader)

vec3/4 (glslShader)

エリア ライトの 4 つのコーナーの位置です。

LightFalloff

Falloff

ShadowMapMatrix

ShadowMapXForm

float4x4 (dx11Shader)

mat4 (glslShader)

float3/4 (dx11Shader)

vec3/4 (glslShader)

位置を含む頂点バッファにこのアトリビュートをバインドするよう Maya に命令します。

float3/4 (dx11Shader)

vec3/4 (glslShader)

接線頂点バッファにこのアトリビュートをバインドするよう Maya に命令します。

float3/4 (dx11Shader)

vec3/4 (glslShader)

カラー セット頂点バッファにこのアトリビュートをバインドするよう Maya に命令します。

注:

Maya Extension 1 の新機能

glslShader の場合のみ:

現在、ストリームは 1 つだけ使用できます。

OGSFX は COLOR0 セマンティックによって定義される 1 つのカラー ストリームだけに制限されていますが、TEXCOORDx セマンティックを使用して複数のカラー ストリームを定義することはできます。

vec3 または vec4 タイプである TEXCOORDx セマンティックを使用するアトリビュートは、シェーダにカラー ストリームを伝達するために使用することができ、vec2 タイプである TEXCOORDx セマンティックを使用するアトリビュートは、UV 座標ストリームを伝達するために使用することができます。

HWS_PrimitiveBase

オブジェクトのカラー、または最初のコンポーネント、または最初のジオメトリ インスタンスを生成するために使用される整数です。(GPU インスタンス化は、ビューポート 2.0 オプション ウィンドウで有効にする必要があります)。

MUniformParameter::kSemanticHWSPrimitiveBase に対応しています。

HWS_ObjectLevel

MUniformParameter::kSemanticHWSObjectLevel に対応しています。

HWS_EdgeLevel

MUniformParameter::kSemanticHWSEdgeLevel に対応しています。

HWS_FrontCCW

MUniformParameter::kSemanticHWSFrontCCW に対応しています。

インデックス バッファ ジェネレータと mutator プラグインでカスタムのプリミティブ タイプを指定できます。通常は、追加データが含まれているインデックス バッファをシェーダに提供するために、テッセレーションに使用されます。

dx11Shader および glslShader プロジェクトには、隣接エッジ法線(PN-AEN)インデックス バッファを使用して点法線三角形を生成することができる mutator が含まれています。詳細については、「Maya 開発者ヘルプ」の「シェーダのジオメトリック データをカスタマイズする」を参照してください。

dx11Shader または glslShader の場合、これらの値を使用します。

値無し: 既定のインデックス バッファ(既定値)

「PNAEN9」または「GLSL_PNAEN9」: 三角形および隣接エッジ

「PNAEN18」または「GLSL_PNAEN18」: 三角形、隣接エッジ、ドミナント エッジ、およびドミナント頂点

インデックス mutator の登録されている名前と一致していれば、他の任意の値も許容されます。

MHWRender::MPxPrimitiveGenerator に対応しています。

(dx11Shader)

0: テクニックは常に不透明です。

1: テクニックは常に透明です。

2: テクニックの不透明度は「Opacity」セマンティックを使用する float パラメータに関連付けられ、不透明度の値が 1.0 未満の場合は透明になります。

このテクニックが高度な透明度アルゴリズム(深度ピーリングなど)をサポートするかどうかを指定します。

True の場合、このテクニックは描画コンテキスト「transparentPeel」、「transparentPeelAndAvg」および「transparentWeightedAvg」のパスを定義する必要があります。

「False」: 高度な透明度のサポート無し(既定値)

「True」: 高度な透明度をサポート

MPxShaderOverride::supportsAdvancedTransparency() に対応しています。

OverridesNonMaterialItems

このテクニックを、ワイヤフレームや選択したエッジまたは頂点コンポーネントなどの、マテリアルではない項目をレンダーするために使用するかどうかを指定します。

これは、オブジェクトのジオメトリがレンダーしたマテリアルと一致せず、選択が困難なディスプレイスメントを計算するシェーディング エフェクトに特に便利です。

「False」: マテリアルではない項目をオーバーライドしない(既定)

「True」: シェーダの UI のプリミティブを表示できるように、マテリアルではない項目のレンダーに使用

詳細については、「サポートされるパス注釈」で DrawContext を参照してください。

MPxShaderOverride::overridesNonMaterialItems()に対応しています。

Maya のアトリビュート名として(存在する場合は、UIName の代わりに)均一変数名を使用することをMayaに伝えます。

「False」: アトリビュート名として UIName を使用(既定)

「True」: アトリビュート名として変数名を使用

シェーダ ファイルに定義されている UI 名が変更された場合、保存した Maya シーンとの下位互換性を維持するために使用することができます。

このパスをこの描画コンテキストでのみ有効にすることを指定します。

複数のパスが同じ DrawContext 値を持つことができます。

MHWRender::MPassContextのパス セマンティックと一致する任意の文字列を使用できます。たとえば、次のコンテキストがサポートされています: 「colorPass」、「shadowPass」、「depthPass」、「normalDepthPass」。

空の値(または DrawContext が設定されていない場合)は、この注釈を「colorPass」に設定するのと同じです。

マテリアルではない項目をレンダーするために使用されるパスについては「nonMaterialItemsPass」に設定します。マテリアルではない項目に使用されるパスについては「selectionPass」に設定して、上記の「サポートされるテクニック注釈」で OverridesNonMaterialItems を参照してください。

現在のレンダリング プロセスがスウォッチの描画に使用されるタイミングを指定します。

ユーザは、スウォッチを描画するときに特定のパスを処理できます。