Go to: Synopsis. Return value. Related.
Flags. MEL
examples.
polySphere [-axis
linear linear linear] [-constructionHistory boolean]
[-createUVs int] [-name string] [-object boolean] [-radius linear] [-subdivisionsX int] [-subdivisionsY int] [-texture int]
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 be used more than once in a
command. |
// Create a sphere, with 10 subdivisions in the X direction,
// and 15 subdivisions in the Y direction,
// the radius of the sphere is 20.
polySphere -sx 10 -sy 15 -r 20;
// Create a sphere, called "mySphere", on each direction there are 5 subdivisions.
polySphere -n mySphere -sx 5 -sy 5;
// Query the radius of the new sphere
float $r = `polySphere -q -sx mySphere`;