Maya 2016 の API の新機能

OpenMayaRender

UI 描画マネージャの機能強化

• UI マネージャ インタフェースによって行われる呼び出しの順序が、旧式の既定ビューポートで使用されていた順序と同じになりました。

• 多くのポイントまたはラインを描画するために、次の便利なメソッドが追加されました。
  • points (const MPointArray& points, bool draw2D): 2D または 3D でポイントを描画します。
  • lineList (const MPointArray& points, bool draw2D): 2D または 3D でライン セグメント(セグメントごとに 1 組のポイント)のリストを描画します。
  • lineStrip (const MPointArray& points, bool draw2D): 2D または 3D でライン ストリップ(接続されたライン セグメント)を描画します。
  • uiDrawManager デベロッパー キット サンプルは修正され、これら 3 つの新しいインタフェースを使用して描画するオプションが含まれるようになりました。
• 内部で指定されたアイコンの描画をサポートするために、次のインタフェースが追加されました。
  • icon( const MString &iconName, float scale): このメソッドは、指定された名前の 3D スケールのアイコンを 1 つ描画します。
  • getIconNames( MStringArray &iconNames): このスタティック メソッドでは、プラグインが icon()メソッドを使用して、利用可能なアイコン名のリストを照会することができます。

  uiDrawManager デベロッパー キット サンプルは修正され、アトリビュート エディタからアイコン名とスケール係数を選択する機能と、ロケータごとにアイコンを描画するオプションが含まれるようになりました。アイコン(icon)オプションは、UI タイプ(UI Type)ドロップ ダウンリストに表示されます。アイコン パラメータ(Icon Parameters)セクションが使用できるようになり、このセクションには Icon アトリビュートと Icon Scale アトリビュートのドロップダウン リストが含まれています。

  次のイメージは、一連のアイコンの描画で、各アイコンは uiDrawManager デベロッパー キット サンプルを使用して作成されたロケータです。

  

MShaderInstance の機能強化

• 指定された均一に関連付けられている注釈の値を照会する関数 MShaderInstance::annotationAsInt()、MShaderInstance::annotationAsFloat()、MShaderInstance::annotationAsString()が追加されました。これらの関数の入力は、パラメータの名前と注釈の名前です。
• 指定された均一パラメータのセマンティックを照会する関数 MShaderInstance::parameterSemantic()が追加されました。
• 均一の初期値を照会する関数 MShaderInstance::parameterDefaultValue()が追加されました。この値は、均一の初期化時に、エフェクト ファイルに設定することができます。
• エフェクト ファイルからテクスチャの名前を取得する関数 MShaderInstance::resourceName()が追加されました。リソース名は、ResourceName 注釈を使用してエフェクト ファイルで指定することができます。
• パラメータのウィジェット タイプと UI 名を取得する関数 MShaderInstance::uiWidget()と MShaderInstance::uiName()が追加されました。これらは、エフェクト ファイルで UIWidget 注釈と UIName 注釈を使用して指定することができます。
• 現在のテクニック注釈の値を照会する関数 MShaderInstance::techniqueAnnotationAsString()、MShaderInstance::techniqueAnnotationAsInt()、MShaderInstance::techniqueAnnotationAsFloat()が追加されました。
• パス注釈の値を照会する関数 MShaderInstance::passAnnotationAsString()、MShaderInstance::passAnnotationAsInt()、MShaderInstance::passAnnotationAsFloat()が追加されました。

MShaderManager の機能強化

• 関数 MShaderManager::getEffectsTechniques()が追加されました。この関数は、入力としてエフェクト ファイル名を受け取り、そのエフェクト ファイルで定義されているすべてのテクニックのリストを返します。
• MShaderManager::getEffectsFileShader()と MShaderManager::getEffectsTechniques()は、コンパイル済みの DX11 FX ファイル(.fxo)の使用を受け入れるようになりました。

MRenderItem の機能強化

• 新しい MRenderItem::RenderItemType OverrideNonMaterialItem が追加されました。これは、内部の(マテリアルではない)アイテムに対応し、このために既定のシェーダ エフェクトは MPxShaderOverride によってオーバーライドされました。
• 関数 MRenderItem::availableShaderParameters()、MRenderItem::getShaderBoolParameter()、MRenderItem::getShaderIntParameter()、MRenderItem::getShaderFloatParameter()、MRenderItem::getShaderFloatArrayParameter()が追加されました。これらの関数は、このアイテムがオーバーライドする未処理のシェーダ パラメータ(既定のカラー、ラインの幅、ポイント サイズなど)を取得するときに OverrideNonMaterialItem で使用することができます。
• 関数 MRenderItem::setShaderFromNode()が追加されました。これは、シーン内のサーフェス シェーダ ノード(標準またはカスタム)のシェーディング ネットワークを評価することにより、レンダー アイテムにシェーダ インスタンスを設定します。
• 関数 MRenderItem::isShaderFromNode() が追加されました。これは、MRenderItem::setShaderFromNode()メソッドを使用してシーン内のサーフェス シェーダ ノード(標準またはカスタム)のシェーディング ネットワークを評価することによって、シェーダ インスタンスが設定された場合は true を返します。
• コールバック関数 MRenderItem::LinkLostCallback の定義が追加されました。これは、MRenderItem::setShaderFromNode()によって割り当てられたシェーダ インスタンスが有効ではなくなったときにトリガされます。

