サンプルプラグインの概要

Maya 開発ツールキットには、数多くの付属のサンプルプラグインがあります。この章の情報は、目的の操作に合ったサンプルプラグインを探すのに役立ちます。これらのサンプルでは、ファイル名からサンプルプラグインの種類がわかるように、次の命名規則を使用しています。

接尾部	修正される問題
Cmd	新規のコマンドを作成するプラグイン。
Tool	新規のインタラクティブツールを作成するプラグイン。
Node	新規のノード型を作成するプラグイン。
Translator	新規のファイルトランスレータを作成するプラグイン。
Shader	新規のシェーディングノードを作成するプラグイン。
Manip	新規のマニピュレータを作成するプラグイン。
Field	新規のダイナミックフィールドを作成するプラグイン。
Emitter	新規のダイナミックエミッタを作成するプラグイン。
Spring	新規のダイナミックスプリングを作成するプラグイン。
Shape	新規のシェイプを作成するプラグイン。

MEL コマンドプラグイン

blindComplexDataCmd	ユーザ定義のデータ型として、より複雑なブラインドデータをオブジェクトに追加する例を示すコマンド。blindComplexDataCmd を参照してください。
blindDoubleDataCmd	ユーザ定義のデータ型として、ブラインドデータをオブジェクトに追加する例を示すコマンド。blindDoubleDataCmd を参照してください。
blindShortDataCmd	ブラインドデータをオブジェクトに追加する例を示すコマンド。blindShortDataCmd を参照してください。
closestPointCmd	MMeshIntersector クラスを使用して、ポイントライトとメッシュの間の最近接ポイントを検索する方法を示すコマンド。
closestPointOnCurve	数学関数に応じてクラスタの複数の CV にウェイトを設定するコマンド。closestPointOnCurve を参照してください。
convertBumpCmd	API を使用したノンリニアアニメーションクリップの作成に必要な手順を示すコマンド。convertBumpCmd を参照してください。
convertEdgesToContainedFacesCmd	選択したエッジを相互に接続したフェースに変換するコマンド。convertEdgesToContainedFacesCmd を参照してください。
convertVerticesToContainedEdgesCmd	選択した頂点をオリジナルの頂点と相互に接続したエッジに変換するコマンド。convertVerticesToContainedEdgesCmd を参照してください。
convertVerticesToContainedFacesCmd	選択した頂点をオリジナルの頂点と相互に接続したフェースに変換するコマンド。convertVerticesToContainedFacesCmd を参照してください。
cvExpandCmd	NURBS CV の選択範囲を分割して、選択されている 1 つの CV あたり 1 つの文字列を適用するコマンド。cvExpandCmd を参照してください。
cvPosCmd	NURBS CV またはポリゴン頂点のワールド空間またはローカル空間を返すコマンド。cvPosCmd を参照してください。
dagPoseInfoCmd	スケルトンのバインドポーズまたは「dagPose」コマンドで作成されるその他のポーズについて、DAG ポーズ情報を抽出する方法を示すコマンド。dagPoseInfoCmd を参照してください。
deletedMsgCmd	使用可能な各ノード削除コールバックを示します。
deletedMsgCmd	API で使用可能な各ノード削除コールバックを示すコマンド。このコマンドは、選択したノードにコールバックを登録し、コマンド実行中にコンソールにメッセージをトリガします。
dynExprFieldTest	クラス MPxFieldNode に追加された、パーティクル単位のフィールドアトリビュートサポートを示します。
exportJointClusterDataCmd	すべてのジョイントクラスタノードの検索方法を例示し、MFnWeightGeometryFil6ter 関数セットと MItGeometry イテレータを使用して、各ジョイントクラスタによって変形するジオメトリごとに、1CV あたりのウェイトを書き出すコマンド。
exportSkinClusterDataCmd	スムーズスキンデータを別のフォーマットに書き出すコマンド。
findFileTexturesCmd	シーン内のファイルテクスチャノードを見つけるコマンド。
findTexturesPerPolygonCmd	各ポリゴンに割り当てられたファイルテクスチャノードを見つけるコマンド。
flipUVCmd	UV を操作する MPxPolyTweakUVCommand クラスの使用例。
helix2Cmd	元に戻すとやり直しを実装するコマンド。
helixTool	OpenGL を使用してガイドラインを引くツール。
helloCmd	引数を取る小さなコマンド。
helloWorldCmd	最初の単純なコマンド。
idleTest	ノード内におけるアトリビュートの依存状況を表示するコマンド。
instanceCallbackCmd	インスタンスの追加と削除のメッセージの受け取りの例を示します。
instancerListCmd	MFnInstancer と MItInstancer クラスを使用して、シーンですべてのパーティクルインスタンスを列挙する方法を示します。
intersectCmd	メッシュとスポットライトの間にある交差ポイントを発見する方法を例示します。この例では、高速化された MFnMesh 交差手法がデモされます。
listLightLinksCmd	ライトリンク情報を検索するコマンド。
listPolyHolesCmd	選択された各ポリゴンメッシュのすべての穴のリストを生成するコマンド。
lockEvent	ノードとプラグのロックに関する API コールバックの例。
marqueeTool	マウス選択を実装するコマンド。
meshOpCmd	MFnMesh に追加されたハイレベルなポリゴン API メソッドの使用例。
meshReorderCmd	ユーザ定義の開始フェースに基づいてポリゴンメッシュを再インデックスするコマンド
motionPathCmd	モーションパスに沿ってオブジェクトをアニメートするコマンド。
motionTraceCmd	キーフレームが設定されたオブジェクトの位置を段階的に評価し、モーションパスカーブを描くコマンド。
moveCurveCVsCmd	複数の CV を原点に移動するコマンド。
nodeInfoCmd	ディペンデンシーグラフ走査の例を示すコマンド。
nodeMessageCmd	アクティブセレクションリストにあるすべてのノードに対してコールバックを追加するコマンド。
particlePathsCmd	API からのパーティクル ID 情報を使用し、時間の経過に伴いパーティクルの位置から一連の NURBS カーブを得るコマンド。
particleSystemInfoCmd	パーティクル情報を読み込むための新しい MFnParticleSystem クラスの使用例。
pfxInfoCmd	Maya® Paint Effects™ からレンダリングライン情報を抽出する方法を例示します。
pickCmd	名前別にオブジェクトを選択するコマンド。
pointOnMeshInfo	ワールド空間の位置とポリゴンメッシュ上の法線を計算する MEL コマンドと DG ノード。
polyMessageCmd	頂点、エッジおよびフェースコンポーネントの ID 変更を受け取る MPolyMessage クラスの使用法を示します。
polyPrimitiveCmd	ポリゴンを作成するコマンド。
progressWindowCmd	MProgressWindow クラスの使用法を示します。
referenceQueryCmd	シーン内のリファレンスファイルについて有益な情報を検索するコマンド。
renderViewInteractiveRenderCmd	MRenderView クラスの startRender() メソッドに追加された即座のフィードバック設定の例を示します。
scanDagCmd	DAG 走査の例を示すコマンド。
scanDagSyntax	DAG 走査の例を示すとともに、構文オブジェクトを使用して、受け取る引数を解析するコマンド。
spiralAnimCurveCmd	オブジェクトをらせん形に移動させるコマンド。
splitUVCmd	ポリゴンメッシュ上の選択した UV の共有を解除する(UV を分割する)コマンド。
surfaceCreateCmd	MFnNurbsSurface 関数セットを使用して、複数の CV とノットから NURBS サーフェスを作成するコマンド。
surfaceTwistCmd	NURBS サーフェスの CV 位置またはポリゴンの頂点位置を変更することで、y 軸中心にサーフェスをツイストするコマンド。
threadTestCmd	MThreadPool スレッドクラスの使用方法を示すコマンド。
threadTestWithLocksCmd	MThreadPool および MSpinLock スレッドクラスの使用方法を示すコマンド。
translateCmd	オブジェクトを移動するコマンド。
undoRedoMsgCmd	MEventMessage クラスに追加された新しい元に戻す(Undo)とやり直し(Redo)イベントの使用法を示します。
userMsgCmd	MUserEventMessage クラスの使用法を示します。この例では、文字列で識別されるユーザ定義イベントの作成、除去および表示が可能です。
userMsgCmd	ユーザ定義メッセージの使用方法を示すコマンド。このコマンドは、API を介して名前付きイベントを登録、登録解除、表示するオプションをサポートします。この例では、入力時に単純にメッセージを出力するコールバックを使用します。
viewCallbackTest	プリレンダリングコールバック、ポストレンダリングコールバック、ビュー破壊コールバックを受け取る方法を例示します。
volumeLightCmd	MFnVolumeLight クラスの使用例。
whatisCmd	オブジェクトに関する API 型の情報を出力するコマンド。
zoomCameraCmd	カメラを通したビューを拡大するコマンド。

