Maya 2016 Extension 2 の API の新機能

選択

• ビューポートが GPU アクセラレーション モードのときに、適切なレンダー項目インスタンスを選択できる MPxSubSceneOverride::getInstancedSelectionPath() が追加されました。詳細については、Maya Developer Kit の gpuCache サンプルを参照してください。
• handlesConsolidatedGeometry セマンティックが追加されました。False に設定すると、統合ワールド(Consolidate World)機能を glslShader が適用されるジオメトリ上で無効にすることを指定します。

  「ビューポート 2.0 の dx11Shader および glslShader プラグインでサポートされるセマンティックと注釈」および「ビューポート 2.0 でサポートされるシェーダ セマンティック」を参照してください。

描画

M3dView

• ビューポート 2.0 で M3dView::readDepthMap() が使用できるようになり、ビューポート 2.0 の深度マップから深度値を直接読み込むことができるようになりました。

  pointManip Developer Kit サンプルを参照してください。 pointManip をドラッグすると、選択したオブジェクトはマウスのレイと不透明オブジェクトの間の最も近い交差点に移動されます。これはスクリーンスペース位置と対応する深度値から計算されます。

MDrawContext

• MDrawContext::getFrameStamp() の更新頻度が、単一のフレーム内でより頻度の低いスタンプを更新するように変更されました。

  getFrameStamp() の使用例については、rawfootPrintNode と glslShader プラグインのサンプルを参照してください。

MFrameContext

• 新しいメソッド MFrameContext::getEnvironmentParameters() が追加されました。

  このメソッドは、現在のビューポートに設定された環境パラメータを返します。環境マップが現在のビューポートに設定されているかどうかを確認するため、プラグイン ハードウェア シェーダの描画フェーズで使用できます(メソッドには、シェーダに指定された MDrawContext でアクセスします)。環境が有効になっている場合、環境イメージ ファイルへのパスが指定されます。イメージは常に緯度経度形式になります。この情報はビューポートごとに設定されているため、複数のビューポートが同時に表示される場合は、後続の描画呼び出しの間で変更されることがあることに注意してください。

  現在、環境は、ハイパーシェード(Hypershade)のマテリアル ビューア(Material Viewer) でのみ使用されています。その他のすべてのビューポートに対しては、環境は常に無効に設定されています。

• オブジェクト タイプ除外スタティックが MFrameContext に追加されました。

  除外の完全なセットにアクセスできるように、MUint64 の値が返されることに注意してください。

  MUint64 objectTypeExclusions() const;

  分類文字列による除外が新しく追加されました。

  void classificationExclusions(MStringArray &classification) const;

  新しい列挙リストのサブセットを持つ列挙 MSceneRender::MObjectTypeExclusions の代わりに、MFrameContext でのスタティックを使用する必要があります。

  MUint64 タイプを返すため、MSceneRender::getObjectTypeExclusions() が追加されました。MObjectTypeExclusions を返す objectTypeExclusions() は、廃止と見なされていますが、MSceneRender::getObjectTypeExclusions() がオーバーライドされない限り、引き続き機能します。

  viewImageBlitOverride と pyViewRenderOverride.py の プラグイン サンプルは、新しい MFrameContext スタティックを使用するように更新されています。

• M3dView にアクセスせずに状態情報の照会ができるように、MFrameContext には多くの追加が行われています。これには、次のボタンが含まれています。

  • 追加の表示スタイル(列挙 MFrameContext::DisplayStyle) : シェーディングされたアクティブなオブジェクト(kShadeActiveOnly)、アクティブ コンポーネントの X 線表示(kXrayActiveComponents)、バックフェース カリングの有効化(kBackfaceCulling)、スムーズ ワイヤフレーム(kSmoothWireframe)
  • 追加のオブジェクトの除外タイプ: プラグイン シェイプ(MFrameContext::kExcludePluginShapes)、ヘッドアップ ディスプレイ(MFrameContext::kExcludeHUD)、アニメーション クリップのゴースト(MFrameContext::kExcludeClipGhosts)、グリース ペンシル描画項目(MFrameContext::kExcludeGreasePencils)を含む
  • 背景色/グラデーションの照会(MFrameContext::getBackgroundParameters())
  • 被写界深度パスに使用されるパラメータの照会(MFrameContext::getDOFParameters())
  • レンダー オーバーライド名の照会(MFrameContext::getRenderOverrideInformation())

  これらの照会を実行するためのデバッグ コードを含めるため、Maya Developer Kit のサンプル プラグイン rawfootPrintNode が変更されました。

