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

概要

polyExtrudeFacet([attraction=float], [caching=boolean], [constructionHistory=boolean], [createCurve=boolean], [divisions=int], [gain=float], [gravity=[linear, linear, linear]], [gravityX=linear], [gravityY=linear], [gravityZ=linear], [inputCurve=name], [keepFacesTogether=boolean], [keepFacetTogether=boolean], [localCenter=int], [localDirection=[linear, linear, linear]], [localDirectionX=linear], [localDirectionY=linear], [localDirectionZ=linear], [localRotate=[angle, angle, angle]], [localRotateX=angle], [localRotateY=angle], [localRotateZ=angle], [localScale=[float, float, float]], [localScaleX=float], [localScaleY=float], [localScaleZ=float], [localTranslate=[linear, linear, linear]], [localTranslateX=linear], [localTranslateY=linear], [localTranslateZ=linear], [magnX=linear], [magnY=linear], [magnZ=linear], [magnet=[linear, linear, linear]], [name=string], [nodeState=int], [offset=float], [pivot=[linear, linear, linear]], [pivotX=linear], [pivotY=linear], [pivotZ=linear], [random=float], [reverseAllFaces=boolean], [rotate=[angle, angle, angle]], [rotateX=angle], [rotateY=angle], [rotateZ=angle], [scale=[float, float, float]], [scaleX=float], [scaleY=float], [scaleZ=float], [smoothingAngle=angle], [taper=float], [taperCurve_FloatValue=float], [taperCurve_Interp=int], [taperCurve_Position=float], [thickness=float], [translate=[linear, linear, linear]], [translateX=linear], [translateY=linear], [translateZ=linear], [twist=angle], [weight=float], [worldSpace=boolean])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

フェースを押し出します。フェースは、個別またはまとめて押し出すことができ、ワールド空間またはオブジェクト空間で操作できます。

戻り値

stringノード名

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

関連

polyAppend, polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate

フラグ

