ジャンプ先: 概要. 戻り値. フラグ. Python 例.
circle([caching=boolean], [center=[linear, linear, linear]], [centerX=linear], [centerY=linear], [centerZ=linear], [constructionHistory=boolean], [degree=int], [first=[linear, linear, linear]], [firstPointX=linear], [firstPointY=linear], [firstPointZ=linear], [fixCenter=boolean], [name=string], [nodeState=int], [normal=[linear, linear, linear]], [normalX=linear], [normalY=linear], [normalZ=linear], [object=boolean], [radius=linear], [sections=int], [sweep=angle], [tolerance=linear], [useTolerance=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
circle は、取り消し可能、照会可能、および編集可能です。
circle コマンドは円または部分的な円(円弧)を作成します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
caching, center, centerX, centerY, centerZ, constructionHistory, degree, first, firstPointX, firstPointY, firstPointZ, fixCenter, name, nodeState, normal, normalX, normalY, normalZ, object, radius, sections, sweep, tolerance, useTolerance
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
caching(cch)
|
boolean
|
  
|
|
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
|
|
center(c)
|
[linear, linear, linear]
|
|
|
|
centerX(cx)
|
linear
|
|
|
|
centerY(cy)
|
linear
|
|
|
|
centerZ(cz)
|
linear
|
|
|
|
degree(d)
|
int
|
|
|
作成される円の次数です: 1 - 一次、3 - 三次
既定: 3
|
|
first(fp)
|
[linear, linear, linear]
|
|
|
fixCenter が false の場合、円の始点です。fixCenter が true の場合、円の方向を定義します。
|
|
firstPointX(fpx)
|
linear
|
|
|
|
firstPointY(fpy)
|
linear
|
|
|
|
firstPointZ(fpz)
|
linear
|
|
|
|
fixCenter(fc)
|
boolean
|
|
|
円の中心指定した中心点にを固定します。そうでなければ、円は指定した最初のポイントから開始します。
既定: true
|
|
nodeState(nds)
|
int
|
|
|
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
|
|
normal(nr)
|
[linear, linear, linear]
|
|
|
|
normalX(nrx)
|
linear
|
|
|
|
normalY(nry)
|
linear
|
|
|
|
normalZ(nrz)
|
linear
|
|
|
|
radius(r)
|
linear
|
|
|
|
sections(s)
|
int
|
|
|
セクション数は、円の解像度を定義します。useTolerance が false の場合のみに使用されます。
既定: 8
|
|
sweep(sw)
|
angle
|
|
|
スィープ角度は円の完成度を定義します。完全な円は 2Pi ラジアン、つまり 360 度です。
既定: 6.2831853
|
|
tolerance(tol)
|
linear
|
|
|
円を構築する場合の許容値です。useTolerance が true の場合のみに使用されます。
既定: 0.01
|
|
useTolerance(ut)
|
boolean
|
|
|
指定したしきい値を使用して解像度を決定します。指定されていない場合は、セクション数が使用されます。
既定: false
|
|
| 共通のフラグ |
constructionHistory(ch)
|
boolean
|
|
|
コンストラクション ヒストリをオンまたはオフにします。
|
|
name(n)
|
string
|
|
|
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
|
|
object(o)
|
boolean
|
|
|
結果のオブジェクト、またはディペンデンシー ノードのみを作成します。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# create full circle at origin on the x-y plane
cmds.circle( nr=(0, 0, 1), c=(0, 0, 0) )
# create half circle at origin on the x-y plane with radius 2
cmds.circle( nr=(0, 0, 1), c=(0, 0, 0), sw=180, r=2 )