ディペンデンシーグラフノードプラグイン

affectsNode	MPxNode::setDependentsDirty() メソッドの新しい使用例を示します。この新しいメソッドは、ダイナミックおよび非ダイナミックな(つまりスタティックな) Maya アトリビュートに関連する attributeAffects() リレーションシップを考慮に入れています。
animCubeNode	初めからポリゴンメッシュを作成し、そのメッシュをディペンデンシーグラフアトリビュートに出力するディペンデンシーノードのサンプル。
apiMeshShape	新しい型のポリゴンメッシュとシェイプに特有のジオメトリデータを登録するシェイプノードと、その新しいシェイプ型を作成するノードのサンプル。
apiSimpleShape	コンポーネントの操作方法をデモしたシェイプノードの例。MPxComponentShape クラスを使用します。
arcLenNode	ジオメトリを入力として取る単純なノードのサンプル。
buildRotationNode	代数計算を行う単純なノード。
circleNode	比較的複雑なプロシージャアニメーションのサンプル。
closestPointOnCurve	数学関数に応じてクラスタの複数の CV にウェイトを設定するコマンド。
componentScaleManip	スケールマニピュレータで頂点の位置を制御する変換機能の使い方を示す複雑なサンプル。
curveArrowsNode	透明度の使用方法と、MPxLocatorNode の「最新」の描画機能を示します。
customImagePlane	ユーザ定義イメージプレーンの作成方法を示します。
cvColorNode	NURBS サーフェスの各 CV の上部に、カラーを適用したポイントを描くロケータディペンデンシーノードのサンプル。
cvColorShader	頂点カラー(CPV)をソフトウェアレンダリングすることを可能にします。
exampleMRampAttribute	カスタムノードで ramp アトリビュートを実行する手順を示すサンプル。
footPrintManip	対応するマニピュレータがあるロケータディペンデンシーノードのサンプル。footPrint ロケータを選択して footPrint マニピュレータを表示するには、マニピュレータの表示ツール(Show Manipulator Tool)を使用します。
footPrintNode	ロケータディペンデンシーノードのサンプル。実はロケータとは、ユーザによるオーバーライドが可能な複数の draw メソッドが設定された DAG ノードです。この特定のロケータによって、足跡が描かれます。
fullLoftNode	NURBS カーブの配列から NURBS サーフェスを作成するリアルなロフトディペンデンシーノードのサンプル。
genericAttributeNode	ノードで汎用アトリビュートを作成および使用する方法を示します。
geometrySurfacConstraint	ユーザ定義コンストレイントの作成方法を示します。
jitterNode	単純な汎用プロシージャノード。
latticeNoise	ディペンデンシーノードにおける複雑なジオメトリ変更の例。低レベルのディペンデンシーグラフにアクセスしてノードをフックするコマンドを伴います。
multiCurveNode	MArrayDataBuilder クラスを使用するディペンデンシーノードのサンプル。
NodeMonitor	指定されたノードをモニタするクラス。
offsetNode	CV のウェイトに従って頂点のオフセットを行う、デフォーマディペンデンシーノードのサンプル。
particleAttrNode	パーティクル単位のデータをパーティクルシェイプにマッピングするカスタムノードの定義方法を示します。
pnTrianglesNode	ATI Radeon 固有のハードウェアシェーダプラグイン。
pointOnMeshInfo	ワールド空間の位置とポリゴンメッシュ上の法線を計算する MEL コマンドと DG ノード。
pointOnSubdNode	ディペンデンシーノードへの入力としてサブディビジョンサーフェスを検索する方法を示すサンプル。
polyTrgNode	poly API クラス MPxPolyTrg を使用してメッシュのユーザ定義の三角分割を追加する方法を示すサンプル。
quadricShape	OpenGL gluQuadric 関数を使用して 2 次シェイプを実装する、単純なシェイプノードのサンプル。
rockingTransform	ロッキングモーションを定義する MPxTransform の実施手順を例示するサンプル。
rockingTransformCheck	ロッキングモーションを定義してユーザ入力値をチェックする MPxTransform の実施手順のサンプル。
rotateManip	回転マニピュレータに対する別の設定を示すサンプル。
shellNode	手順を追って貝殻を生成し、それらをメッシュとして出力するディペンデンシーグラフノード。
simpleLoftNode	コンストラクションヒストリを設定した状態で、カーブに対してユーザ定義のロフト関数を実装するノード。内部のディペンデンシーノードにジオメトリ(NURBS サーフェス)を渡す方法も示します。
sineNode	単純なプロシージャアニメーションのサンプル。
stringFormatNode	入力と出力アトリビュートとして文字列を使用する方法を示します。
surfaceBumpManip	この例では、pointOnSurface マニピュレータを使ってサーフェス上のマニピュレータの位置の近くにある頂点を変更する方法を示します。
swissArmyManip	既存のユーザ定義マニピュレータをすべて 1 つのノードにアタッチしたサンプル。
transCircleNode	移動アトリビュートを入力および出力として使用するディペンデンシーノードのサンプル。単一のディペンデンシーグラフ接続を介して、X、Y、Z のアトリビュートをすべて転写する方法を示します。また、アトリビュートエディタ(Attribute Editor)のサンプルテンプレートも組み込まれています。
weightListNode	デフォーマの weightList アトリビュートにあるマルチアトリビュートを操作する方法を例示します。
yTwistNode	変形した頂点を Y 軸中心にツイストするデフォーマディペンデンシーノードのサンプル。

