ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. 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
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-allLocked(-al) boolean createqueryedit
選択した頂点上のすべての法線がロックされている(フリーズされている)かどうかを照会します。
-deformable(-def) boolean createqueryedit
このフラグは現在サポートしていません(既定は true)。このフラグは、次のリリースで除去予定です。
-freezeNormal(-fn) boolean createqueryedit
法線の値を現在値でフリーズ(ロック)することを指定します。
-normalX(-x) float createqueryedit
法線の X 値を指定します。
-normalXYZ(-xyz) float float float createqueryeditmultiuse
法線の XYZ 値を指定します。このフラグを単独で使用した場合は、選択されたすべてのコンポーネントに、指定した法線の XYZ 値が使用されます。フラグが複数回使用されている場合、使用数は選択したコンポーネントの数と一致する必要があります。フラグを使用するたびに、特定のコンポーネントの法線を指定します。
-normalY(-y) float createqueryedit
法線の Y 値を指定します。
-normalZ(-z) float createqueryedit
法線の Z 値を指定します。
-relative(-rel) createqueryedit
指定した法線の値を、現在値を基準にして追加します。
-unFreezeNormal(-ufn) boolean createqueryedit
現在値でフリーズしている法線の値をフリーズ解除(ロック解除)することを指定します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

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 //