シェーダ フラグメントの機能強化

• Maya インストールの ..bin/ShadeFragment フォルダのインストールの一部として、XML スキーマ ファイルが使用できるようになりました。

  v2pFragment.xsd はシェーディング フラグメントの XML スキーマであり、「シェーディング フラグメントの XML スキーマ」でも説明されています。

  vp2FragmentGraph.xsd はフラグメント グラフの XML スキーマであり、「フラグメント グラフの XML スキーマ」で説明されています。

• 「シェーディング フラグメントの XML スキーマ」トピックは更新され、<xs:simpleType name="LanguageType"> セクションにライン <xs:enumeration value="GLSL" /> が含まれるようになりました。このラインは、Maya 2016 が GLSL フラグメントをサポートするようになったために追加されました。
• 「フラグメント グラフの XML スキーマ」トピックは更新され、スキーマの <xs:complexType name="ConnectionListType"> セクションにライン <xs:attribute name="name" type="xs:string" /> が追加されました。
• 「phong1 のフラグメント グラフの XML ファイル」トピックで、phong1 をルートとするシェーディング ネットワークのフラグメント グラフの XML ファイルの例を示します。
• ソフトウェア シェーダに次の名前を持つアトリビュートがあり、シェーダのオーバーライドが指定されていない場合は、これらの値をビューポート 2.0 で表示するための自動マッピングが試行されます。このフィーチャは既にサポートされているアトリビュートに加えて提供されます。詳細については、「phong1 のフラグメント グラフの XML ファイル」を参照してください。
  • translucence: float アトリビュート タイプ
  • translucenceFocus: float アトリビュート タイプ
  • translucenceDepth: float アトリビュート タイプ
  • matteOpacity: float アトリビュート タイプ
  • mattOpacityMode: 16 ビット、32 ビット、または enum アトリビュート タイプ

MFrameContext の機能強化

• 新しい MFrameContext::getHwFogParameters()メソッドが追加されました。これにより、フレーム コンテキストからグローバル フォグ パラメータを取得できるようになりました。このメソッドは、ハードウェア フォグは有効かどうか、ハードウェア フォグ モード、フォグの開始、フォグの終了、フォグの密度、フォグ カラーが含まれている struct HwFogParams を返します。

  また、「ハードウェア フォグ固有のセマンティック」および「ビューポート 2.0 によってサポートされるシェーダのセマンティック」も参照してください。

• MFrameContext に新しい DisplayStyle enum の MFrameContext::kFlatShaded と MFrameContext::kShadeActiveOnly が追加されました。これらは、MFrameContext::getDisplayStyle()関数によって返されます。これらは、すべてをフラット シェード(Flat Shade All)、選択項目をスムーズ シェード(Smooth Shade Selected Items)、選択項目をフラット シェード(Flat Shade Selected Items)の各ビューポート モードに対応します。
• MFrameContext に新しい LightingMode の enum MFrameContext::kNoLighting と MFrameContext::kCustomLights が追加されました。これらは、MFrameContext::getLightingMode()関数によって返されます。これらは、ビューポートのライトを使用しない(Use No Lights)ライティング モードと、ハイパーシェード(Hypershade) マテリアル ビューア(Material Viewer)パネルで使用することができるカスタム ライトを参照します。

MDrawContext の機能強化

• 選択のために新しいパス セマンティック MPassContext::kSelectionPassSemantic が追加されました。このパスは、MPxShaderOverride で適切なエフェクトやパスを選択できるようにするために、ビューポート 2.0 の選択中に MRenderItem::OverrideNonMaterialItem のためだけに発生します。

MRenderOverride の機能強化

• オーバーライドでカスタム MUserRenderOperation が定義されている場合は、ユーザ操作が呼び出される前に、以前にバインドされたすべての頂点バッファがバインド解除されるようになりました。以前は、このバインド解除を実行するかどうかは、ユーザ操作次第でした。