• 座標を変換する MFrameContext::worldToViewport() メソッドと MFrameContext::viewportToWorld() メソッドが追加されました。

  このメソッドは、ワールド空間の座標をビューポートの座標に変換します。

  void worldToViewport(const MPoint &inPoint, double &xPos, double &yPos) const;

  このメソッドは、ビューポートの座標をワールド空間のニア クリップ プレーン座標に変換します。

  void viewportToWorld(double xPos, double yPos, MPoint &worldNearPt, MPoint &worldFarPt) const;

  サンプル プラグイン uiDrawManager は、2D テキストと 3D テキストを描画する際のこれらのメソッドの使用例を示しています。

MPassContext

• 現在のシェーダ オーバーライドのシェーダ インスタンスを返す MPassContext::shaderOverrideInstance() が追加されました。これにより、Maya が描画時に通常使用するシェーダ プログラムとパラメータが使用できます。

  詳細については、Developer Kit の rawFootPrintnode サンプル プラグインを参照してください。

MPxPrimitiveGenerator と MRenderItem

• 次のプリミティブ タイプがビューポート 2.0 でサポートされるようになりました。
  • MGeometry::kAdjacentLines
  • MGeometry::kAdjacentLineStrip
  • MGeometry::kAdjacentTriangles
  • MGeometry::kAdjacentTriangleStrip

  これらのプリミティブ タイプは、ビューポート 2.0 でプリミティブが設定されているすべての場所で使用できるようになりました。これには、GLSL シェーダ プラグインの新しい三角形の隣接 MPxPrimitiveGenerator が含まれます(Developer Kit の glslShader プラグイン フォルダ内の adjacentTrianglesPrimitiveGenerator.cpp を参照)。この新しいジェネレータでシルエット エッジの描画を有効化する方法のサンプルについては、SilhouetteEdge.ogsfx を参照してください(Maya インストール ディレクトリの presets¥GLSL¥examples フォルダを参照)。

MPxDrawOverride

• オブジェクトを透明で描画する必要があることを示すため、MPxDrawOverride::isTransparent() が追加されました。

  /isTransparent がジオメトリの分類 drawdb/geometry/myNode/isTransparent/ に追加されると、透明度パス中にこのプラグインが呼び出されます。

  ポスト エフェクトも考慮する必要があります。分類 drawdb/geometry/includePostEffects/ は、描画オーバーライドに確実にポスト エフェクトが呼び出されるようにします。isTransparent と includePostEffects の両方を有効にするには、分類を drawdb/geometry/rawfootPrint/isTransparent/includePostEffects に設定します。

  rawfootPrintNode プラグイン サンプルを参照してください。

ポスト エフェクトの機能強化

MPxDrawOverride は、drawdb/geometry/includePostEffects の分類を指定することで、ポスト エフェクト パスから呼び出されるオプションにすることができます。既定では、描画オーバーライドは、被写界深度、スクリーン スペース アンビエント オクルージョン、モーション ブラーなどの追加のポスト エフェクト パスに対して呼び出されません。

MPxDrawOverride::excludedFromPostEffects() を使用して、ポスト エフェクト パスに対する呼び出しから描画オーバーライドを除外できます。rawfootPrintNode プラグイン サンプルを参照してください。

