Go to: Synopsis. Return value. Related.
Flags. Python
examples.
polySphere([axis=[linear, linear, linear]], [constructionHistory=boolean],
[createUVs=int], [name=string], [object=boolean], [radius=linear], [subdivisionsX=int], [subdivisionsY=int], [texture=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
polySphere is undoable, queryable, and editable.
The sphere command creates a new polygonal sphere.
string[] |
Object name and node name. |
In query mode, return type is based on queried flag.
polyCone, polyCube, polyCube,
polyCylinder, polyPlane, polyTorus
axis, constructionHistory, createUVs, name,
object, radius,
subdivisionsX, subdivisionsY, texture
Long name (short name) |
Argument types |
Properties |
axis(ax) |
[linear, linear, linear] |
|
|
This flag specifies the primitive axis used to build the
sphere.
Q: When queried, this flag returns a float[3]. |
|
radius(r) |
linear |
|
|
This flag specifies the radius of the sphere.
C: Default is 0.5.
Q: When queried, this flag returns a float. |
|
subdivisionsX(sx) |
int |
|
|
This specifies the number of subdivisions in the X direction
for the sphere.
C: Default is 20.
Q: When queried, this flag returns an int. |
|
subdivisionsY(sy) |
int |
|
|
This flag specifies the number of subdivisions in the Y
direction for the sphere.
C: Default is 20.
Q: When queried, this flag returns an int. |
|
createUVs(cuv) |
int |
|
|
This flag alows a specific UV mechanism to be selected, while
creating the helix.
The valid values are 0, 1, or 2.
0 implies that no UVs will be generated (No texture to be
applied).
1 implies UVs are created with pinched at poles
2 implies UVs are created with sawtooth at poles
For better understanding of these options, you may have to open
the
texture view window
C: Default is 2 |
|
texture(tx) |
int |
|
|
This flag is obsolete and will be removed in the next release.
The -cuv/createUVs flag should be used instead. |
|
Common flags |
object(o) |
boolean |
|
|
Create the result, or just the dependency node (where
applicable). |
|
Common flags |
name(n) |
string |
|
|
Give a name to the resulting node. |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off (where applicable). If
construction history is on then the corresponding node will be
inserted into the history chain for the mesh. If construction
history is off then the operation will be performed directly on the
object.
Note: If the object already has construction history then
this flag is ignored and the node will always be inserted into the
history chain. |
|
Flag can appear in Create mode of
command |
Flag can appear in Edit mode of command |
Flag can appear in Query mode of command |
Flag can have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# Create a sphere, with 10 subdivisions in the X direction,
# and 15 subdivisions in the Y direction,
# the radius of the sphere is 20.
cmds.polySphere(sx=10, sy=15, r=20)
# Create a sphere, called "mySphere", on each direction there are 5 subdivisions.
cmds.polySphere( n='mySphere', sx=5, sy=5)
# Query the radius of the new sphere
r = cmds.polySphere( 'mySphere', q=True, sx=True )