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

概要

subdPlanarProjection [-caching boolean] [-constructionHistory boolean] [-createNewMap boolean] [-imageCenter float float] [-imageCenterX float] [-imageCenterY float] [-imageScale float float] [-imageScaleU float] [-imageScaleV float] [-insertBeforeDeformers boolean] [-keepImageRatio boolean] [-mapDirection string] [-name string] [-nodeState int] [-projectionCenter linear linear linear] [-projectionCenterX linear] [-projectionCenterY linear] [-projectionCenterZ linear] [-projectionHeight linear] [-projectionScale linear linear] [-projectionWidth linear] [-rotate angle angle angle] [-rotateX angle] [-rotateY angle] [-rotateZ angle] [-rotationAngle angle] [-smartFit boolean] [-worldSpace boolean]

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

TsubProjCmdBase は、選択したサブディビジョン フェースにマッピングを作成するコマンドの基本クラスです。正射投影を使用してマップをオブジェクトに投影します。isu 領域、isv 領域、icx 領域、icy 領域から定義されたマップの断片は、pcx 位置、pcy 位置、pcz 位置に配置されます。

戻り値

stringノード名

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

caching, constructionHistory, createNewMap, imageCenter, imageCenterX, imageCenterY, imageScale, imageScaleU, imageScaleV, insertBeforeDeformers, keepImageRatio, mapDirection, name, nodeState, projectionCenter, projectionCenterX, projectionCenterY, projectionCenterZ, projectionHeight, projectionScale, projectionWidth, rotate, rotateX, rotateY, rotateZ, rotationAngle, smartFit, worldSpace
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-caching(-cch) boolean createqueryedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
-nodeState(-nds) int createqueryedit

Maya のディペンデンシー ノードには 6 種類の設定可能な状態があります。通常(Normal)(0)、エフェクトなし(HasNoEffect)(1)、ブロッキング(Blocking)(2)ステータスは、グラフの評価方法を変更するために使用されます。

待機 - 通常(Waiting-Normal)(3)、待機 - エフェクトなし(Waiting-HasNoEffect)(4)、待機 - ブロッキング(Waiting-Blocking)(5)は、内部でのみ使用されます。これらは、インタラクション(例: 操作)の実行中にグラフのパーツを一時的に遮断します。操作が完了すると、ステータスは適切にリセットされます(例: 待機 - ブロッキング(Waiting-Blocking) は ブロッキング(Blocking) にリセットされます)。

通常(Normal)およびブロッキング(Blocking)のケースはすべてのノードに適用できますが、エフェクトなし(HasNoEffect)はノード特定です。多くのノードはこのオプションをサポートしていません。プラグインは状態を MPxNode::state アトリビュートに保存します。誰もがこのアトリビュートを設定したり確認したりすることができます。これらの 3 つの状態に関するその他の詳細は次の通りです。

状態 説明
通常(Normal) 通常のノードの状態です。これが既定の設定です。
エフェクトなし(HasNoEffect)

エフェクトなし(HasNoEffect)オプション(別名: 通過)は、同じデータ タイプの出力を生成する入力を操作している場合に使用されます。 ほぼすべてのデフォーマが、他のいくつかのノードと同様に、この状態をサポートします。前に説明したように、すべてのノードでサポートされるわけではありません。

ノードの計算メソッドでエフェクトなし(HasNoEffect)状態のサポートを実装し、適切な操作を実行することが一般的です。プラグインはエフェクトなし(HasNoEffect)もサポートします。

この状態を普通に実装するには、ノードにアルゴリズムを適用しないで、適合する出力に直接入力をコピーします。デフォーマの場合は、この状態を適用することにより、入力ジオメトリが出力でデフォーム解除されたままになります。

ブロッキング(Blocking)

これはディペンデンシー ノードのベース クラスで実装され、すべてのノードに適用されます。ブロッキング(Blocking)は評価フェーズ中に接続に適用されます。 ブロックされた接続に対する評価要求が失敗を返すと、目的プラグが現在の値を保持します。 ダーティな伝播はこの状態の間接的な影響を受けますが、ブロックされた接続がクリーンアップされることはありません。

ノードをブロッキング(Blocking)に設定すると、すべての送信接続が解除されたのと同じ動作になる可能性があります。 ブロックされたノードの評価を直接要求しない限り、その後に再評価されることはありません。ブロックされたノードは getAttr 要求に引き続き応答しますが、下流ノードの getAttr は、ブロックされたノードを再評価しないことに注意してください。

ブロッキング(Blocking)に対して階層のルート変換を設定しても、自動的にはこの階層の子変換に影響しません。これを実行するには、ブロッキング(Blocking)状態に対してすべての子ノードを明示的に設定する必要があります。

たとえば、すべての子トランスフォームをブロッキング(Blocking)に設定するには、次のスクリプトを使用します。

 import maya.cmds as cmds def blockTree(root): nodesToBlock = [] for node in {child:1 for child in cmds.listRelatives( root, path=True, allDescendents=True )}.keys(): nodesToBlock += cmds.listConnections(node, source=True, destination=True ) for node in {source:1 for source in nodesToBlock}.keys(): cmds.setAttr( '%s.nodeState' % node, 2 )

