ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
sphere([axis=[linear, linear, linear]], [caching=boolean], [constructionHistory=boolean], [degree=int], [endSweep=angle], [heightRatio=float], [name=string], [nodeState=int], [object=boolean], [pivot=[linear, linear, linear]], [polygon=int], [radius=linear], [sections=int], [spans=int], [startSweep=angle], [tolerance=linear], [useTolerance=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
sphere は、取り消し可能、照会可能、および編集可能です。
sphere コマンドは、新しい球を作成します。球の各方向のスパン数は useTolerance アトリビュートによって決まります。-ut が true の場合、-tolerance アトリビュートが使用されます。-ut が false の場合は、-sections アトリビュートが使用されます。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
cone, cylinder, nurbsCube, nurbsPlane, torus
axis, caching, constructionHistory, degree, endSweep, heightRatio, name, nodeState, object, pivot, polygon, radius, sections, spans, startSweep, tolerance, useTolerance
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
axis(ax)
|
[linear, linear, linear]
|
  
|
|
|
degree(d)
|
int
|
|
|
作成されるサーフェスの次数です: 1 - 一次、3 - 三次
既定: 3
|
|
endSweep(esw)
|
angle
|
|
|
回転サーフェスが終了角度。既定は 2π ラジアン(360 度)です。
既定: 6.2831853
|
|
heightRatio(hr)
|
float
|
|
|
|
pivot(p)
|
[linear, linear, linear]
|
|
|
|
radius(r)
|
linear
|
|
|
|
sections(s)
|
int
|
|
|
セクション数によって、サーフェスのスイープ方向の解像度が決まります。useTolerance が false の場合のみに使用されます。
既定: 8
|
|
spans(nsp)
|
int
|
|
|
スパン数によって、サーフェスの逆方向の解像度が決まります。
既定: 1
|
|
startSweep(ssw)
|
angle
|
|
|
|
tolerance(tol)
|
linear
|
|
|
サーフェスの構築で使用するしきい値です。useTolerance が true の場合のみに使用されます。
既定: 0.01
|
|
useTolerance(ut)
|
boolean
|
|
|
指定したしきい値を使用して解像度を決定します。指定されていない場合は、セクション数が使用されます。
既定: false
|
|
| 共通のフラグ |
constructionHistory(ch)
|
boolean
|
|
|
コンストラクション ヒストリをオンまたはオフにします。
|
|
name(n)
|
string
|
|
|
新しく作成するノードの名前を設定します。ネームスペース パスを含む場合、指定されたネームスペースの下に新しいノードが作成されます。ネームスペースが存在しない場合は、ネームスペースが作成されます。
|
|
object(o)
|
boolean
|
|
|
結果のオブジェクト、またはディペンデンシー ノードのみを作成します。
|
|
polygon(po)
|
int
|
|
|
この引数の値は、この操作で作成されるオブジェクトの タイプを制御します。
- 0: NURBS サーフェス
- 1: ポリゴン(nurbsToPolygonsPref を使用して変換用のパラメータを設定)
- 2: サブディビジョン サーフェス(nurbsToSubdivPref を使用して変換用のパラメータを設定)
- 3: ベジェ サーフェス
- 4: サブディビジョン サーフェス ソリッド(変換のためのパラメータを設定するには、nurbsToSubdivPref を使用)
|
|
| 高度なフラグ |
caching(cch)
|
boolean
|
|
|
ノード キャッシング モードを修正します。詳細については、ノードの説明を参照してください。
注: 上級ユーザ向けの機能です。
|
|
nodeState(nds)
|
int
|
|
|
ノード状態を修正します。詳細については、ノードの説明を参照してください。
注: 上級ユーザ向けの機能です。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Create sphere with radius 10
cmds.sphere( r=10 )
# Query the radius of the new sphere
r = cmds.sphere( 'nurbsSphere1', q=True, r=True )
# Create half sphere
cmds.sphere( ssw=0, esw=180 )
# Use tolerance to determine how many spans the new sphere has
cmds.sphere( ut=True, tol=0.01 )
# Use sections to determine how many spans the new sphere has
cmds.sphere( ut=False, s=8 )