MItMeshPolygon

MItMeshPolygon はポリゴン フェース イテレータです。あるメッシュ オブジェクトに対してこのクラスを初期化すると、フェース ID の順序でメッシュ内のすべてのフェースを反復処理できます。メッシュを参照する DAG パス、および特定のコンポーネントへの MObject リファレンスの両方に対してこのクラスを初期化すると、イテレータを演じや頂点など特定のコンポーネントに隣接するフェースに制限することもできます。

このイテレータは、より迅速にメッシュを調べられるので、メッシュのパーシング処理に便利です。エッジと頂点よりフェースの方が数が少なく、データ取得で重複が少ないからです。フェース イテレータとしての MItMeshPolygon には、主に以下から構成される、フェース固有のデータを取得するメソッドがあります。

• フェース構成（2 本を超える複数のエッジ）
• フェース - 頂点データ
• フェース - エッジ データ
• 隣接コンポーネント データ
• UV データ
• 頂点カラー データ
• ブラインド データやスムージング情報など、その他のデータ

MItMeshPolygon は、フェースごとにメッシュを迅速に検索する、またはフェース固有のデータをメッシュから要求する場合に理想的です。このクラスの使用法については、 splitUVCmd の例を参照してください。以下は、MItMeshPolygon クラスの使用例です。このサンプル コードでは MItMeshPolygon を使用してメッシュを走査して特定のフェースを調べ、そのフェースを構成するエッジを取得しています。

MStatus getFaceEdges( MObject mesh,

 int faceId,

 MIntArray faceEdges )

{

 MStatus status;

 // Reset the faceEdges array

 //

 faceEdges.clear();

 // Initialize a face iterator and function set

 //

 MItMeshPolygon faceIter( mesh, &status );

 MCheckStatus( status, “MItMeshPolygon constructor failed” );

 MFnMesh meshFn( mesh, &status );

 MCheckStatus( status, “MFnMesh constructor failed” );

 // Check to make sure that the faceId passed in is valid

 //

 if( faceId >= meshFn.numPolygons() || faceId < 0 )

 {

 cerr << “Invalid faceId.\n”;

 status = MS::kFailure;

 }

 else

 {

 // Now parse the mesh for the given face and

 // return the edges

 //

 for( ; !faceIter.isDone(); faceIter.next() )

 {

 // If we find the matching face, retrieve the

 // edge indices

 //

 if( faceIter.index() == faceId )

 {

 faceIter.getEdges( faceEdges );

 break;

 }

 }

 }

 return status;

}

MItMeshEdge

MItMeshEdge は、エッジごとにメッシュを反復処理し、エッジ固有のデータを取得します。このエッジ イテレータは、エッジ ID の順序でエッジを反復処理するか、渡されたコンポーネントに隣接するエッジを反復処理します。MltMeshEdge では、以下のタイプのデータを取得できます。

• エッジ構成（2 つの頂点）
• エッジ - フェース データ
• エッジ - 頂点データ
• エッジのスムージング
• 隣接コンポーネント データ

MItMeshEdge は、メッシュをエッジごとに調べ、エッジ固有のデータを取得する場合に最適です。以下のサンプル コードは、このエッジ イテレータの使用例です。この例では、メッシュのそれぞれのエッジが調べられ、開始頂点が収集されて、エッジ ID でインデックス付けされた配列内に保存されます。

MStatus getEdgeStartVertices( MObject mesh,

 MPointArray& pointArray )

{

 MStatus status;

 // Clear the output array

 //

 pointArray.clear();

 // Initialize our iterator

 //

 MItMeshEdge edgeIter( mesh, &status );

 MCheckStatus( status, “MItMeshEdge constructor failed” );

 // Now parse the mesh

 //

 for( ; !edgeIter.isDone(); edgeIter.next() )

 {

 // Retrieve the start vertex of each edge and append it to

 // our point array. Use the default object coordinate

 // system for our space

 //

 pointArray.append( edgeIter.point(0, MSpace::kObject) );

 }

 return status;

}

MItMeshVertex と MItMeshFaceVertex

MItMeshVertex は、頂点 ID の順序で頂点ごとにメッシュを反復処理し、頂点固有のデータを取得します。この頂点イテレータは、2 つのケースに最適で、以下のような頂点固有データを取得できます。

• 頂点構成（3D 位置）
• 頂点 - フェース データ
• 頂点 - エッジ データ
• 頂点法線
• UV データ（頂点に固有）
• カラー データ（頂点に固有）
• 隣接コンポーネント データ

MItMeshFaceVertex イテレータは、フェース ID の順序でフェース頂点ごとにメッシュを調べ、フェース頂点固有のデータを取得します。このフェース頂点イテレータでは、以下のようなデータを取得できます。

• 法線データ
• UV データ
• カラー データ

MFnMesh

MFnMesh には、メッシュ固有データを取得してメッシュを修正するメソッドが複数含まれています。イテレータを使用して特定のコンポーネントを検索し、MFnMesh を使用してそのコンポーネント上で操作を実行します。これについては splitUVCmd の例で説明しますが、この例ではメッシュで特定の UV を検索し、MFnMesh を使用して UV を「分割」します。

MFnMesh が提供するメソッドと MItMesh* イテレータは重複する部分がありますが、MFnMesh はメッシュ操作のグローバル ライブラリを表し、イテレータは各コンポーネントまわりを中心としたものです。以下のサンプル コードは、MFnMesh の一部の使用例です。この例では各種データを取得して修正します。このコードはコンパイルできないことに注意してください。

// The argument list contains a “...” to represent a “Fill in

// the data you would like here”

//

MStatus getRandomPolyData( MObject mesh, ... )

{

 MStatus status;

 // Initialize a function set to a polygonal mesh

 //

 MFnMesh meshFn( mesh, &status );

 MCheckStatus( status, “MFnMesh constructor failed” );

 // Retrieve topological information

 //

 int faceCount = meshFn.numPolygons();

 int edgeCount = meshFn.numEdges();

 int vertexCount = meshFn.numVertices();

 int faceVertexCount = meshFn.polygonVertexCount();

 int UVCount = meshFn.numUVs();

 MPointArray vertexList;

 meshFn.getPoints( vertexList );

 MFloatArray UArray;

 MFloatArray VArray;

 meshFn.getUVs( UArray, VArray );

 // Modify topological information

 //

 // Add a UV to the UV list – setUV will automatically grow

 // the UV list, based on the given index

 //

 meshFn.setUV( numUVs, 0.0, 0.0 );

 // Move vertex 0 to the origin of the world

 //

 MPoint origin( 0.0, 0.0. 0.0 );

 meshFn.setPoint( 0, origin, MSpace::kWorld );

 // Can also work with:

 //

 // - Vertex Colors

 // - Blind data

 // - etc.

 //

}