このスクリプトを適用してオブジェクトの描画を継続できますが、アニメートは行えません。


既定: kdnNormal
共通のフラグ
-constructionHistory(-ch) boolean create
コンストラクション ヒストリをオンまたはオフにします。
-createNewMap(-cm) boolean createqueryedit
このフラグを true に設定すると、マップが存在していない場合は、渡された名前を持つ新しいマップを作成します。
-imageCenter(-ic2) float float createqueryedit
2D モデル レイアウトの中心ポイントを指定します。
C: 既定は 0.5 0.5 です。
Q: 照会すると float[2] を返します。
-imageCenterX(-icx) float createqueryedit
2D モデル レイアウトの中心ポイントの X を指定します。
C: 既定は 0.5 です。
Q: 照会すると float を返します。
-imageCenterY(-icy) float createqueryedit
2D モデル レイアウトの中心ポイントの Y を指定します。
C: 既定は 0.5 です。
Q: 照会すると float を返します。
-imageScale(-is2) float float createqueryedit
UV のスケールを指定します。2D 中心点を基準にして U 空間または V 空間にある 2D バージョンのモデルを拡大または縮小します。
C: 既定は 1.0 1.0 です。
Q: 照会すると float[2] を返します。
-imageScaleU(-isu) float createqueryedit
U のスケールを指定します。2D 中心点を基準にして U 空間にある 2D バージョンのモデルを拡大または縮小します。
C: 既定は 1.0 です。
Q: 照会すると float を返します。
-imageScaleV(-isv) float createqueryedit
V のスケールを指定します。2D 中心点を基準にして V 空間にある 2D バージョンのモデルを拡大または縮小します。
C: 既定は 1.0 です。
Q: 照会すると float を返します。
-insertBeforeDeformers(-ibd) boolean create
このフラグは、デフォーマ ノードをシェイプに適用する前か後どちらに投影ノードを挿入するかを指定します。デフォーマの後でノードを挿入すると、アニメーション中にテクスチャがずれて、ほとんどの場合うまくいきません。
C: 既定はオンです。
-keepImageRatio(-kir) boolean create
True の場合はイメージ比率が維持されます。
-mapDirection(-md) string create
マッピング方向を指定します。
「x」、「y」、「z」では、対応する軸に沿ってマップが投影されます。
「c」では、現在のカメラのビュー方向に沿って投影されます。
「p」では、現在のカメラがパース ビューである場合に投影されます。
「b」では、選択したオブジェクトに最適なプレーンに沿って投影されます。
-name(-n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
-projectionCenter(-pc) linear linear linear createqueryedit
このプラグは、マップを投影する原点を指定します。
C: 既定は 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。
-projectionCenterX(-pcx) linear createqueryedit
マップを投影する原点の X を指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
-projectionCenterY(-pcy) linear createqueryedit
マップを投影する原点の Y を指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
-projectionCenterZ(-pcz) linear createqueryedit
マップを投影する原点の Z を指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
-projectionHeight(-ph) linear createqueryedit
3D 投影軸に関連するマップの高さを指定します。
C: 既定は 1.0 です
Q: 照会すると float を返します。
-projectionScale(-ps) linear linear createqueryedit
3D 投影軸に関連するマップの幅と高さを指定します。
C: 既定は 1.0 1.0 です。
Q: 照会すると float[2] を返します。
-projectionWidth(-pw) linear createqueryedit
3D 投影軸を基準にして、マップの幅を指定します。
C: 既定は 1.0 です
Q: 照会すると float を返します。
-rotate(-ro) angle angle angle createqueryedit
マッピング回転角度を指定します。
C: 既定は 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。
-rotateX(-rx) angle createqueryedit
X マッピング回転角度を指定します。
C: 既定は 0.0 です。
Q: 照会すると float[3] を返します。
-rotateY(-ry) angle createqueryedit
Y マッピング回転角度を指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
-rotateZ(-rz) angle createqueryedit
Z マッピング回転角度を指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
-rotationAngle(-ra) angle createqueryedit
マッピング空間の回転角度を指定します。マップは、角度を正にするとマップされたモデル上で反時計回りに回転し、負にすると時計回りに回転します。
C: 既定は 10.0 です。
Q: 照会すると float を返します。
-smartFit(-sf) boolean create
True の場合はスマート フィット アルゴリズムを使用します。
-worldSpace(-ws) boolean createqueryedit
このフラグは、使用するリファレンスを指定します。オンの場合: すべてのジオメトリ値はワールド リファレンスで考慮されます。オフの場合: すべてのジオメトリ値はオブジェクト リファレンスで考慮されます。
C: 既定はオフです。
Q: 照会すると int を返します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

// Create a cube
createSubdCube;

// Replace default UVs on half of the plane :
// Rotates projection around X, rotate the map of 45 degrees,
// and reduces of half the projected map.
subdPlanarProjection -rx 90 -ra 45.0 -pc 0 0 0 -is 0.5 0.5 "subdivCube1.smf[*][*]";