pymel.core.modeling.sphere

sphere(*args, **kwargs)

The sphere command creates a new sphere. The number of spans in the in each direction of the sphere is determined by the useTolerance attribute. If -ut is true then the -tolerance attribute will be used. If -ut is false then the -sections attribute will be used.

Flags:

Long Name / Short Name Argument Types Properties
axis / ax float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The primitive’s axis
caching / cch bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory / ch bool ../../../_images/create.gif
  Turn the construction history on or off.
degree / d int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The degree of the resulting surface: 1 - linear, 3 - cubic Default:3
endSweep / esw float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The angle at which to end the surface of revolution. Default is 2Pi radians, or 360 degrees. Default:6.2831853
frozen / fzn bool ../../../_images/query.gif ../../../_images/edit.gif
   
heightRatio / hr float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Ratio of heightto widthDefault:2.0
name / n unicode ../../../_images/create.gif
  Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
nodeState / nds int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Modifies the node state. See the node documentation for more information. Note:For advanced users only. Flag can have multiple arguments, passed either as a tuple or a list.
object / o bool ../../../_images/create.gif
  Create the result, or just the dependency node.
pivot / p float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The primitive’s pivot point
polygon / po int ../../../_images/create.gif
  The value of this argument controls the type of the object created by this operation 0: nurbs surface1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)3: Bezier surface4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)Advanced flags
radius / r float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The radius of the object Default:1.0
sections / s int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The number of sections determines the resolution of the surface in the sweep direction. Used only if useTolerance is false. Default:8
spans / nsp int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The number of spans determines the resolution of the surface in the opposite direction. Default:1
startSweep / ssw float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The angle at which to start the surface of revolution Default:0
tolerance / tol float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The tolerance with which to build the surface. Used only if useTolerance is true Default:0.01
useTolerance / ut bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Use the specified tolerance to determine resolution. Otherwise number of sections will be used. Default:false Common flags

Derived from mel command maya.cmds.sphere

Example:

import pymel.core as pm

# Create sphere with radius 10
pm.sphere( r=10 )
# Result: [nt.Transform(u'nurbsSphere1'), nt.MakeNurbSphere(u'makeNurbSphere1')] #

# Query the radius of the new sphere
r = pm.sphere( 'nurbsSphere1', q=True, r=True )

# Create half sphere
pm.sphere( ssw=0, esw=180 )
# Result: [nt.Transform(u'nurbsSphere2'), nt.MakeNurbSphere(u'makeNurbSphere2')] #

# Use tolerance to determine how many spans the new sphere has
pm.sphere( ut=True, tol=0.01 )
# Result: [nt.Transform(u'nurbsSphere3'), nt.MakeNurbSphere(u'makeNurbSphere3')] #

# Use sections to determine how many spans the new sphere has
pm.sphere( ut=False, s=8 )
# Result: [nt.Transform(u'nurbsSphere4'), nt.MakeNurbSphere(u'makeNurbSphere4')] #