新しいパス セマンティックが、MPassContext - MPassContext::kDOFPassSemantic と MPassContext::kMotionVectorPassSemantic に追加されました。これらは以前のリリースでの文字列 dofPass と motionVectorPass のチェックに相当します。ポスト エフェクト パターン パスと非ポスト エフェクト パターン パスを示すため、MPassContext::kPEPatternPassSemantic と MPassContext::kNonPEPatternPassSemantic がそれぞれ追加されました。

投影マトリックスが、変換時にポイントの Z コンポーネントを反転するかどうかを示す ProjectionZSense セマンティックが追加されました。反転する場合、この値は -1.0 で、それ以外の場合は 1.0 です。「ビューポート 2.0 でサポートされるシェーダのセマンティック」を参照してください。

これらのパスの詳細については、「エフェクト インタフェース」を参照してください。

シェーダ

MShaderInstance

• MShaderInstance::requiredVertexBuffers() メソッドを使用すると、指定したシェーダ インスタンスの頂点バッファ記述子のリスト(MVertexBufferDescriptorList)を照会できます。

  特に、サブシーン オーバーライドは、カスタムのレンダー アイテムにシェーダ インスタンスを使用する際にこのメソッドを利用できますが、このメソッドはこのオーバーライドのコンテキスト外で呼び出すことができます。

  このメソッドは、GLSL シェーダ プラグインで使用されます。Developer Kit の glslShader を参照してください。MVaryingParameter を構成するために結果が調査される GLSLShaderNode クラスで configureGeometryRequirements() を参照してください。

• MShaderManager::getShaderFromNode() インタフェースと MRenderItem::setShaderFromNode() インタフェースに、ユーザが非テクスチャ エフェクトのインスタンスを使用できるようにする新しいブール演算引数 nonTextured が追加されました。

  上記の「描画」セクションの MPxPrimitiveGenerator and MRenderItem を参照してください。

• シェーダ インスタンスのテクニックのリストを返す MShaderInstance::techniqueNames() メソッドが追加されました。このメソッドは、Python API 2.0 でも使用できます。

  エフェクト ファイルをロードし、定義されたテクニックの名前を抽出する同様のメソッド MShaderManager::getEffectsTechniques() が現在存在しています。ただし、この関数が使用できるのは、ファイルからエフェクトをロードするときだけで、文字列バッファからエフェクトをロードするときには使用できません。エフェクトがロードされたら、新しい MShaderInstance::techniqueNames() を使用できます。

MShaderManager

• MShaderManager::getEffectsFileShader() や MShaderManager::getEffectsBufferShader() などの MShaderManager でさまざまなインタフェースのいずれかを介してシェーダを取得する際に、シェーダ コンパイルの失敗が発生すると、エラーが Windows および Linux の出力ウィンドウ(Output Window)と Mac のコンソールに出力されます。これはシェーダ開発者のデバッグ プロセスに役立ちます。

  シェーダを返せない場合は、NULL 値が返されます。

  これは、文字列バッファ メソッド MShaderManager::getEffectsBufferShader() が使用されている場合に特に当てはまります。以前にエラー シェーダが返された場合、エラーが発生した場合に認識するのが難しくなります。

• MRenderItem::setShaderFromNode() インタフェースと MShaderManager::getShaderFromNode() インタフェースに、ユーザが非テクスチャ エフェクトのインスタンスを使用できるようにする新しいブール演算引数 nonTextured が追加されました。

  MRenderItem::setShaderFromNode() は、内部エフェクトのインスタンスを公開しないため、推奨されるインタフェースです。その使用方法は、Developer Kit の apiMeshShape プラグイン サンプル(apiMeshSubSceneOverride.cpp)で説明されています。

  このサンプル プラグインは、以前は、シェーディング モードとテクスチャ モードの両方にレンダー項目を 1 つだけ作成していました。新しいバージョンでは、シェーディング モードとテクスチャ モードにぞれぞれ 1 つずつ、合計 2 つのレンダー項目が作成されます。これらのエフェクト インスタンスはどちらも MRenderItem::setShaderFromNode() で割り当てられますが、ブール値の引数 nonTextured は、シェーディングのレンダー項目に対しては true に設定され、テクスチャのレンダー項目に対しては false に設定されます。

