polyEvaluate

ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

polyEvaluate [-accurateEvaluation] [-activeShells] [-activeUVShells] [-area] [-boundingBox] [-boundingBox2d] [-boundingBoxComponent] [-boundingBoxComponent2d] [-displayStats] [-edge] [-edgeComponent] [-face] [-faceArea] [-faceComponent] [-format] [-shell] [-triangle] [-triangleComponent] [-uvArea] [-uvComponent] [-uvEdgePairs] [-uvFaceArea] [-uvSetName string] [-uvShell] [-uvShellIds] [-uvcoord] [-uvsInShell int] [-vertex] [-vertexComponent] [-worldArea] [-worldFaceArea] [poly poly...]

polyEvaluate は、取り消し可能、照会不可能、および編集不可能です。

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

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

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

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

戻り値

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-accurateEvaluation(-ae)
バウンディング ボックスの計算で正確な結果を出すために使用します。頂点の数が多いオブジェクトでは、正確な評価に時間がかかります。
-activeShells(-as)
アクティブなシェルのインデックスを整数の配列で返します。
-activeUVShells(-aus)
アクティブな UV シェル(指定されていない場合は現在のマップ)のインデックスを整数の配列で返します。
-area(-a)
ローカル空間にあるオブジェクトのフェースのサーフェス領域を float で返します。
-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))］として返します。
-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)) として返します。
-displayStats(-ds)
アクティブなビューのポリゴン統計の表示/非表示を切り替えます。このフラグを指定すると、その他すべてのフラグは無視されます(サポートしていません。headsUpDisplay コマンドを参照してください)。
-edge(-e)
エッジの数を整数で返します。
-edgeComponent(-ec)
選択したエッジのオブジェクトの数を整数で返します。
-face(-f)
フェースの数を整数で返します。
-faceArea(-fa)
ローカル空間で選択/指定した面のサーフェス領域を float の配列で返します。
-faceComponent(-fc)
選択したフェースのオブジェクトの数を整数で返します。
-format(-fmt)
結果を明示的な文で表示するために使用します。
-shell(-s)
シェル(切断されている断片)の数を整数で返します。
-triangle(-t)
三角形の数を整数で返します。
-triangleComponent(-tc)
選択したコンポーネントの三角形の数を整数で返します。
-uvArea(-uva)
2D 空間にあるオブジェクトの面の UV 領域を float で返します。
-uvComponent(-uvc)
選択した UV 座標のオブジェクトの数を整数で返します。
-uvEdgePairs(-uep)
選択/指定したエッジ上にある UV のペアを返します。
-uvFaceArea(-ufa)
2D 空間で選択/指定した面の UV 領域を float の配列で返します。
-uvSetName(-uvs)	string
UV セットを指定するためにテクスチャ頂点を照会するときに使用します。UV セットが指定されていない場合は、オブジェクトの現在のマップが使用されます。
-uvShell(-us)
UV シェルの数(指定されていない場合は現在のマップ)を整数で返します。
-uvShellIds(-usi)
選択/指定した面または UV のUV シェルのインデックスを整数の配列で返します(指定されていない場合は現在のマップ)。それぞれの面/UV に対して 1 つのシェル インデックスを返します。
-uvcoord(-uv)
UV 座標の数(指定されていない場合は現在のマップ)が整数で返されます。
-uvsInShell(-uis)	int
指定したシェル内のすべての UV を返します(指定されていない場合は現在のマップ)。現在の選択に対するシェル インデックスを取得する場合は activeUVShells を使用し、指定した面または UV に対するシェル インデックスを取得する場合は uvShellIds を使用します。
-vertex(-v)
頂点の数を整数で返します。
-vertexComponent(-vc)
選択した頂点のオブジェクトの数を整数で返します。
-worldArea(-wa)
ワールド空間にあるオブジェクトのフェースのサーフェス領域を float で返します。
-worldFaceArea(-wfa)
ワールド空間で選択/指定した面のサーフェス領域を float の配列で返します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

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 1 0 0 2 0 0

//formatted query of all information
polyEvaluate -fmt;
// Result: vertex=25 edge=40 face=16 uvcoord=25 triangle=32 shell=1 uvShell=1
//    vertexComponent=0 edgeComponent=0 faceComponent=2 uvComponent=0
//    triangleComponent=4 activeShells= 0 activeUVShells= 0 uvShellIds= 0 0
//    faceArea= 1.5625 1.5625 worldFaceArea= 1.5625 1.5625 uvFaceArea= 0.0625 0.0625
//    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 uvArea=1.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

// UV Shell information
polySphere -sx 20 -sy 20;
polyAutoProjection;
hilite;
select -r pSphere1.f[282] pSphere1.f[189:192];

// number of UV shells
polyEvaluate -uvShell
// Result: 6

// active UV Shells
polyEvaluate -activeUVShells
// Result: 1 4 5

// UV shell IDs for selected faces
polyEvaluate -uvShellIds
// Result: 1 1 1 4 5

// UV edge pairs for selected edges
polyEvaluate -uvEdgePairs pSphere1.e[642];
// Result: pSphereShape1.map[67] pSphereShape1.map[74] pSphereShape1.map[307] pSphereShape1.map[300]