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

概要

polyTorus([axis=[linear, linear, linear]], [constructionHistory=boolean], [createUVs=boolean], [name=string], [object=boolean], [radius=linear], [sectionRadius=linear], [subdivisionsX=int], [subdivisionsY=int], [texture=boolean], [twist=angle])

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

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

新しいポリゴン トーラスを作成します。

戻り値

string[]オブジェクト名とノード名

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

関連

polyCone, polyCube, polyCube, polyCylinder, polyPlane, polySphere

フラグ

axis, constructionHistory, createUVs, name, object, radius, sectionRadius, subdivisionsX, subdivisionsY, texture, twist
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
axis(ax) [linear, linear, linear] createqueryedit
トーラスの作成に使用するプリミティブ軸を指定します。
Q: 照会すると vector を返します。
radius(r) linear createqueryedit
トーラスの半径を指定します。
C: 既定は 0.5 です。
Q: 照会すると float を返します。
sectionRadius(sr) linear createqueryedit
トーラスの断面半径を指定します。
C: 既定は 0.25 です。
Q: 照会すると float を返します。
twist(tw) angle createqueryedit
トーラスの断面のねじれを指定します。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
subdivisionsX(sx) int createqueryedit
トーラスの X 方向のサブディビジョン数(セクション数)を指定します。
C: 既定は 20 です。
Q: 照会すると int を返します。
subdivisionsY(sy) int createqueryedit
トーラスの Y 方向のサブディビジョン数(セクションごとのセグメント数)を指定します。
C: 既定は 20 です。
Q: 照会すると int を返します。
createUVs(cuv) boolean createqueryedit
このフラグを使用すると、テクスチャを適用することができます。
C: 既定はオンです(UV が計算されます)。
Q: 照会すると int を返します。
texture(tx) boolean create
このフラグはサポートしていません。次のリリースで除去されます。代わりに -cuv/createUVs フラグを使用してください。
共通のフラグ
object(o) boolean create
結果のオブジェクト、またはディペンデンシー ノードのみを作成します(適切な場合)。
共通のフラグ
name(n) string create
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、 操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。

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

Python 例

import maya.cmds as cmds

cmds.polyTorus( sx=8, sy=16, r=10, sr=1 )
#result has 8 sections of 16 segments,
#the main radius is 10, the section radius is 1.
cmds.polyTorus( sx=5, sy=4, tx=False )
cmds.move( -3, 0, 0 )
#result has 5 sections of 4 segments, default sizes.
#no texture offsets are generated.
cmds.polyTorus( sx=5, sy=4, tw=45 )
cmds.move( 3, 0, 0 )
#result has 5 sections of 4 segments, default sizes.
#The sections are rotated.
#Query the radius of the torus
r = cmds.polyTorus( 'polyTorus1' ,q=True, r=True )