• 以前は、MRenderOverride でオーバーライドのレンダー ターゲットが設定されていない場合は、使用されるターゲットはプリセット(固定)フォーマットでした。

  この動作は、代わりに 浮動小数点レンダー ターゲット(Floating Point Render Target)とマルチサンプル アンチエイリアシング(Multisample Anti-aliasing)のためのビューポート 2.0 レンダリング オプションを使用するように変更されました。これらの設定を確認するには、レンダラ > ビューポート 2.0(Renderer > Viewport 2.0) > を選択してハードウェア レンダラ 2.0 設定(Hardware Renderer 2.0 Settings)ウィンドウを開きアンチエイリアシング(Anti-aliasing)カテゴリと浮動小数点レンダー ターゲット(Floating Point Render Target)カテゴリを展開するか、レンダー > レンダー設定(Render > Render Settings)を選択してレンダー設定(Render Settings)ウィンドウを開きMaya ハードウェア 2.0(Maya Hardware 2.0)タブをクリックしてアンチエイリアシング(Anti-aliasing)カテゴリと浮動小数点レンダー ターゲット(Floating Point Render Target)カテゴリを展開します。

  たとえば、R32G32B32A32_FLOAT の浮動小数点形式が選択されている場合は、カラー レンダー ターゲットは同じ浮動小数点形式を使用しようとします。

  プラグインで旧式の固定形式を使用する場合は、MHWRender::kR8G8B8A8_UNORM 形式では単一のカラー ターゲット、MHWRender::D42S8 形式では単一の深度ターゲットを定義することができます。

• viewRenderOverrideFrameCache デベロッパー キット プラグインが修正され、クランプされていないカラー イメージ出力を取得するために、浮動小数点形式を設定して使用することができる浮動小数点 EXR イメージを出力するようになりました。

• MSceneRender::MLightingMode に MSceneRender::kNoLight が追加されました。これにより、シーン レンダー オーバーライドでライトを使用しない(Use No Lights)モードを設定できるようになりました。
• MSceneRender::MDisplayMode に MSceneRender::kFlatShaded と MSceneRender::kShadeActiveOnly が追加されました。MSceneRender::kTextured が個別の enum になり、MSceneRender::kShaded または MSceneRender::kFlatShaded とともに使用できるようになりました。これらの変更により表示モードを詳細にコントロールできるようになり、ユーザはシーン レンダー オーバーライドを設定することができます。

  viewRenderOverride デベロッパー キット サンプル(viewRenderOverrideOperations.cpp)の関数 viewRenderSceneRender::displayModeOverride()が、kFlatShaded と kShadeActiveOnly の使用法を示すように更新されました。

MRenderOperation の機能強化

• MRenderOperation::targetOverrideList()の戻り値のタイプが MRenderTarget** から MRenderTarget* const* に変更されました。Maya では、返されるリストの個々の MRenderTarget* ポインタは変更されません。

MRenderUtilities の機能強化

• MRenderUtilities::acquireSwatchDrawContext()と MRenderUtilities::acquireUVTextureDrawContext()がオプションのパラメータとしてカラー ターゲットと深度ターゲットを受け取るようになりました。有効なターゲットを渡すと、GL とコア プロファイルのビューポート 2.0 デバイスで適切な GL コンテキスト も有効にされます。
• MRenderUtilities::releaseDrawContext()がオプションのパラメータを受け取るようになりました。このパラメータは、以前は上述の acquireSwatchDrawContext()関数と acquireUVTextureDrawContext()関数で使用されていた描画ターゲットを解放します。

• 新しい MRenderUtilities::renderMaterialViewerGeometry()メソッドが追加されました。これにより、ハイパーシェード(Hypershade)でマテリアル ビューア(Material Viewer)の ビューポート 2.0 実装を活用してスウォッチ レンダリングを描画することができます。

  新しい API を使用してスウォッチ レンダリングを実装するには、次の 3 つの方法があります。

  1. MPxHardwareShader::renderSwatchImage()と MPxHwShaderNode::renderSwatchImage()から MRenderUtilities::renderMaterialViewerGeometry()を呼び出します。meshSphere を shape パラメータ、MRenderUtilities::kPerspectiveCamera を cameraMode パラメータ、MRenderUtilities::kSwatchLight を lightRig パラメータとしてスウォッチをレンダーします。

     meshPlane を shape パラメータ、kOrthogonalCameraCloseUp を cameraMode として使用して MPxHardwareShader::renderImage()と MPxHwShaderNode::renderImage()から UV エディタ イメージを生成することもできます。

  2. renderSwatchImage()を未実装のままとします。
  3. renderSwatchImage()を実装して MStatus::kNotImplemented を返します。

     2 番目と 3 番目の場合は、既定のスウォッチのレンダーにこの API が使用されます。

     次のデベロッパー キット サンプル プラグインが適宜更新されました。

     • 既定のスウォッチをレンダリングする: glslShader
     • 明示的に renderMaterialViewerGeometry()を呼び出す: hwPhongShader、hwColorPerVertexShader、pyHwColorPerVertexShader

MPxSubSceneOverride の機能強化