ユーザ定義のディペンデンシーグラフノード - ダイナミクスノードの作成

以下に示すユーザ定義のディペンデンシーグラフノードによって、MPxEmitterNode、MPxSpringNode と MPxFieldNode から派生するダイナミクスノードが作成されます。

ownerEmitter	particleShape によって定義される複数のポイントから一定方向に放射する、パーティクルエミッタノードのサンプル。
simpleEmitter	単一のポイントから一定方向に放射するパーティクルエミッタノードのサンプル。
simpleFluidEmitter	新しい MPxFluidEmitterNode クラスを使用して Maya の標準的な流体エミッタの大半の機能を実行する手順を示すサンプル流体エミッタノード。
simpleSpring	シミュレーションに使用するばねの法則を定義するスプリングノードのサンプル。
sweptEmitter	カーブまたはサーフェス上のポイントから一定方向に放射する、パーティクルエミッタノードのサンプル。
torusField	それ自体と一定距離との間で attract-repel フィールドを実装する、フィールドノードのサンプル。

レンダリングプラグイン

blastCmd	オフスクリーンレンダリング API 拡張機能を使用する方法を示します。
blindDataMesh	カラー情報をハードウェアシェーディングノードに供給するためのブラインドデータの使用例。
CgFx Shader	詳細な機能を数多く備えたハードウェアシェーダプラグイン。
renderAccessNode	レンダリングコールバックの処理方法を示します。
renderViewRenderCmd	MRenderView クラスを使用してレンダービュー(Render View)ウィンドウにフルイメージをレンダリングする方法を示します。
renderViewRenderRegionCmd	MRenderView クラスを使用して Maya のレンダービュー(Render View)で現在選択されている領域をレンダー(Render Region)を更新する方法を示します。
sampleCmd	MRenderUtil::sampleShadingNetwork() を使用して、シェーディンググループまたはノードをサンプリングする方法を示します。
sampleParticles	MRenderUtil::sampleShadingNetwork() を使用して、シェーディンググループまたはノードをサンプリングし、パーティクルオブジェクトにカラーを割り当てる方法を示します。
ShadingConnection	シェーダのアトリビュートに関する有益な情報を保存しているクラス。上流に接続されるものを含みます。
ShapeMonitor	シェイプノードやテクスチャノードをモニタし、最後の書き出し以降の変更内容を記録するクラス。
shiftNode	テクスチャプラグイン内からの uvCoord と refPointCamera を変更する例を示します。
hwManagedTextureShader	テクスチャキャッシュを効率的に管理する方法を示します。
OpenGLViewportRenderer	Maya シーンビュー描画をオーバーライドする方法を示します。
D3DViewportRenderer	Direct3D を使用して Maya シーンビューにレンダーする方法を示します(Windows のみ)。
lensDistortionCallback	複数の描画パスを有効にして各パスのプリレンダー/ポストレンダーを待機する方法を示します。

