Creates a polygon-based geometric primitive at the origin or, depending on the primitive options you have set, wherever you
click in the scene view (). You can then move, scale, rotate, and reshape the new object using the standard tools and polygon menu items.
Note When the view is set to mode, primitives created using the option do not appear shaded until the primitive creation steps are complete.
See also Create polygon primitives.
The creation settings for many polygon types share some settings like , , and . See also Common settings for polygon primitives.
-
-
Specifies the distance from the center of the sphere in all directions. (For interactive creation, appears as a single-click
setting only.)
Note(For interactive creation, these appear as a single-click setting only.)
-
-
Specifies the width of the cube.
-
-
Specifies the height of the cube.
-
-
Specifies the depth of the cube.
-
-
Specifies the distance from the center of the cylinder. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the height of the cylinder. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the distance from the base of the cone in all directions. (For interactive creation, appears as a single-click setting
only.)
-
-
Specifies the height of the cone. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the distance along the x axis (by default). (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the measurement along the y axis (by default). (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the distance from the center of the torus in all directions. (For interactive creation, appears as a single-click
setting only.)
-
-
Specifies the size of the sections that make up a torus. Change this value to increase or decrease the radius of these sections.
-
-
The Twist option value specifies the twist angle of the torus. Change this value to adjust the distance around the torus in
all directions.
A prism is a polyhedron with two polygonal faces lying in parallel planes and with the other faces parallelograms.
When creating a prism, you can set the following options:
-
-
Enter values or use the slider to specify the length of the prism (the distance between the two polygonal faces). (For interactive
creation, appears as a single-click setting only.)
-
-
Enter values or use the slider to specify the side length of the prism’s polygonal caps. (For interactive creation, appears
as a single-click setting only.)
-
-
Enter the number of sides for the ends of the prism. The above example is a triangular prism (3 sides). The size and volume
of the prism increases with the number of sides if the edge length and length/height are kept constant.
A pyramid is a polyhedron with a polygon base and triangles with a common vertex for faces. Maya creates 3-, 4-, or 5-sided
pyramids with equilateral triangles.
When creating a pyramid, you can set the following options:
-
-
Enter values or use the slider to specify the side length of all faces. (For interactive creation, appears as a single-click
setting only.)
-
-
Select the number of sides for the base of the pyramid (3, 4, or 5).
The options are very similar to the options for the cylinder polygonal shape, with the addition of (which specifies the thickness of the wall).
-
-
Specifies the distance from the center of the pipe in all directions. (For interactive creation, appears as a single-click
setting only.)
-
-
Specifies the height of the pipe. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the thickness of the pipe walls.
A helix is a curve in three dimensional space that lies on a cylinder, so that its angle to a plane perpendicular to the axis
is constant.
-
-
Specifies the number of coils.
-
-
Specifies the height of the helix. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the width of the helix. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the radius of the helix coils. (For interactive creation, appears as a single-click setting only.)
-
-
Specifies the direction of the helix’s twist: clockwise or counterclockwise.
The soccer ball is a truncated icosahedron: thirty-two faces, alternating hexagons and pentagons.
For this shape, you can set the following options:
-
-
Enter values or use the slider to specify the radius of the soccer ball. (For interactive creation, appears as a single-click
setting only.)
-
-
Enter values or use the slider to specify the side length of the soccer ball. (For interactive creation, appears as a single-click
setting only.)
You can create many different types of polygonal platonic solids. Platonic solids are shapes where all sides are equal, all
angles are the same, and all faces are identical. These are:
- : four triangular faces
- : eight triangular faces
- : twelve pentagonal faces
- : twenty triangular faces
(The cube—the fifth platonic solid—has a separate listing in the primitives.)
You can switch between these types by selecting in the or in the option box for .
For these four shapes, you can set the following options:
-
-
Enter values or use the slider to specify the radius of the platonic solid. (For interactive creation, appears as a single-click
setting only.)
-
-
Enter values or use the slider to specify the side length of the platonic solid. (For interactive creation, appears as a single-click
setting only.)
-
-
You can switch between platonic solid types in the options for these shapes.
You can position and scale primitives as you create them using your mouse, without having to use transformation tools. This
option stays on until you turn it off. For more information, see Create polygon primitives.
This option interacts with . When is turned on, you must select a primitive type again in order to create another primitive. When this option is turned off,
you can interactively create multiple primitives of the same type, until you select another tool.
Common settings for polygon primitives
The values you enter in these boxes change the primitive by adding or taking away faces of the polygonal surfaces.
Almost all primitives allow you to subdivide along the height axis. The exception is the helix, which subdivides per coil
instead.
Primitives with radial symmetry allow you to subdivide around the axis. These include spheres, cylinders, cones, tori, pipes,
and helixes.
Primitives with caps allow you to subdivide the caps. These include cylinder, cones, pipes and helixes.
The plane allows subdivisions along the width axis, and the cube allows subdivisions along both the width and depth.
-
-
This option defines the number of subdivisions there are around the axis. This option is called in the and the .
Increase or decrease this value to add or take away faces around the axis defined by the option.
-
-
This option defines the number of subdivisions there are along the axis defined by the option. is equivalent to the Y direction by default. This option is called in the and the . Increase or decrease this value to add or take away faces in the direction.
- / ,
-
When is set to X or Y, depth is equivalent to the Z direction for polygonal cubes. When is set to Z, depth is equivalent to the Y direction. This option is called in the and the . Increase or decrease this value to add or take away faces along the depth.
-
-
Caps are the tops, bottoms, or sides of cones, cylinders, prisms, pyramids, pipes, and helixes. This option defines the number
of subdivisions around the origin of the primitive caps. This option is called in the and the . Increase or decrease this value to add or take away faces around the caps.
-
-
This option allows you to create a round surface for the cap. Your S value must be one or greater to see the round cap effect. This option applies to the , , , and primitives.
This option does not appear in .
Tip
To set the axis for your primitive during interactive creation, you can use the orthogonal views. Whichever view you create
your primitive in—top, front, or side—is the way your primitive’s axis will be aligned (y, z, or x).
By default, a primitive is created along the axis. You can change a primitive’s default orientation before you create it by changing the Axis option.
You cannot change the orientation for a new primitive from the , but you can enter values in the boxes in the .
The following table lists the common Create UVs attributes for each type of polygon primitive.
Shape |
Normalize |
Preserve Aspect Ratio |
Other Options |
|
|
|
Yes
|
|
Yes
|
Yes
|
|
|
Yes
|
Yes
|
|
|
Yes
|
Yes
|
|
|
|
Yes
|
|
|
|
|
|
|
Yes
|
Yes
|
|
|
Yes
|
Yes
|
|
|
|
|
|
|
Yes
|
Yes
|
|
|
Yes
|
Yes
|
|
|
Yes
|
Yes
|
|
For details on attributes, see:
Preparing a primitive for texture mapping
UV texture coordinates are assigned for texture mapping by default. If you do not plan to map textures on a polygonal primitive,
you can turn off the option in the options window.
Important note about UVs
If UVs are not present on an object, you cannot see mapped textures. This can happen if you inadvertently create a primitive
object with the option turned off.
To correct the problem, select the faces of the primitive and use any of the mapping items in the menu.
You can then use the to view the created . Select the object and use any of the UV creation or editing menu items.
Texture mapping options for primitives with faces or caps
The options window for primitives with faces or caps includes a menu where you can select how you want the texture map to cover the primitive when you assign it. This menu is also available from the .
(Default.) This option assigns UV texture coordinates on the primitive for texture mapping.
The various normalization settings fit the UVs within the 0 to 1 texture space. is the default setting.
-
-
No normalization occurs and the texture remains its true size.
-
-
This option maps the texture over each face of the primitive and normalizes it so that it covers the entire object.
-
-
Only available for , and .
If you select this option, Maya maps the texture to each face separately.
-
-
(Default.) Normalized UVs maintain the original ratios of the UVs without stretching the UVs to fill the 0 to 1 texture space.
This option affects the appearance of the texture map on the primitive.
UV options for primitive spheres
The options window for a polygonal sphere primitive includes a menu where you can select an item to specify how you want the texture map to behave at the poles. This menu is also available from the .
-
-
Creates a UV texture map where the rings of triangles around the poles are treated as triangles with a single common vertex
(the pole).
-
-
(Default.) Creates a UV texture map where the rings of triangles around the poles are treated as individual triangles, giving
the edges of the UV map a sawtooth look. Often, this looks better in the 3D view; however, it also introduces texture borders,
which may not always be desirable.
Adjust primitive after creation
When is turned on for primitives, you can optionally modify the subdivisions for a primitive using the following options. These
options exist only for primitives that possess subdivision attributes.
- after create
-
Adds additional steps to the process that let you adjust the subdivisions for the primitive when interactively creating primitives. The number of additional
steps is dependent on the primitive type. The default setting is on when is turned on.
- after create
-
Adds additional steps to the process that let you adjust the cap subdivisions on primitives that contain caps (Cylinder, cone, pyramid, prism, helix,
pipe). The default setting is off. This option can only be used when the after create option is turned on.
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License