• MVertexBuffer::resourceHandle()インタフェースを使用するユーザ定義バッファの設定が修正されました。
• シンプルな UI シェイプ(ライン、円、テキストなど)を描画する MPxSubSceneOverride::hasUIDrawables()、MPxSubSceneOverride::areUIDrawablesDirty()、MPxSubSceneOverride::addUIDrawables()が追加されました。
  • addUIDrawables()をオーバーライドする場合は、hasUIDrawables()も true を返すようにオーバーライドする必要があります。
  • areUIDrawablesDirty()が true を返す場合は、描画可能な UI はクリアされ、リフレッシュするごとに再度追加されます。このメソッドが false を返す場合は、描画可能な UI は保持され、オーバーライドに関連付けられている DAG オブジェクトが破棄されるかオーバーライドが登録解除されるまで保持されます。
  • 描画可能な UI は、描画とトランスフォームのインスタンスのインスタンス化をサポートしていません。
  • apiMeshShape デベロッパー キット サンプル(apiMeshSubSceneOverride.cpp)は、これらの関数の使用例を示します。

MRenderTarget の機能強化

• スタティック メソッド MRenderTarget::freeRawData()が追加されました。これにより、デバッグモードでコンパイルされたプラグインが MRenderTarget::rawData()によって割り当てられたメモリを安全に解放できるようになりました。

MTexture の機能強化

• スタティック メソッド MTexture::freeRawData()が追加されました。これにより、デバッグモードでコンパイルされたプラグインが MTexture::rawData()によって割り当てられたメモリを安全に解放できるようになりました。

MTextureManager の機能強化

• 新しいバージョンの MTextureManager::acquireTexture()が追加されました。これは、ディスク上のファイルからテクスチャを取得します。

  MTextureManager::acquireTexture(const MTextureArgments& args)は、入力パラメータとして新しいクラス MTextureArguments を受け取ります。MTextureArguments を使用すると、取得する必要のあるテクスチャの引数(ファイルパスや mip マップレベルなど)を指定することができます。

  基本的に、新しい MTextureManager::acquireTexture(const MTextureArgments& args) は、既存の MHWRender::MTextureManager::acquireTexture (const MString & textureName, const MString & contextNodeFullName, int mipmapLevels = 0, bool useExposureControl = true, const MString & layerName = MString(), int alphaChannelIdx = -1) とほぼ同一です。ただし、機能が 1 つ追加されています。テクスチャのバックグラウンド ロードを有効にする場合に必要なファイル テクスチャ ノードを受け入れることができます。ファイル テクスチャノードを設定するには、MTextureArguments のコンストラクタを使用するか、MTextureArguments::setFileTextureNode()メソッドを使用します。

  詳細については、『Maya ユーザ ガイド』の「表示(Display)プリファレンス: マテリアルのロード モード(Material Loading Mode)」の平行モードの説明を参照してください。

MPxDrawOverride の機能強化

• MPxDrawOverride::boundingBox function()関数が純粋な仮想関数から仮想関数に変更されました。これにより、ユーザは、常にオーバーライド実装を提供する必要がなくなりました。既定の実装は、カリングされることのない大きなバウンディング ボックスを返します。

MPxShaderOverride の機能強化

次の新しいメソッドでは、プラグイン作成者が非テクスチャ モードで使用されるシェーダを指定することができます。このメソッドを指定しない場合は、固定のグレーのシェーダが常に使用されます。

• MHWRender::MShaderInstance * MHWRender::MPxShaderOverride::nonTexturedShaderInstance ( bool & monitorNode )
• この MPxShaderOverride::nonTexturedShaderInstance()メソッドは、非テクスチャ モードで描画するときに使用されるオーバーライド シェーダ インスタンスを返します。Null が返された場合は、内部的に定義された修正不可のシェーダ インスタンスが使用されます。このメソッドで true を返すように monitorNode パラメータを設定すると、関連付けられているシェーダ ノードは更新フェーズ中にオーバーライドに対応するモニタが必要であることを示します。
• 詳細については、「エフェクト オーバーライド」を参照してください。
• シェーダで非マテリアル アイテム(ワイヤフレーム、エッジや頂点のコンポーネントなど)の既定のエフェクトを置き換えることができる新しい関数 MPxShaderOverride::overridesNonMaterialItems()。これは、ディスプレイスメントが含まれているシェーダ オーバーライドの場合に便利です。

MVertexBuffer および MIndexBuffer の機能強化

• MVertexBuffer::resourceHandle()と MIndexBuffer::resourceHandle()がビューポート 2.0 の DirectX11 モードでサポートされるようになりました。
• SubSceneOverride バージョンの apiMeshShape デベロッパー キット サンプルが、これらのメソッドの使用例を示すように更新されました。

  SubSceneOverride バージョンのプラグインは、次の手順でテストすることができます。

  1. apiMeshShape.cpp のライン 2289 で、sUseSubSceneOverride を true に設定します。
  2. プラグインを再コンパイルします。
  3. ビューポート 2.0 で、Maya を DirectX11 モードで起動します(プリファレンス(Preferences)ウィンドウの表示(Display)セクションでこのオプションを選択します)。apiMeshShape.mll がMAYA_PLUG_IN_PATH 環境変数で指定したフォルダ内に配置されていることを確認します。
  4. 次の MEL コマンドを実行します。

     loadPlugin apiMeshShape;
     createNode apiMesh;
     createNode apiMeshCreator;
     connectAttr apiMeshCreator1.outputSurface apiMesh1.inputSurface ;
     sets -edit -forceElement initialShadingGroup |transform1|apiMesh1;

  5. ビューポート 2.0 からバウンディング ボックス モードに切り替えると、バウンディング ボックスが正しく表示されます。