その他のプラグイン

その他のプラグインを次に示します。

conditionTest	Maya 内で変更中の「条件」を表示します。
ddsFloatReader	.dds float ファイルフォーマットリーダの定義方法を示します。
eventTest	Maya 内で変更中の「イベント」を表示します。
filterAsciiFile	Maya ASCII ファイルのフィルタリングを制御する方法を示します。
hairCollisionSolver	MHairSystem を使用して、Maya のオブジェクトをヘア衝突アルゴリズムにオーバーライドする方法を示します。
helixMotifCmd	押すとらせん形を作成するボタンを備えた Motif ウィンドウを新たに作成します。このプラグインは、Linux のみで使用可能です。
idleTest	アイドルメッセージと UI から削除されたメッセージをプラグインで使用します。
iffInfoCmd	IFF イメージファイルから情報を抽出します。
iffPixelCmd	IFF イメージファイルからピクセル値を抽出します。
iffPpmCmd	IFF イメージファイルを PPM イメージファイルに変換します。
jlcVcrDevice	JL-Cooper MIDI VCR コントロールボックスにユーザ定義の MIDI 入力デバイスを作成します。このプラグインは、Linux のみで使用可能です。
lepTranslator	独自のマジックナンバーを定義し、MEL コマンドを読み取るファイルトランスレータのサンプルです。
maTranslator	MayaAscii ファイルに近い形式に変換するファイルトランスレータの例。
moveManip	ユーザ定義コンテキストを使った freePointTriad と距離マニピュレータの使用方法を示す単純なマニピュレータ。
moveNumericTool	正投影ビューでの移動を実行するとともに、移動ツール(Move Tool)の使用時にユーザが精密な移動値を入力できるようにする選択アクションツールです。
moveTool	正投影ビューでの移動を実行する選択アクションツールです。
pnTrianglesNode	このノードは、ディペンデンシーノードへの入力としてサブディビジョンサーフェスを検索する方法を示す、単純なサンプルです。
simpleImageFile	新規のイメージファイルフォーマットの定義方法を示します。
simpleSolverNode	createNode を介して登録した、xy プレーン上の単純なユーザ定義シングルボーン IK ソルバのサンプル。createNode を介してプラグインソルバを登録すると、ikMCsolver などの既定以外の IK ソルバと同じ登録手順になります。
tiffFloatReader	.tif float ファイルフォーマットリーダの定義方法を示します。
viewCaptureCmd	OpenGL を使用して現在の3D ビューを取り込み、そのビューを PPM ファイルに書き込みます。

シェーダのソースコードのサンプル

シェーダのソースコードのサンプルは、シェーダのソースコードのサンプルに用意されています。

システムプラグイン

次の表に、Maya に付属している一部のシステムプラグインのソースを示します。その他のほとんどのサンプルコードと異なり、これらのソースコードは、複雑な実稼動用プラグインのサンプルです。

各ソースの詳細については、『トランスレータ機能』マニュアルを参照してください。このマニュアルのコンパイル版は、Maya パッケージに同梱されています。トランスレータガイドは、http://www.autodesk.com/maya-docs-archive の Maya ドキュメントアーカイブにあります。現在のリストは以下のとおりです。

animImportExport	アニメーション情報をシーン間で移動できるようにするトランスレータ。
objExport	Wavefront OBJ 書き出しトランスレータ。
ribExport	Pixar® RenderMan® RIB 書き出しトランスレータ。

サンプル プラグインの概要

MEL コマンド プラグイン

ディペンデンシー グラフ ノード プラグイン

ユーザ定義のディペンデンシー グラフ ノード - ダイナミクス ノードの作成

レンダリング プラグイン