MPxShaderOverride

• ビューポート 2.0 は、既定では、完全に共有されていないデータを返しません。この要件を指定するために新しいインタフェースが追加されました。

  bool MPxShaderOverride::requiresUnsharedGeometricStreams()

  プラグインはこのメソッドをオーバーライドして、ジオメトリ ストリームの拡大を強制するために true を返すことができます。

• シェーディング エフェクトのジオメトリ要件を更新する際に、フェース ID、頂点 ID、ローカル UV 座標を要求するため、次のセマンティックがサポートされるようになりました。詳細については、MPxShaderOverride::addGeometryRequirement() を参照してください。
  • vertexid: 設定すると、頂点 ID バッファが返されます。
  • faceid: 設定すると、フェース ID バッファが返されます。
  • uvcoord: 設定すると、ローカル UV 座標が返されます。
  注:

  「ハードウェア レンダリングのジオメトリ リマッピング」を参照してください。

• Developer Kit の hwPhongShader プラグイン サンプルは、次のことを示します。
  • 環境変数 MAYA_HWPHONG_TEST_VERTEXID_AND_FACEID を任意の値に設定すると、このサンプルは頂点 ID とフェース ID を、旧式の既定ビューポートとビューポート 2.0 の両方の出力ウィンドウに出力します。
  • 環境変数 MAYA_HWPHONG_TEST_LOCALUVCOORD を任意の値に設定すると、このサンプルは、ローカル UV 座標を旧式の既定ビューポートとビューポート 2.0 の両方の出力ウィンドウに出力します。
  • 環境変数 MAYA_HWPHONG_TEST_INDEXING を任意の値に設定すると、ID と UV 座標にアクセスするインデックスが、旧式の既定ビューポートとビューポート 2.0 の出力ウィンドウにローカル三角形のインデックスを出力します。
  • MPxShaderOverride::requiresUnsharedGeometricStreams() メソッドは、hwPhongShaderOverride に対して true を返すようにオーバーライドされます。
  • hwPhongShaderOverride の initialize() メソッドは、追加ストリーム要件の vertexid、faceid、uvcoord を指定します。
  • hwPhongShaderOverride の draw() メソッドは、vertexid、faceid、および uvcoord の頂点バッファを抽出し、そのデータを出力します。
  注:

  MAYA_TEST_VERTEXID_AND_FACEID 環境変数が設定されている場合に、トポロジが 4 フレームごとに変更する立方体を生成する、animCubeNode のサンプルも参照してください。hwPhongShader がこのシェイプに割り当てられている場合、シェーダは animCubeNode プラグインから生成される頂点 ID とフェース ID を受け取ります。

MPxHwShaderNode