コンポーネントの選択

MPxGeometryOverride の機能強化

• MPxGeometryOverride::refineSelectionPath()関数と MPxGeometryOverride::updateSelectionGranularity()関数が、ビューポート 2.0 でのコンポーネントの選択をサポートするために追加されました。

MDrawRegistry の機能強化

• MDrawRegistry::registerComponentConverter()関数と MDrawRegistry::deregisterComponentConverter()関数が、ビューポート 2.0 でのコンポーネントの選択をサポートするために追加されました。

MPxSubSceneOverride の機能強化

• MPxSubSceneOverride::updateSelectionGranularity()が、ビューポート 2.0 でのコンポーネントの選択をサポートするために追加されました。

新しいクラス MSelectionContext、MIntersection、MSelectionInfo、MPxComponentConverter が、ビューポート 2.0 でのコンポーネントの選択をサポートするために追加されました。

ユーティリティの機能強化

• 多くの組み込みプロシージャ テクスチャ(ノイズ、フラクタル、ボリューム ノイズ、ソリッド フラクタルなど)の計算に使用される定数ノイズ ルックアップ テーブルにアクセスするために、いくつかのメソッドが MRenderUtil に追加されました。

• MGeometryUtilities::acquireReferenceGeometry()が修正され、MGeometryUtilities::releaseReferenceGeometry()を呼び出したときにメモリが適切に解放されるようになりました。

マニピュレータの機能強化

• MUIDrawManager::beginDrawable()メソッドの新しいバリエーション beginDrawable(unsigned int name, bool nameIsPickable)が追加されました。これにより、MPxManipulatorNode::colorAndName()とよく似た方法でマニピュレータを選択できるようになりました。

• 新しいメソッド MPxManipulatorNode::shouldDrawHandleAsSelected()が追加されました。これは、マニピュレータ ハンドルがビューポート 2.0 で選択またはハイライトされたときに描画されたかどうかを照会します。

変更パラメータの機能強化

• シェーディング ノード オーバーライド フラグメントに新しい colorset セマンティックが追加されました。4-float の colorset 変数パラメータは頂点カラーを表します。複数の colorset 変更パラメータがサポートされる点を除いて、fcolor セマンティックと同じです。「シェーディング ノード オーバーライド」を参照してください。

ハイパーシェードのサード パーティ製レンダラの実装

• 新しいクラス MPxRenderer が追加され、ハイパーシェード(Hypershade)のマテリアル ビューア(Material Viewer)でレンダリングするためにプラグインがサード パーティ製レンダラを実装できるようになりました。

レンダラーの機能強化

カラー管理の機能強化

• 追加されたカラー管理フラグメントを使用して新しいシェーダ インスタンスを作成する関数 MShaderInstance::createShaderInstanceWithColorManagementFragment()が追加されました。

ビューポート 2.0 でサポートされるシェーダのセマンティック

「ビューポート 2.0 でサポートされるセマンティック」のリストが更新されました。

Developer Kit サンプル

• Python API 2.0 デベロッパー キット サンプルは、plug-ins¥scripted フォルダにあります。それぞれが、対応する C++ サンプルと同じ名前を持ちますが、プリフィックスは py です。

• 新しい viewObjectSetOverride デベロッパー キット サンプルが追加されました。このサンプルについては、「複数パス シーンのレンダリング」で説明します。

• 新しいプラグイン onbShader がデベロッパー キットに追加されました。これは、Maya で onbShader と呼ばれるサーフェス シェーダとしてディペンデンシー ノードを作成します。

  このプラグインは、ディペンデンシー ノードを実装するだけでなく、ビューポート 2.0 でサーフェス シェーダの完全な実装を示します。

  シェーディング フラグメントを定義して登録し、最終的なフラグメント グラフを作成する方法を例示します。

  この例は、Maya の組み込みのフラグメントを再利用しない lambertShader や phongShader サンプルとは異なり、プラグインを介して独自のフラグメントを定義します。

