移動先: 概要 戻り値 キーワード. 関連項目. フラグ. MEL 例.

概要

polyNormalPerVertex [-allLocked boolean] [-deformable boolean] [-freezeNormal boolean] [-normalX float] [-normalXYZ float float float] [-normalY float] [-normalZ float] [-relative] [-unFreezeNormal boolean]

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

法線(x, y, z)をポリゴン オブジェクトの頂点にコネクトします。 照会フラグと併用する場合、指定したコンポーネントにコネクトされた法線を返します。ただし照会すると、共有の有無に関係なく、頂点のすべての法線(すべての頂点とフェースの組み合わせ)を返します。

戻り値

boolean成功または失敗。

戻り値の型は照会モードでは照会フラグが基になります。

キーワード

poly, userNormals, polyNormals, setNormal, vertexNormal, vertex

関連項目

polyAverageNormal, polyNormal, polySetToFaceNormal, polySoftEdge

フラグ

allLocked, deformable, freezeNormal, normalX, normalXYZ, normalY, normalZ, relative, unFreezeNormal
ロング ネーム(ショート ネーム) 引数型 プロパティ
-relative(-rel) createqueryedit
指定した法線の値を、カレント値を基準にして追加します。
-normalX(-x) float createqueryedit
法線の X 値を指定します。
-normalY(-y) float createqueryedit
法線の Y 値を指定します。
-normalZ(-z) float createqueryedit
法線の Z 値を指定します。
-normalXYZ(-xyz) float float float createqueryedit
法線の XYZ 値を指定します。
-freezeNormal(-fn) boolean createqueryedit
法線の値をカレント値でフリーズ(ロック)することを指定します。
-unFreezeNormal(-ufn) boolean createqueryedit
カレント値でフリーズしている法線の値をフリーズ解除(ロック解除)することを指定します。
-allLocked(-al) boolean createqueryedit
選択した頂点上のすべての法線がロックされている(フリーズされている)かどうかを照会します。
-deformable(-def) boolean createqueryedit
このフラグは現在サポートしていません(デフォルトは true)。このフラグは、次のリリースで削除予定です。

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

MEL 例

// To set the xyz values of normals of selected vertices:
polyNormalPerVertex -xyz .2 .3 .4;
// To set just the "x" value of normal of selected vertices:
polyNormalPerVertex -x .37;
// To add to the current value of the "y" normal value of selected vertices:
polyNormalPerVertex -rel -y .13;
// To query the normal values on selected vertices - This returns all normals
// regardless of whether they are shared or not:
polyNormalPerVertex -q -xyz;
// To query if the normals on the selected vertices are locked or not
polyNormalPerVertex -q -freezeNormal;
// To query if all the normals on the selected vertices are locked or not
polyNormalPerVertex -q -allLocked;
// More examples
file -f -new;
polyCube;
select -r pCube1.vtxFace[2][1] ;
polyNormalPerVertex -q -freezeNormal;
// Result: 0 //
// Now, lock the normal of a VertexFace on the cube
select -r pCube1.vtxFace[2][1] ;
polyNormalPerVertex -xyz 0.7071 0.7071 0;
// Query if the normal is locked for this vertexFace
polyNormalPerVertex -q -freezeNormal;
// Result: 1 //
// Query if the normal is locked for all the normals on this vertex
// Should return 0, because there are some other normals on
// this vertex that are not locked.
select -r pCube1.vtx[2] ;
polyNormalPerVertex -q -allLocked;
// Result: 0 //