• 既定では、旧式の既定ビューポートは共有されていないデータを返します。

  以前は、頂点 ID は MPxHwShaderNode::provideVertexIDs() メソッドを使用して照会できました。新しい MPxHwShaderNode::provideFaceIDs() メソッドを使用してフェース ID が照会できるようになりました。新しい MPxHwShaderNode::provideLocalUVCoord() メソッドを使用して、ローカル UV 座標を照会できるようになりました。

  この署名を持つデータを返す、新しいメソッドがあります。

  MStatus    MPxHwShaderNode::geometry( const MDrawRequest& request,
          M3dView& view,
          int prim,
          unsigned int writable,
          int indexCount,
          const unsigned int * indexArray,
          int vertexCount,
          const int * vertexIDs,
          const float * vertexArray,
          int normalCount,
          const float ** normalArrays,
          int colorCount,
          const float ** colorArrays,
          int texCoordCount,
          const float ** texCoordArrays,
          const int *faceIDs,
          const float * localUVCoord)

  Mstatus MPxHwShaderNode::glGeometry( const MDagPath& shapePath,
          int prim,
          unsigned int writable,
          int indexCount,
          const unsigned int * indexArray,
          int vertexCount,
          const int * vertexIDs,
          const float* vertexArray,
          int normalCount,
          floatArrayPtr normalArrays,
          int colorCount,
          floatArrayPtr colorArrays,
          int texCoordCount,
          floatArrayPtr texCoordArrays,
          const int * faceIDs,
          const float * localUVCoord)

  blindDataShader と hwPhongShader プラグインのサンプルは、どちらもこのインタフェースを使用して頂点 ID とフェース ID を取得する方法を示しています。

  blindDataShader のサンプルは、対応するフェース ID のグレースケール値を返します。

  返される UV 座標、フェース ID、頂点 ID は、ビューポート 1 とビューポート 2.0 の MPxShaderOverride インタフェースで同じです(ビューポート 2.0 インタフェースが共有されていないデータを求める場合)。

  メッシュがスムーズ メッシュ プレビューを使用している場合、フェース ID にはスムーズされていない元のメッシュが返されるのに対し、頂点 ID にはスムーズされたメッシュが返されます。

MRenderItem

• MRenderItem::sourceDagPath() は、項目に統合されたジオメトリ(MRenderItem::isConsolidated())が含まれている場合でも、常に DAG パスを返します。統合されると、ジオメトリに影響を及ぼすすべての DAG パスのうち、1 つの DAG パスを返します。描画時に統合されたジオメトリから DAG パスとジオメトリを抽出する詳細については、「ドキュメントの更新」を参照してください。

  このインタフェースは DAG パスの適切なリストを返すため、MRenderItem::sourceIndexMapping() の使用をお勧めします。

テクスチャ

MTextureManager

• MTextureManager::acquireTexture() メソッド:

  MTexture* MTextureManager::acquireTexture(const MString& textureName, const MPlug& plug, int width, int height, bool generateMipMaps = true);

  ファイル テクスチャ ノードへのプラグが指定されている場合に、ディスクからのテクスチャ読み取りを試行するように変更されました。以前は、このメソッドは Maya ソフトウェア レンダラのソリッド テクスチャへの変換機能を使用して、テクスチャをベイク処理していました。この変更により、返されるテクスチャの忠実度と精度が向上します。

• 新しい MTextureManager::acquireTexture() メソッド:

  MTexture* MTextureManager::acquireTexture(const MObject& textureNode, bool allowBackgroundLoad = false); 

  指定されたテクスチャ ノードからファイル テクスチャをロードします。このメソッドはより単純なインタフェースを提供するため、ファイル テクスチャに(前述のプラグ メソッドよりも)推奨されるメソッドです。ファイル テクスチャ ノードを引数にとり、不要なパラメータ(幅、高さ、名前、ミップマップ作成)を指定する必要がなくなります。

  また、ビューポート 2.0 のテクスチャのバックグラウンド ロード機能を使用するかどうかを示すオプションを公開します。テクスチャのバックグラウンド ロードの詳細については、『Maya ユーザ ガイド』の「表示プリファレンス」セクションの「マテリアル ロードのモード」を参照してください。

• 新しい MTexture::update() メソッド:

  MStatus MTexture::update(const MObject& textureNode);

  ファイル テクスチャ ノードを使用して、取得に対して更新できます。

  現在、すべてのファイル テクスチャ ベースのメソッドには、ファイル テクスチャが UV タイリングを使用している場合に最初のタイルを返す制限があります。

• これらのメソッドの使用方法のデモについては、hwApiTextureTest Developer Kit サンプルを参照してください。このプラグイン サンプルには、シーン内の既存のファイル テクスチャ ノードから MTexture リファレンスの取得を試行する -n/-nodeLoad オプションが含まれています。このオプションは、選択したプロシージャ ノードからその outColor アトリビュートをサンプリングすることで、ベイク処理されたテクスチャの作成も試行します。
• viewOverrideTrackTexture Developer Kit サンプルを参照してください。これはプラグインのレンダー オーバーライドで、アクティブにすると、シーン内の最初のファイル テクスチャ ノードを検索して、MTexture の取得または更新を行います。この MTexture は、レンダー オーバーライドに使用されるメイン操作の、クアッド レンダリング操作に使用されます。

