Three-Dimensional Graphics Primitives

One of the most powerful aspects of graphics in Mathematica is the availability of three-dimensional as well as two-dimensional graphics primitives. By combining three-dimensional graphics primitives, you can represent and render three-dimensional objects in Mathematica.

Point[{x,y,z}]point with coordinates x, y, z
Line[{{x1,y1,z1},{x2,y2,z2},...}]line through the points , , ...
filled polygon with the specified list of corners
Arrow[{pt1,pt2}]arrow pointing from to
Text[expr,{x,y,z}]text at position (see "Graphics Primitives for Text")

Three-dimensional graphics elements.

Every time you evaluate , it generates a random coordinate in three dimensions.
Click for copyable input
This generates a list of 20 random points in three-dimensional space.
Click for copyable input
Here is a plot of the points.
Click for copyable input
This gives a plot showing a line through 10 random points in three dimensions.
Click for copyable input

If you give a list of graphics elements in two dimensions, Mathematica simply draws each element in turn, with later elements obscuring earlier ones. In three dimensions, however, Mathematica collects together all the graphics elements you specify, then displays them as three-dimensional objects, with the ones in front in three-dimensional space obscuring those behind.

Every time you evaluate , it generates a random triangle in three-dimensional space.
Click for copyable input
This draws a single random triangle.
Click for copyable input
This draws a collection of 5 random triangles. The triangles in front obscure those behind.
Click for copyable input

By creating an appropriate list of polygons, you can build up any three-dimensional object in Mathematica. Thus, for example, all the surfaces produced by ParametricPlot3D are represented essentially as lists of polygons.

Point[{pt1,pt2,...}]a multipoint consisting of points at , , ...
Line[{line1,line2,...}]a multiline consisting of lines , , ...
Polygon[{poly1,poly2,...}]a multipolygon consisting of polygons , , ...

Primitives which can take multiple elements.

As with the two-dimensional primitives, some three-dimensional graphics primitives have multi-coordinate forms, which are a more efficient representation. When dealing with a very large number of primitives, using these multi-coordinate forms where possible can both reduce the memory footprint of the resulting graphic and make it render much more quickly.

defines merely the coordinates of a random triangle.
Click for copyable input
Using the multi-coordinate form of Polygon, this efficiently represents a very large number of triangles.
Click for copyable input

Mathematica allows polygons in three dimensions to have any number of vertices in any configuration. Depending upon the locations of the vertices, the resulting polygons may be non-coplanar or nonconvex. When rendering non-coplanar polygons, Mathematica will break the polygon into triangles, which are planar by definition, before rendering it.

The non-coplanar polygon is broken up into triangles. The interior edge joining the triangles is not outlined like the outer edges of the Polygon primitive.
Click for copyable input
Self-intersecting nonconvex polygons are filled according to an even-odd rule that alternates between filling and not filling at each crossing.
Click for copyable input
Cone[{{x1,y1,z1},{x2,y2,z2}}]a cone with a base radius of 1 centered around with the point at
Cone[{{x1,y1,z1},{x2,y2,z2}},r]a cone with a base radius of r
Cuboid[{x,y,z}]a unit cube with opposite corners having coordinates and
Cuboid[{xmin,ymin,zmin},{xmax,ymax,zmax}]a cuboid (rectangular parallelepiped) with opposite corners having the specified coordinates
Cylinder[{{x1,y1,z1},{x2,y2,z2}}]a cylinder of radius 1 with endpoints at and
Cylinder[{{x1,y1,z1},{x2,y2,z2}},r]a cylinder of radius r
Sphere[{x,y,z}]a unit sphere centered at
Sphere[{x,y,z},r]a sphere of radius r
Tube[{{x1,y1,z1},{x2,y2,z2},...}]a tube connecting the specified points
Tube[{{x1,y1,z1},{x2,y2,z2},...},r]a tube of radius r

Cuboid graphics elements.

This draws a number of random unit cubes and spheres in three-dimensional space.
Click for copyable input

Even though Cone, Cylinder, Sphere, and Tube produce high-quality renderings, their usage is scalable. A single image can contain thousands of these primitives. When rendering so many primitives, you can increase the efficiency of rendering by using special options to change the number of points used by default to render Cone, Cylinder, Sphere, and Tube. The Method option to Graphics3D is used to reduce the rendering quality of each individual cone. Cylinder, sphere, and tube quality can be similarly adjusted using , , and , respectively.

Because the cylinders are so small, the number of points used to render them can be reduced with almost no perceptible change.
Click for copyable input
New to Mathematica? Find your learning path »
Have a question? Ask support »