• 新しいプラグイン simpleNoiseShader がデベロッパー キットに追加されました。これは、simpleNoise という名前のテクスチャ シェーダとしてディペンデンシー ノードを作成し、このノードは Maya の波ノイズ テクスチャ タイプを実装します。

  このプラグインは、ディペンデンシー ノードを実装するだけでなく、ビューポート 2.0 でテクスチャ シェーダの完全な実装を示します。

  シェーディング フラグメントを定義して登録し、最終的なフラグメント グラフを作成しディペンデンシー ノードに関連付ける方法を例示します。さらにこの例は、Maya のプロシージャ テクスチャの計算に使用されるノイズ ルックアップ テーブルを作成してアクセスする方法も例示します。

  1 番目のシェーディング フラグメントは、ノイズ ルックアップ テーブルのテクスチャとサンプラ パラメータのペアを定義します。ノイズ ルックアップ テーブルは 3D テクスチャの作成に使用されます。3 D テクスチャは、ピクセル シェーダが最終的な '波' ノイズ結果の計算のために抽出することができるものです。新しい MRenderUtil メソッドの noiseTableSize()と valueInNoiseTable()は、ノイズ ルックアップ テーブルの値にアクセスするために使用します。詳細については、simpleNoiseShader デベロッパー キット サンプルを参照してください。

• footPrintNode デベロッパー キット サンプルは単純化され、MUIDrawManager を使用して、ビューポート 2.0 で単純なロケータを描画する方法を例示するようになりました。

  MUIDrawManager を使用するプラグイン コードには、次のような利点があります。

  • Maya 2016 の新機能であるビューポート 2.0 のベース選択で機能します。
  • 一度書き込むと、すべてのプラットフォームとすべての描画 API (OpenGL コア プロファイルを含む)で使用することができます。

  元のサンプルは、未処理の OpenGL/DX コールを使用してロケータを描画する方法を説明する rawfootPrintNode に名前が変更されました。

  rawfootPrintNode の例が更新されました。メソッド MFrameContext::renderingDestination()を使用して M3dView を取得し目的の名前を見つける方法、次に、M3dView::getM3dViewFromModelPanel()を使用して指定された目的の名前を持つパネルの対応する M3dView を取得する方法を示します。

• 新しいプラグイン footPrintNode_GeometryOverride が追加されました。これは、同時に表示する必要があるロケータの数が多いときにも良好な描画パフォーマンスを得るために、MPxGeometryOverride を使用してロケータを実装します。Python バージョンも使用できます。

• blast2Cmd デベロッパー キット サンプルは、ビデオ キャプチャを実行する新しいプラグインです。出力ターゲット サイズを設定およびオーバーライドしたり、レンダラの通知コールバックをアタッチします。コールバックはコマンドが出力する必要がある各フレームで呼び出されます。レンダー ターゲットをテクスチャにコピーして戻すときに既存のインタフェースを使用し、ディスクに保存するときに組み込みのテクスチャ保存機能を使用します。レンダー ターゲットが固定された点である場合は、プラグインは IFF フォーマットでイメージを保存します。それ以外で、浮動小数点である場合は、プラグインは EXR フォーマットで保存します。

  次に、このサンプルで使用されるロジックの概要を説明します。

  1. MRenderer::addNotification()を呼び出して、ポスト レンダー コールバックを追加します。
  2. MRenderer::setOutputTargetOverrideSize()を呼び出して、出力ターゲット サイズのオーバーライドを設定します。
  3. キューを更新します。オーバーライド サイズのターゲットに対してレンダーが実行されます。
  4. コールバックが出力ターゲットの内容を読み込みます。
  5. MRenderer::unsetOutputTargetOverrideSize()を呼び出して、出力ターゲット サイズのオーバーライド設定を解除します。
  6. MRenderer::removeNotification()を呼び出して、コールバックを削除します。

• vp2BlinnShader は MPxShaderOverride の単純化された使用例です。プラグインは、このタイプのオーバーライドの基本的なインタフェースの使用方法を示します。このサンプルは MShaderInstance を使用します。これは、シェーダ マネージャ(MShaderManager)にストック Blinn シェーダを求めることで取得されます。このように、シェーダのジオメトリ要件をシェーダ インスタンス自体から取得することができます。この例では、追加の DX11 シェーダ署名は必要ありません。描画用の内部メソッドも使用されます。ストック シェーダには自動的に更新される自前のライト バインディングがあるため、追加のライト操作は必要ありません。このプラグインは、実装が内部的に提供されるので、すべてのプラットフォームと現在サポートされているすべての描画 API (OpenGL、OpenGL コア プロファイル、DX11)で実行することができます。したがって、追加のシェーディング コードは必要ありません。
• apiMeshShape プラグイン(およびその Python バージョンである pyApiMeshShape.py)が、MPxGeometryOverride と MPxSubSceneOverride を使用するビューポート 2.0 でのコンポーネントの選択を実行するために更新されました。これらのプラグインは、複製と不明なストリームを適切に管理するためにも更新され、複数の UV ストリームまたは従法線と複接線を必要とするエフェクトを使用できるようになりました。

  SubSceneOverride バージョンが、DirectX11 モードのサポートを例示すために更新されました。詳細については、上記の MVertexBuffer および MIndexBuffer の強化機能セクションを参照してください。

