Maya 2017 の API の新機能

フラグメント レンダラ

サンプル プラグイン viewRenderOverrideFromFragments が追加されました。これはシーンおよび希望するポスト エフェクトをレンダリングするためにスクリプト フラグメントとフラグメント グラフを使用できるように、新しい API セットの使用を示します。スクリプト フラグメントは、標準ビューポート レンダリングのエフェクト用に Maya 内部で使用される構築ブロックで、Maya インストール フォルダ内の bin/ScriptFragment フォルダにある一連の .xml ファイルに保存されています。

次の API クラスとインタフェースが追加され、フラグメント レンダラの作成が可能となりました。

• シーンのレンダリングに使用するフラグメントの名前を指定できる、新しい MSceneRender コンストラクタが追加されました。

  MSceneRender (const MString &name, const MString &fragmentName)

• レンダラ入力値の読み取りまたは書き込みに使用できる MRenderParameters クラスが追加されました。
• レンダラのコントロールに使用するレンダラ入力パラメータのブロックである、MRenderParameters クラスへのポインタを返す MSceneRender::getParameters() メソッドが追加されました。
• シーンのレンダリング時に使用するスクリプト フラグメントまたはフラグメント グラフの名前を返す MSceneRender::fragmentName() メソッドが追加されました。
• MRenderScriptCallback クラスが追加されました。

  登録してスクリプト フラグメント .xml から呼び出すことができるコールバック関数を、このクラスから派生させて作成します。execute() 関数が実装され、現在のレンダラ グラフから MRenderParameters を、およびスクリプトから 3 つのオプション値を取得することができます。このメソッドを使用して目的の動作を計算し、MRenderParameters::setParameter() を呼び出し、スクリプトまたはグラフ内の接続された他のフラグメントに結果を戻します。詳細については、「スクリプト フラグメント コマンド」トピックの呼び出しコマンドについての説明を参照してください。

• MRenderer::registerScriptCallback() および MRenderer::deregisterScriptCallback() インタフェースが追加され、MRenderScriptCallback の登録または登録解除が可能となりました。登録した後に、スクリプト フラグメント .xml で 呼び出しコマンドを使用して、このコールバックを呼び出すことができます。
• MFragmentManager::addFragmentGraphFromFile() を使用して、フラグメント マネージャにスクリプト フラグメントおよびフラグメント グラフを登録します。このインタフェースは、以前はシェーディング フラグメントおよびシェーディング フラグメント グラフをサポートするためのものでしたが、カスタム フラグメント レンダラを作成できる新しい機能を提供するものとして、新しいクラスおよびインタフェースに追加されました。

「ビューポートへのレンダリング用にフラグメントとフラグメント グラフを書く」を参照してください。

ロケータ

• 新しい MPxLocatorNode::getShapeSelectionMask() インタフェースが追加され、シェイプ(MPxSurfaceShape および派生クラス)と同様の方法で、ロケータ用にシェイプのセレクション マスクを設定できるようになりました。

  詳細については、footPrintNode_GeometryOverride デベロッパー キット サンプルを参照してください。「セレクション マスクの使用」も参照してください。

  このメソッドは、Python API 2.0 でも使用できます。

• プラグイン ロケータにビューポート 2.0 レンダラを使用しているときに、ビューポート 1 のレンダリングと選択を再利用することが可能となりました。「ビューポート 2.0 で MPxLocatorNode 旧バージョンの修正済み描画コードと選択を使用する」を参照してください。

描画

• ビュー フィルタ状態を表示するために 2 つのインタフェース M3dView::viewIsFiltered() と M3dView::filteredObjectList() が追加されました。

  デベロッパー キット内の viewObjectSetOverride プラグイン サンプルを参照してください。

• Python API 2.0 では、対応する C++ と一致させるために、MPxDrawOverride コンストラクタに新しいパラメータ isAlwaysDirty が最後のパラメータとして追加されました。

  最適なパフォーマンスを実現するには、このパラメータを false に設定して、静的な描画コールバックを使用しないようにします。

  詳細については、pyFootPrintNode.py デベロッパー キット サンプルを参照してください。

シェーディングおよびカラー管理

• MShaderInstance::createShaderInstanceWithColorManagementFragment() を使用して MShaderInstance にカラー管理フラグメントを追加するときに、シェーダ インスタンスに設定されたすべてのプリ レンダラおよびポスト レンダラのコールバックが消失しなくなりました。以前はこれらはどちらも null に設定されていました。

