polyEvaluate

移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

polyEvaluate [-accurateEvaluation] [-area] [-boundingBox] [-boundingBox2d] [-boundingBoxComponent] [-boundingBoxComponent2d] [-displayStats] [-edge] [-edgeComponent] [-face] [-faceComponent] [-format] [-shell] [-triangle] [-triangleComponent] [-uvComponent] [-uvSetName string] [-uvcoord] [-vertex] [-vertexComponent] [-worldArea] [poly poly...]

polyEvaluate は「元に戻す」が可能、「照会」が不可能、「編集」が不可能です。

MEL では、値はフラグを設定したときと同じ順序で返されます。Python には引数の順序という概念はないため、項目はキー設定された辞書にフラグ名の順で戻されます。Python では、要求された項目が 1 つだけの場合、辞書には返されません。
使いやすくするために、フラグを設定しなければ、すべての値がエコーされます。

-fmt/format を除くすべてのフラグは照会フラグです。使いやすくするため、-q フラグは省略できます。

フォーマットしない出力の注意事項は以下のとおりです。

• 3D バウンディング ボックスは 3 つの float で、2D バウンディング ボックスは 2 つの float で返されます。
• バウンディング ボックスを照会したのに計算できない場合は（たとえば、コンポーネントが選択されていないコンポーネント バウンディング ボックス、マッピングされていないオブジェクトの 2D バウンディング ボックスなど）、それぞれの配列エレメントに 0 が返されるため、出力配列のインデックスは一貫性を保ちます。
• int 値（トポロジ フラグで照会）は、float 値（バウンディング ボックス フラグで照会）と混在できません。 このため、フラグを設定しないと int 値のみが返されます。

戻り値

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-displayStats(-ds)
アクティブなビューのポリゴン統計の表示/非表示を切り替えます。 このフラグを指定すると、その他すべてのフラグは無視されます（サポートしていません。headsUpDisplay コマンドを参照してください）。
-vertex(-v)
頂点の数を整数で返します。
-edge(-e)
エッジの数を整数で返します。
-face(-f)
フェースの数を整数で返します。
-uvcoord(-uv)
UV 座標の数（指定されていない場合は現在のマップ）が整数で返されます。
-triangle(-t)
三角形の数を整数で返します。
-shell(-s)
シェル（切断されている断片）の数を整数で返します。
-boundingBox(-b)
3D 空間のオブジェクトのバウンディング ボックスを、MEL では 6 つの float（xmin xmax ymin ymax zmin zmax）として、Python では 3 組のタプル［ ((xmin,xmax), (ymin,ymax), (zmin,zmax))］として返します。
-boundingBox2d(-b2)
2D 空間の（指定されていない場合はカレント マップに対する）オブジェクトの UV バウンディング ボックスを、MEL では 4 つの float（xmin xmax ymin ymax）として、Python では 3 組のタプル［((xmin,xmax), (ymin,ymax), (zmin,zmax))］として返します。
-vertexComponent(-vc)
選択した頂点のオブジェクトの数を整数で返します。
-edgeComponent(-ec)
選択したエッジのオブジェクトの数を整数で返します。
-faceComponent(-fc)
選択したフェースのオブジェクトの数を整数で返します。
-uvComponent(-uvc)
選択した UV 座標のオブジェクトの数を整数で返します。
-triangleComponent(-tc)
選択したコンポーネントの三角形の数を整数で返します。
-boundingBoxComponent(-bc)
3D 空間で選択したコンポーネントのバウンディング ボックスを、MEL では 6 つの float（xmin xmax ymin ymax zmin zmax）として、Python では 3 組のタプル［ ((xmin,xmax), (ymin,ymax), (zmin,zmax))］として返します。
-boundingBoxComponent2d(-bc2)
2D 空間で選択した UV 座標のバウンディング ボックスを、MEL では 4 つの float（ xmin xmax ymin ymax）として、Python では 2 組のタプル［ ((xmin,xmax), (ymin,ymax))］として返します。
-accurateEvaluation(-ae)
バウンディング ボックスの計算で正確な結果を出すために使用します。頂点の数が多いオブジェクトでは、正確な評価に時間がかかります。
-format(-fmt)
結果を明示的な文で表示するために使用します。
-uvSetName(-uvs)	string
UV セットを指定するためにテクスチャ頂点を照会するときに使用します。UV セットが指定されていない場合は、オブジェクトのカレント マップが使用されます。
-area(-a)
ローカル空間にあるオブジェクトのフェースのサーフェス領域を float で返します。
-worldArea(-wa)
ワールド空間にあるオブジェクトのフェースのサーフェス領域を float で返します。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL の例

polyPlane -n plg -sx 4 -sy 4 -w 5 -h 5;
select plg.f[2] plg.f[4];

// query the number of faces
polyEvaluate -f;
// Result: 16

// query the number of triangles
polyEvaluate -t;
// Result: 32

// query the number of selected faces
polyEvaluate -faceComponent;
// Result: 2

// query the number of vertices and faces
polyEvaluate -v -f;
// Result: 25 16

// formatted query of the number of vertices and faces
polyEvaluate -v -f -fmt;
// Result: vertex=25 face=16

// query all
polyEvaluate;
// Result: 25 40 16 25 32 1 0 0 2 0

//formatted query of all information
polyEvaluate -fmt;
// Result: vertex=25 edge=40 face=16 uvcoord=25 triangle=32 shell=1
//    vertexComponent=0 edgeComponent=0 faceComponent=2 uvComponent=0
//    boundingBox= X[-2.50,2.50] Y[0.00,0.00] Z[-2.50,2.50]
//    boundingBoxComponent= X[-2.50,1.25] Y[0.00,0.00] Z[0.00,2.50]
//    boundingBox2d= U[0.00,1.00] V[0.00,1.00]
//    boundingBoxComponent2d= U[0.00,0.75] V[0.00,0.50]
//    area=25.00 worldArea=25.00

// accurate bounding box evaluation
polyCylinder -r 1 -h 2 -sx 20 -sy 1 -sz 1 -ax 0 1 0 -cuv 1 -ch 1;
 // Result: pCylinder1 polyCylinder1 //
rotate -r -os 38.340875 0 0 ;
rotate -r -os 0 0 -36.177835 ;

polyEvaluate -b;
 // Result: -1.397482 1.397482 -1.716432 1.716432 -1.651247 1.651247 //
polyEvaluate -b -ae;
 // Result: -1.397482 1.397482 -1.407107 1.407107 -1.359833 1.359833 //

// Local and World Space Area
polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 0 1 -tx 1 -ch 1;
setAttr "pCube1.scaleY" 2;
polyEvaluate -a;
// Result: 6
polyEvaluate -wa;
// Result: 10