ライティング

Maya 2016 Extension 2 では、ビューポート 2.0 はライト制限までしかライトを評価しません。したがって、オンデマンドでライトの情報を要求する場合は、新しい MRenderer::needEvaluateAllLights() メソッドを呼び出す必要があります。

プラグインは、次のインタフェースを呼び出します。

• MDrawContext::getLightInformation(kFilterIgnoreLightLimit)

• MRenderer::setLightsAndShadowsDirty()

• MRenderer::setLightRequiresShadows()

描画する前に、最初にこのメソッドを呼び出す必要があります。

既存のプラグインを変更しない場合は、optionVar MAYA_VP2_IGNORE_EVALUATION_LIGHT_LIMIT=1 を設定して、プラグインが Extension 2 以前と同じように機能し続けるようにすることもできます。この optionVar を設定すると、プラグインがロードされているかどうかに関係なく、シーン内のすべてのライトが常に評価されます。結果として、シーンに多数のライトがある場合は、この optionVar によってビューポート 2.0 のパフォーマンスが低下する場合があります。

これを軽減するには、プラグインがすべてのライトを評価する必要がなくなったら、この optionVar を 0 に再設定して、ライト制限までのライトだけを評価するようにビューポート 2.0 を元に戻すことができます。

ジオメトリ

• MGeometryExtractor が以下をサポートするようになりました。

  • プラグイン シェーダで、テクスチャ座標の複数の UV マップ セット
  • プラグイン シェーダで、接線と従法線の座標に指定されたマップ セット

  geometryReplicator サンプル プラグインは、これらの新しい機能のサポートについて示します。

• MPxSubSceneOverride::setGeometryForRenderItem() インタフェースが更新され、頂点バッファ(MGeometry::kPoints など)を使用して描画のジオメトリを定義する際に、MIndexBuffer の指定が不要になりました。このケースでは、GPU メモリの浪費を回避するために、空の MIndexBuffer を指定できます。実装例については、gpuCache Developer Kit プラグインを参照してください。

ロケータ

• MPxLocatorNode::draw() は、常にセット kWireframe を受け取る代わりに、適切な M3dView::DisplayStyle が渡されるようになりました。

カメラ

• 正規化されていないクリップ値を取得するため、次の関数が追加されました。
  • MFnCamera::unnormalizedNearClippingPlane() 関数は、ニア クリップ プレーンまでの距離を返します。
  • MFnCamera::unnormalizedFarClippingPlane() 関数は、ファー クリップ プレーンまでの距離を返します。

    カメラ セットのために正規化されたクリップ プレーンが計算されることがあります。これは既存の MFnCamera::nearClippingPlane() メソッドと MFnCamera::farClippingPlane() メソッドで返される値です。これらの新しいメソッドを使用すると、元のカメラのクリップ プレーンにアクセスできます。

• クリップ プレーンと正規化されていないクリップ プレーンを取得するための新しいメソッドは、ビューポート 2.0 の描画コンテキストの一部として使用できるようになりました。

  次の列挙が MFrameContext に追加されました。

  • MFrameContext::kViewNearClipValue //!< カメラ ニア クリップ値(単一の値)

  • MFrameContext::kViewFarClipValue //!< カメラ ファー クリップ値(単一の値)

  • MFrameContext::kViewUnnormlizedNearClipValue //!< 正規化されていないカメラ ニア クリップ値(単一の値)

  • MFrameContext::kViewUnnormalizedFarClipValue //!< 正規化されていないカメラ ファー クリップ値(単一の値)

  MDrawContext::getTuple() メソッドから使用できます。

  これらは、MFnCamera::nearClippingPlane()、MFnCamera::farClippingPlane()、MFnCamera::unnormalizedNearClippingPlane()、MFnCamera::unnormalizedFarClippingPlane() をそれぞれ使用した場合と同じ結果になります。

  詳細については、rawfootPrintNode サンプル プラグインを参照してください。「カメラ情報」も参照してください。