• brickShader プラグイン(C++ と Python の両方のバージョン)が、GLSL をサポートするように更新されたため、Maya ビューポートの OpenGL コア プロファイル モードで実行されるようになりました。GLSL のシェーダ フラグメントは、HLSL 実装に基づいて作成されました。
• viewOverrideSimple サンプル プラグインが追加されました。これは、MRenderOverride の使用方法を説明しており、初心者を対象にした簡単な例です。ビューポート メニューにレンダラーとして表示されるレンダー オーバーライドを作成し、シーンおよび HUD を描画して、バックグラウンドのカラー オーバーライドを実行します。レンダー オーバーライドを作成する例で使用されているロジックは、Maya の内部レンダリング パイプラインで使用されているものとほぼ一致します。

• デベロッパー キットに提供される DX11 シェーダ プラグインを Visual Studio 2012 を使用してコンパイルするには、はじめに devkit/plug-ins/dx11Shader フォルダに提供されている Visual Studio 2012 プロジェクト ファイル(Effects11_vs2012.vcxproj)を使用して、次の手順で Microsoft DirectX SDK Effects11 ライブラリをコンパイルする必要があります。

  1. ファイルを Effects11 フォルダ(多くの場合は C:¥Program Files (x86)¥Microsoft DirectX SDK (June 2010)¥Samples¥C++¥Effects11)にコピーします。
  2. Effects11_vs2012.vcxproj プロジェクト ファイルをロードして、Effects11 フォルダからソリューションをコンパイルします。

ドキュメントの更新

• 描画マニピュレータとビューポート 2.0(Viewport 2.0)のツール コンテキストで使用されるインタフェースに関する情報を提供するために、『Maya ビューポート 2.0 API ガイド』にセクション「マニピュレータ」と「ツールのコンテキスト」が追加されました。

• 「フレームと描画のコンテキスト」トピックが追加されました。

• 「ライト情報をワールドから固定関数ライティングのビュー空間に変換する」セクションが追加されました。
• 「複数のパス シーンのレンダリング」セクションが追加されました。

OpenMaya

• 評価マネージャの状態を照会することができる新しい MEvaluationManager クラスが追加されました。simpleEvaluationNode デベロッパー キット サンプルはこのクラスの使用例を示します。
• MPxNode に新しい preEvaluation()と postEvaluation()仮想メソッドが追加されました。
• 評価マネージャによる評価の前にダーティに設定される一連のアトリビュートとプラグのセットへのアクセスを提供するために、新しい MEvaluationNode クラスが追加されました。
• スレッド化された評価をサポートするために MPxNode::preEvaluation()と MPxNode::postEvaluation()によって使用される新しい MEvaluationNodeIterator クラスが追加されました。このクラスは、指定した MEvaluationNode で評価マネージャによる評価の前にダーティに設定される一連のアトリビュートとプラグのセットを容易に反復するために使用します。
• preEvaluation()関数の使用法を示す simpleEvaluationNode デベロッパー キット サンプルが追加されました。
• postEvaluation()関数の使用法を示す simpleEvaluationDraw デベロッパー キット サンプルが追加されました。

• プラグインは、スケジュールする方法について評価マネージャにヒントを与えることができるようになりました。

  Python プラグインのスケジュールが改善されました。以前は、Python ノードは並列で実行され、ロック競合に関する問題や評価速度が遅くなる原因になっていました。

  Python プラグインは、グローバルにシリアル化されるようになり、GIL (グローバル インタプリタ ロック)に関する問題を回避し、全体的なパフォーマンスが向上しました。

  プラグイン ノードのスケジュールを指定するために、次の新しい enum と仮想メソッドが MPxNode に追加されました。次が追加されました。

  • ::SchedulingType
  • ユーザは MPxNode::schedulingType() const 関数をオーバーライドすることができます。この関数は、ノードの目的のスケジュール タイプを返します。

GPU オーバーライド デフォーマをサポートするために次の新しいクラスが追加されました。

• MOpenCLInfo
• MAutoCLEvent
• MAutoCLKernel
• MAutoCLMem

• 新しい MFnMatrixArrayData クラスが追加されました。このクラスでは、プラグインで MMatrixArray アトリビュート タイプを使用することができます。これは、MMatrix タイプを複数作成するのではなく、よりコンパクトなグラフを生成するために使用することができます。このタイプを 1 回即座に使用することは、新しい DeltaMush デフォーマによって計算されたキャッシュ フレーム情報を読み取ることに相当します。

OpenMayaAnim

GPU オーバーライド デフォーマをサポートするために次の新しいクラスが追加されました。

• MPxGPUDeformer
• MGPUDeformerRegistry
• MGPUDeformerRegistrationInfo

デフォーマのクラスが再編成されました。新しいクラスは次のとおりです。

