polyCylinder command

概要

polyCylinder([axis=[linear, linear, linear]], [caching=boolean], [constructionHistory=boolean], [createUVs=int], [height=linear], [name=string], [nodeState=int], [object=boolean], [radius=linear], [roundCap=boolean], [subdivisionsAxis=int], [subdivisionsCaps=int], [subdivisionsHeight=int], [subdivisionsX=int], [subdivisionsY=int], [subdivisionsZ=int], [texture=int])

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

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

新しいポリゴン円柱を作成します。

戻り値

string[]

オブジェクト名とノード名

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

フラグ

axis, caching, constructionHistory, createUVs, height, name, nodeState, object, radius, roundCap, subdivisionsAxis, subdivisionsCaps, subdivisionsHeight, subdivisionsX, subdivisionsY, subdivisionsZ, texture

ロングネーム(ショートネーム) 引数タイプ プロパティ

Common poly creation operation flags

axis(ax) [linear, linear, linear]

円柱の作成に使用するプリミティブ軸を指定します。
Q: 照会すると float[3] を返します。

caching(cch) boolean

すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。

constructionHistory(ch) boolean

コンストラクションヒストリをオンまたはオフにします(適切な場合)。コンストラクションヒストリがオンの場合、対応するノードがメッシュのヒストリチェーンに挿入されます。コンストラクションヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクションヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリチェーンに挿入されます。

createUVs(cuv) int

UV を作成するかどうかを指定します。

0: UV なし
1: 正規化なし
2: 正規化
3: 正規化してアスペクト比を保持

既定: 2

height(h) linear

円柱の高さです。
既定: 2.0

name(n) string

新しく作成するノードの名前を設定します。ネームスペースパスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。

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

object(o) boolean

結果のオブジェクト、またはディペンデンシーノードのみを作成します(適切な場合)。

radius(r) linear

円柱の半径です。
既定: 1.0

roundCap(rcp) boolean

キャップの丸めが必要かどうかを示します。
既定: false

subdivisionsAxis(sa) int

軸を中心とするサブディビジョン
既定: 20

subdivisionsCaps(sc) int

キャップのサブディビジョンです。
既定: 0

subdivisionsHeight(sh) int

高さに沿ったサブディビジョンです。
既定: 1

subdivisionsX(sx) int

円柱の X 方向のサブディビジョン数を指定します。
C: 既定は 20 です。
Q: 照会すると int を返します。

subdivisionsY(sy) int

円柱の Y 方向のサブディビジョン数を指定します。
C: 既定は 1 です。
Q: 照会すると int を返します。

subdivisionsZ(sz) int

円柱の Z 方向のサブディビジョン数を指定します。
C: 既定は 1 です。
Q: 照会すると int を返します。

texture(tx) int

適用するテクスチャのメカニズムを指定します。0=テクスチャなし、1=オブジェクト、2=フェース。
既定: 2

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

Python 例

import maya.cmds as cmds

# Create a rectangle, with 10 subdivisions in the X direction,
# 15 subdivisions in the Y direction and 20 subdivisions in the Z direction,
# the height of the cylinder is 20.
cmds.polyCylinder( sx=10, sy=15, sz=5, h=20)

# Create a cylinder, called "myCylinder", on each direction there are 5 subdivisions.
cmds.polyCylinder(n='myCylinder', sx=5, sy=5, sz=5)

# Query the radius of "myCylinder"
r = cmds.polyCylinder( 'myCylinder', q=True, r=True )

コマンド (Python)	MEL バージョン
polyCylinder	カテゴリ内: モデリング, ポリゴン

polyCylinder

概要

戻り値

関連

フラグ

Python 例