レンダー オーバーライド

MQuadRender

• MRenderOverride のクアッド レンダリング操作で使用されるシェーダ インスタンスのメモリ リークの防止に役立つように修正されました。
• MRenderOperation::targetOverrideList() メソッドで指定されている MRenderTarget が、MQuadRender::shader() から返された MShaderInstance への入力としても指定されている場合、レンダリング中の同じターゲットからの読み取りと書き込みに問題が発生しないように修正されました。

  viewRenderOverride と viewRenderOverridePostColor の Developer Kit サンプルを参照してください。

• MRenderOverride で MSceneRender と一連の MQuadRender を使用して、ポスト シーン カラー エフェクトを実行する方法を示すため、新しいプラグイン サンプルが追加されました。Developer Kit の viewRenderOverridePostColor と「ポスト シーン レンダリング カラー操作」を参照してください。
• 以前は、シーンまたはクアッド レンダリング操作で現在の出力ターゲットよりも大きいレンダー ターゲット(ビューポートなど)を指定すると、出力ターゲット内のピクセルのサブセットを引き寄せる操作になっていました。この問題は解決されています。

  アクティブな出力ターゲット サイズよりも大きいカスタム出力ターゲットを引き寄せるサンプル コードについては、viewRenderOverrideMRT プラグインを参照してください。

ツールとコンテキスト

MPxContext

• 新しいメソッド MPxContext::doPtrMoved() が追加されました。このメソッドは、マウスの動作を次の動作をドライブするために使用できるように、マウスの移動時に呼び出されます。

  描画の場合、ビューポート 2.0 で描画を実行するために MUIDrawManager が使用されている場合に、プラグインがこのメソッドをオーバーライドします。

トレーシング/シーケンス

評価順序を追跡し、内部パイプラインがレンダリング可能なリストの実行を追跡するため、いくつかのオーバーライド クラスにデバッグ トレーシング情報が追加されました。

MPxDrawOverride と MPxGeometryOverride に新しいトレーシング メソッド(MPxDrawOverride::traceCallSequence() や MPxDrawOverride::handleTraceMessage() など)が追加され、ogs コマンドに新しいトレース オプション(-traceRenderPipeline フラグ)が追加されました。

詳細については、「ビューポート 2.0 パイプラインの基本的なシーケンス」と「ビューポート 2.0 オブジェクトの基本的なシーケンス」を参照してください。

プロファイリング

プロファイラ(Profiler)がビューポート 2.0 (Viewport 2.0)内で実行するレンダリング イベントをグラフ化するようになりました。これらのイベントには、ノード評価と描画可能 UI リスト/レンダー リストの構築、および UV エディタ(UV Editor )描画、ビューティ パス レンダー、描画可能 UI レンダリング(マニピュレータの描画など)といった描画イベントが含まれます。レンダー オーバーライド プラグインを使用している場合、クアッド レンダー、3D シーンのレンダー、HUD レンダーなどの操作も表示されます。

この機能を使用すると、シーンのパフォーマンスのボトルネックとなる可能性があるレンダリング イベントまたはパスを特定できます。

これらのイベントをフィルタするには、プリフィックス Vp2 を検索します。

ビューポート 2.0 でのレンダリング イベントの詳細、および各イベントの詳細については、「プロファイルのビューポート 2.0 のレンダリング イベント」と「ビューポート 2.0 のレンダリング イベントのプロファイラ サンプル」を参照してください。

レンダー セットアップ

Maya の新しいレンダー セットアップ機能にアクセスできるように、新しい MRenderSetup クラスが追加されました。