レンダー項目に示される正式なインタフェースは、MRenderItem クラスです。

図 15

MRenderItem にはさまざまなプロパティがあります。レンダー項目が更新フェーズまたはレンダリング フェーズに関連しているかどうかに応じて、これらのプロパティのインタフェースは、書き込み可能である場合とない場合があります。

主なプロパティは次のとおりです。

• 関連付けられている Maya DAG パスおよび可能な Maya DAG コンポーネント。これらは、任意のタイプの評価アクセスとは対照的に、Maya に関するレンダー項目のコンテキストを提供します。

• カスタム データ。これは、プラグイン作成者が必要に応じてアタッチし、パイプラインを通して渡すことができるデータです。これは読み取り可能および書き込み可能です。

• 項目のバウンディング ボックス。

• 項目が「有効」であるかどうか。有効になっているすべてのものは、レンダリング フェーズで描画されるようにタグ付けされます。

• 描画モード。このレンダー項目が描画される描画モード。

• シェーダのインスタンスへの参照。

• ジオメトリ情報への参照。次のものが含まれます。

  • ジオメトリとそのフォーマットの説明への参照
  • ジオメトリ インデックスとプリミティブ タイプの参照。

• 深度の優先順位

  深度の優先順位は、描画時にレンダー項目がアクティブなカメラに向かって移動する距離を設定します。これは、深度が相互にオーバーラップする描画を使用するレンダー項目で発生する可能性がある深度の競合を防ぐのに役立ちます。たとえば、レンダー項目の描画ワイヤフレームと別の塗り潰し描画が同じ深度で描画される場合があります。ワイヤフレーム項目がシェーディング項目によって隠されないようにするために、ワイヤフレーム項目の深度の優先順位を「高く」して隠されるのを回避できます。

図 16

これらのプロパティにより、このクラスは次の Maya オプションのいずれかまたはすべてを表すことができます。

• 一部の依存「サブオブジェクト」をレンダリングする項目(頂点コンポーネントなど)
• サブ領域をレンダリングする項目(メッシュ上のフェース セットなど)
• インスタンスごとにレンダリングする項目
• DAG オブジェクト ゴーストごとにレンダリングする項目(ゴースト化)
• 特定の描画モードを表現するためにレンダリングする項目(たとえば、「ワイヤフレーム」の項目と「シェーディング」の項目)

単一のレンダー項目ではすべての可能性を表せないので、レンダー項目のコレクション(MRenderItemList)がレンダリング可能オブジェクトごとに保持されます。ただし、レンダリングする必要があるものによっては、これらの項目のゼロまたは複数が描画に対して「有効」になる(パイプラインを渡される)可能性があります。

図 17

例として、レンダリング可能オブジェクトは、4 つの項目(シェーディング サブ領域用に 2、ワイヤフレーム用に 1、頂点表示用に 1)を持つことがあります。更新時に削減が行われて、ワイヤフレームおよび頂点の表示項目だけが残ります。さらに削減が行われて、「ワイヤフレーム」レンダー項目が除去され、頂点表示項目だけが残ることがあります。削減は通常、ビューポート表示モードなどの内部要件を反映します。

MRenderItem オブジェクトは一時的とみなされるので、このクラスのインスタンスへの参照をプラグインでは保持できません。MRenderItem のインスタンスを直接作成したり、削除することはできません。プラグインは、MRenderItem でスタティックな Create() および Destroy() メソッドを使用する必要があります。これにより、メモリを異なる DLL から割り当てる/割り当て解除するときに安定します。