• 以前は、mayaTextureShader フラグメントと関連付けられているストック シェーダのラッパー k3dSolidTextureShader には、exposure または alphaAsLuminance がパラメータとして含まれていませんでした。これらのアトリビュートに対する露光が追加され、カラー管理パラメータのサポートが完成しました。「ビューポート 2.0 のプラグイン シェーダのカラー管理のサポート」を参照してください。
• プラグインがエフェクト キャッシュをクリアできるようにする、新しい MShaderManager::clearEffectCache() メソッドが追加されました。このメソッドは、シェーダ フラグメントまたはフラグメント グラフの実装が変更されたときに、関連するすべてのエフェクトを更新させることができます。

選択項目

• MSelectionList::intersect() インタフェースが追加されました。これを使ってセレクション リストを変更し、それ自身と指定されたリストとの論理積を含めることができます。
• beginDrawable の使用を明確にするために、次の変更が MUIDrawManager に加えられました。
  • beginDrawable() の非パラメータ バージョンが除去された
  • beginDrawable (unsigned int name, bool nameIsPickable) の 2 つのパラメータを取るバージョンが非推奨としてマークされた
  • 新しい enum Selectability と新しい 2 つのパラメータを取るバージョンの beginDrawable (Selectability selectability=kAutomatic, unsigned int selectionName=0) が追加された
  • MUIDrawManager の Python API 2.0 バージョンもそれに応じて更新された

  詳細については、uiDrawManager、lineManipContainer (C++ API) および pyUiDrawManager.py (Python API 2.0) デベロッパー キット サンプルを参照してください。

レンダー オーバーライド

• 新しいメソッドが追加されました。

  const MFrameContext* MRenderOverride::getFrameContext()

  このメソッドにより、MRenderOverride::setup() と MRenderOverride::cleanup() 間で利用できる現在のフレーム レンダーのコンテキスト情報にアクセスできるようになります。オブジェクト単位およびレンダー項目の情報は、パイプラインがまだ実行されていないセットアップ時には使用できません。この情報は、ビューポート、プレイブラスト、レンダー ビューまたはバッチ レンダリングでオーバーライドが呼び出されるかどうかに関係なく提供されることに注意してください。

  フレームごとの各種データを抽出する MRenderOverride.getFrameContext() の使用を説明する、pyFrameContexTest.py プラグイン サンプルを参照してください。

ライト

ノードを登録するときに、"drawdb/light" と "drawdb/geometry" の両方の分類を指定することにより、カスタム描画オーバーライドと内部 ビューポート 2.0 ライティングのサポートを結合できるようになりました。

使用例では、ビューポート 2.0 内でネイティブの Maya ライトのようなライティングを実行するカスタム オブジェクトをビューポート内に描画しています。詳細については、apiDirectionalLightShape プラグイン サンプル、および「登録 」を参照してください。

ジオメトリ

頂点 ID、フェース ID、およびローカル パラメータ設定のアクセスが、MGeometryExtractor インタフェースを介して公開されるようになりました。完全に共有されていないジオメトリ データを DAG シェイプから抽出するには、MGeometryExtractor インスタンスを構築するときに kPolyGeom_NotSharing を指定する必要があります。

MPxShaderOverride と同様、頂点 ID、フェース ID、およびローカル パラメータ設定を要求する MGeometryExtractor に新しいインタフェースはありません。これらの頂点バッファを設定するには、次のセマンティック名を使用して MVertexBufferDescriptor を指定する必要があります。

• “vertexid”: 設定すると頂点 ID バッファが返されます
• “faceid”: 設定するとフェース ID バッファが返されます
• “localuvcoord”: 設定するとローカル UV 座標バッファが返されます

詳細については、geometryReplicator プラグインの例を参照してください。このプラグインの例を実行するには、まず次の環境変数を設定してから、geometryReplicator シェイプに hwPhongShader を割り当てます。

• MAYA_HWPHONG_TEST_VERTEXID_AND_FACEID = 1
• MAYA_HWPHONG_TEST_LOCALUVCOORD=1
• MAYA_HWPHONG_TEST_INDEXING=1

「ビューポート 2.0: MGeometryExtractor のアクセス」を参照してください。

カスタム エバリュエータ

カスタム エバリュエータを定義できる、新しい API 拡張が追加されました。カスタム エバリュエータにより、評価マネージャが DG ノードをスケジュールして実行する方法を変更することができます。カスタム エバリュエータの概要を参照してください。デベロッパー キット内の MPxCustomEvaluator、simpleEvaluator および constraintEvaluator プラグイン サンプルも参照してください。

スレッド化

• 新しい MObjectHandle::objectHashCode() インタフェースが追加され、MObjectHandle を作成または破棄せずに、提供された MObject に対してハッシュ コードを返すことが可能となりました。MObjectHandle の作成および破棄がスレッド セーフではないため、プラグインがスレッド化されている場合は、このインタフェースを MObjectHandle::hashCode() の代わりに使用する必要があります。