attraction, caching, constructionHistory, createCurve, divisions, gain, gravity, gravityX, gravityY, gravityZ, inputCurve, keepFacesTogether, keepFacetTogether, localCenter, localDirection, localDirectionX, localDirectionY, localDirectionZ, localRotate, localRotateX, localRotateY, localRotateZ, localScale, localScaleX, localScaleY, localScaleZ, localTranslate, localTranslateX, localTranslateY, localTranslateZ, magnX, magnY, magnZ, magnet, name, nodeState, offset, pivot, pivotX, pivotY, pivotZ, random, reverseAllFaces, rotate, rotateX, rotateY, rotateZ, scale, scaleX, scaleY, scaleZ, smoothingAngle, taper, taperCurve_FloatValue, taperCurve_Interp, taperCurve_Position, thickness, translate, translateX, translateY, translateZ, twist, weight, worldSpace
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
Common poly modifier operation flags
attraction(att) float createqueryedit
磁石に関連する引き付けです。範囲は[-2.0, 2.0]です。
既定: 0.0
caching(cch) boolean createqueryedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
createCurve(cc) boolean create
true の場合、この操作でカーブを作成することができます。
divisions(d) int createqueryedit
押し出しをいくつのディビジョンに分割するかを指定します。
既定: 1
gain(ga) float createqueryeditmultiuse
コンポーネントごとの係数を増加します。Artisan を使用してペイントできます。
既定: 1.0
gravity(g) [linear, linear, linear] createqueryedit
重力ベクトルです。
既定: 0.0, -1.0, 0.0
gravityX(gx) linear createqueryedit
重力の X 座標です。
gravityY(gy) linear createqueryedit
重力の Y 座標です。
gravityZ(gz) linear createqueryedit
重力の Z 座標です。
inputCurve(inc) name create
このフラグは、操作のための入力として使用されるカーブの名前を指定します。
keepFacesTogether(kft) boolean createqueryedit
フェースの押し出し方法です。オンにするとフェースはまとめて引き出され(接続されたフェースは接続されたまま)、オフにすると個別に引き出されます。
既定: true
keepFacetTogether(xft) boolean createqueryedit
エッジの押し出し方法です。オンの場合、押し出されるエッジから生成される押し出しフェースは共に保持されます。そうでない場合は、個別に引き出されます。
既定: true
localCenter(lc) int createqueryedit
エッジのローカル中心です。0 = 中点、1 = 始点、2 = 終点です。
既定: 0
localDirection(ld) [linear, linear, linear] createqueryedit
ローカル空間の X 軸を決定する方向です。
既定: 1.0, 0.0, 0.0
localDirectionX(ldx) linear createqueryedit
X 軸の X 座標です。
localDirectionY(ldy) linear createqueryedit
X 軸の Y 座標です。
localDirectionZ(ldz) linear createqueryedit
X 軸の Z 座標です。
localRotate(lr) [angle, angle, angle] createqueryedit
ローカル回転です。
既定: 0.0, 0.0, 0.0
localRotateX(lrx) angle createqueryedit
ローカル回転の X 座標です。範囲は [0, 360] です。
localRotateY(lry) angle createqueryedit
ローカル回転の Y 座標です。範囲は [0, 360] です。
localRotateZ(lrz) angle createqueryedit
ローカル回転の Z 座標です。法線に沿って回転します。範囲は [0, 360] です。
localScale(ls) [float, float, float] createqueryedit
ローカル スケールです。
既定: 1.0, 1.0, 1.0
localScaleX(lsx) float createqueryedit
スケールの X 座標です。
localScaleY(lsy) float createqueryedit
スケールの Y 座標です。
localScaleZ(lsz) float createqueryedit
スケールの Z 座標です。
localTranslate(lt) [linear, linear, linear] createqueryedit
ローカル移動です。
既定: 0.0, 0.0, 0.0
localTranslateX(ltx) linear createqueryedit
ローカル平行移動の X 座標。
localTranslateY(lty) linear createqueryedit
ローカル平行移動の Y 座標。
localTranslateZ(ltz) linear createqueryedit
ローカル平行移動の Z 座標。法線に沿って移動します。
magnX(mx) linear createqueryedit
磁石の X 座標です。
magnY(my) linear createqueryedit
磁石の Y 座標です。
magnZ(mz) linear createqueryedit
磁石の Z 座標です。
magnet(m) [linear, linear, linear] createqueryedit
磁石のベクトルです。
既定: 0.0, 0.0, 0.0
name(n) string create
作成されるノードに名前をつけます。
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
offset(off) float createqueryedit
ローカル オフセットです。フェースは、フェースの内側に向かってこの距離に移動します。
既定: 0.0
pivot(pvt) [linear, linear, linear] createqueryedit
スケールと回転のためのピボットです。
既定: 0.0, 0.0, 0.0
pivotX(pvx) linear createqueryedit
ピボットの X 座標です。
pivotY(pvy) linear createqueryedit
ピボットの Y 座標です。
pivotZ(pvz) linear createqueryedit
ピボットの Z 座標です。
random(ran) float createqueryedit
すべてのパラメータにランダム値を指定します。
既定: 0.0
reverseAllFaces(raf) boolean createqueryedit
オンの場合、すべてのフェースを押し出す際に元のフェースが反転されます。
既定: true
rotate(ro) [angle, angle, angle] createqueryedit
X, Y, Z を中心とする回転角度です。
既定: 0.0, 0.0, 0.0
rotateX(rx) angle createqueryedit
X 軸を中心とする回転角度です。
rotateY(ry) angle createqueryedit
Y 軸を中心とする回転角度です。
rotateZ(rz) angle createqueryedit
Z 軸を中心とする回転角度です。
scale(s) [float, float, float] createqueryedit
スケールのベクトルです。
既定: 1.0, 1.0, 1.0
scaleX(sx) float createqueryedit
スケールの X 座標です。
scaleY(sy) float createqueryedit
スケールの Y 座標です。
scaleZ(sz) float createqueryedit
スケールの Z 座標です。
smoothingAngle(sma) angle createqueryedit
新しいエッジがスムージングされる角度です。
既定: kPi/6.0
taper(tp) float createqueryedit
押し出しパスに沿ってテーパまたはスケールします。
既定: 1.0
taperCurve_FloatValue(cfv) float createqueryedit
?????
taperCurve_Interp(ci) int createqueryedit
?????
既定: 0
taperCurve_Position(cp) float createqueryedit
?????
thickness(tk) float createqueryedit
オブジェクトに一貫した厚さを与えるために、フェースがその元の位置から外側に移動します。
既定: 0.0f
translate(t) [linear, linear, linear] createqueryedit
移動ベクトルです。
既定: 0.0, 0.0, 0.0
translateX(tx) linear createqueryedit
移動の X 座標です。
translateY(ty) linear createqueryedit
移動の Y 座標です。
translateZ(tz) linear createqueryedit
移動の Z 座標です。
twist(twt) angle createqueryedit
押し出しに沿ったツイストまたは回転です。
既定: 0.0
weight(w) float createqueryedit
重力に関連したウェイトです。
既定: 0.0
worldSpace(ws) boolean createqueryedit
このフラグは、使用するリファレンスを指定します。オンの場合: すべてのジオメトリ値はワールド リファレンスで考慮されます。オフの場合: すべてのジオメトリ値はオブジェクト リファレンスで考慮されます。
C: 既定はオフです。
Q: 照会すると int を返します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Separate
cmds.polyPlane( n='plg', w=10, h=10 )
cmds.polyExtrudeFacet( 'plg.f[71:72]', 'plg.f[81:82]', kft=False, ltz=2, ls=(.5, .5, 0) )
# Facets are extruded then scaled separately


# Together
cmds.polyExtrudeFacet( 'plg.f[17:18]', 'plg.f[27:28]', kft=True, ltz=2, ls=(.5, .5, 0) )
# Facets are extruded then scaled together