• MPxGeometryFilter: デフォーマの新しいベース クラスです。MPxDeformerNode (まだ存在しています)に相当しますが、頂点単位のウェイトのリストを持ちません。
• MPxSkinCluster: MPxGeometryFilter の拡張版です。頂点単位のスキン ウェイトを持ちます。このクラスから派生するカスタム ノードは、Maya UI では、組み込みの skinCluster のように扱われます。
• MPxBlendShape: MPxGeometryFilter の拡張版です。入力ターゲットを持ちます。このクラスから派生するカスタム ノードは、Maya UI では、組み込みの blendShape のように扱われます。

OpenMayaUI

• 新しい MGraphEditorInfo クラスが追加されました。このクラスでは、指定した グラフ エディタ(Graph Editor)について、ビューポートのバインドやアニメーション カーブ ノードのような UI 情報をその現在の状態に基づいて照会することができます。

Developer Kit サンプル

• identityNode: 入力を出力にコピーする単純なデフォーマの例を示します。また、ユーザ独自のデフォーマの作成を開始することができる定型も提供します。
• offsetNode: 重要なデフォーマの CPU と GPU の実装を提供します。
• basicBlendShape: MPxBlendShape を継承することで基本的なデフォーマを作成する方法を例示します。
• basicSkinCluster: MPxSkinCluster を継承することで基本的なデフォーマを作成する方法を例示します。

OpenMaya

MPolyMessage の機能強化

• UV セット修正メッセージ(UV セットの追加と削除や現在の UV セットの切り替えに関する通知を含む)のためのコールバックを登録する新しい MPolyMessage::addUVSetChangedCallback()メソッドが追加されました。

MFnMesh の機能強化

• メッシュの指定された UV を固定された UV として設定するメソッド MFnMesh::setPinUVs()が追加されました。「固定された」UV とは、修正してはならない UV です。ピン ウェイトを 1.0 に設定すると完全に固定されます。UV ツールはその UV を修正できません。ピン ウェイトを 0.0 と 1.0 の間の値に設定すると、UV ツールはそのピン ウェイトに対する変更を値に応じてウェイトします。

• メッシュの固定された UV と、それらの UV に関連付けられたピン ウェイトを取得するメソッド MFnMesh::getPinUVs()が追加されました。

• MFnMesh::extrudeFaces()関数と MFnMesh::extrudeEdges()関数に thickness オプションと offset オプションが追加されました。これらのパラメータは、フェースの押し出しのアトリビュートとエッジ ノードに直接マップされます。

OpenMayaUI

新しいコンテキスト プロキシ クラス

• 新しい MPxTexContext コンテキスト プロキシ クラスが追加されました。このコンテキスト プロキシ クラスは、ユーザ定義ツールを使用して UV テクスチャ エディタ(UV Texture Editor)の機能を拡張する方法を提供します。マウスの移動、マウスの押下、マウスのドラッグ、マウス ボタンの解放などのインタラクティブなイベントを処理するために、いくつかの関数が提供されます。これらの関数をオーバーライドして、UV テクスチャ エディタ(UV Texture Editor)の新しいインタラクティブなツールの動作を定義することができます。
• 新しい QT サンプル プラグイン grabUV.pro が追加されました。このプラグインは、UV グラブ ブラシを実装する MPxTexContext を使用する方法を例示します。

新しいコマンド プロキシ クラス

• 新しい MPxPolyTweakUVInteractiveCommand コマンド プロキシ クラスが追加されました。このツール コマンド プロキシ クラスは、インタラクティブなコンテキスト内でポリゴン オブジェクトの UV をインタラクティブに編集する単純化された方法を提供します。ユーザは、インタラクティブなコマンドの実行中に新しい UV を提供することができます。編集を完了することで、すべてのインタラクティブな更新が単一のコマンドとして記録され、元に戻すこともできます。

MPxContext の機能強化

• コンテキスト ツールがアクティブなときにビューポート 2.0 で MUIDrawManager を使用してプリミティブを描画する新しい MPxContext::drawFeedback()メソッドが追加されました。これは、ブラシ リングなどのコンテキスト フィードバックをレンダリングする場合に役立ちます。

ノードの UUID (Universally Unique Identifier)

• UUID の処理時に MFnDependencyNode とともに使用される新しいクラス MUuid が追加されました。
• ユーザが UUID ポリシーの読み込みや参照を修正することができる新しい API コールバック MDGMessage::addNodeChangeUuidCheckCallback()が追加されました。
• MSelectionList に新しいメソッド MSelectionList::add( const MUuid & uuid, bool mergeWithExisting = false )が追加されました。このメソッドは、UUID に一致するノードを選択リストに追加します。

MDGModifier::commandToExecute()に相当する Python が追加されました

新しい MDGModifier::pythonCommandToExecute() が追加されました。これにより、ディペンデンシー グラフ モディファイアに対して Python コマンド/スクリプトを実行する処理を追加できます。

これは、MDGModifier::commandToExecute() メソッドに相当する Python メソッドです。