Graphics3D

Usage

• Graphics3D[primitives, options] represents a three-dimensional graphical image.

Notes

• Graphics3D is displayed using Show.

• The following graphics primitives can be used:

Cuboid[{, , }, ... ]	cuboid
Line[{{, , }, ... }]	line
Point[{x, y, z}]	point
Polygon[{{, , }, ... }]	polygon
Text[expr, {x, y, z}]	text

• The sound primitives SampledSoundList and SampledSoundFunction can also be included.

• The following graphics directives can be used:

AbsoluteDashing[{, ... }]	absolute line dashing specification
AbsolutePointSize[d]	absolute point size specification
AbsoluteThickness[w]	absolute line thickness specification
CMYKColor[c, m, y, k]	color specification
Dashing[{, ... }]	line dashing specification
EdgeForm[spec]	polygon edge specification
FaceForm[spec]	polygon face specification
GrayLevel[i]	gray-level specification
Hue[h]	hue specification
PointSize[d]	point size specification
RGBColor[r, g, b]	color specification
SurfaceColor[spec]	surface properties specification
Thickness[w]	line thickness specification

• The following options can be given:

AmbientLight	GrayLevel[0]	ambient illumination level
AspectRatio	Automatic	ratio of height to width
Axes	False	whether to draw axes
AxesEdge	Automatic	on which edges to put axes
AxesLabel	None	axes labels
AxesStyle	Automatic	graphics directives to specify the style for axes
Background	Automatic	background color for the plot
Boxed	True	whether to draw the bounding box
BoxRatios	Automatic	bounding 3D box ratios
BoxStyle	Automatic	graphics directives to specify the style for the box
ColorOutput	Automatic	type of color output to produce
DefaultColor	Automatic	default color for plot elements
DisplayFunction	$DisplayFunction	function for generating output
Epilog	{}	2D graphics primitives to be rendered after the main plot
FaceGrids	None	grid lines to draw on the bounding box
FormatType	$FormatType	default format type for text
ImageSize	Automatic	absolute size at which to render the graphic in a notebook
Lighting	True	whether to use simulated illumination
LightSources	(see below)	positions and colors of light sources
PlotLabel	None	a label for the plot
PlotRange	Automatic	range of values to include
PlotRegion	Automatic	final display region to be filled

PolygonIntersections	True	whether to leave intersecting polygons unchanged
Prolog	{}	2D graphics primitives to be rendered before the main plot
RenderAll	True	whether to render all polygons
Shading	True	whether to shade polygons
SphericalRegion	False	whether to make the circumscribing sphere fit in final display area
TextStyle	$TextStyle	default style for text
Ticks	Automatic	tick marks
ViewCenter	Automatic	point to put at the center of final display area
ViewPoint	{1.3, -2.4, 2.}	viewing position
ViewVertical	{0, 0, 1}	direction to make vertical

• Nested lists of graphics primitives can be given. Specifications such as GrayLevel remain in effect only until the end of the list which contains them.

• The standard print form for Graphics3D[ ... ] is -Graphics3D-. InputForm prints the explicit list of primitives.

• The default light sources used are {{{1,0,1}, RGBColor[1,0,0]}, {{1,1,1}, RGBColor[0,1,0]}, {{0,1,1}, RGBColor[0,0,1]}}.

• Graphics3D[SurfaceGraphics[ ... ]] can be used to convert a SurfaceGraphics object into Graphics3D representation.

• Graphics[SurfaceGraphics[ ... ]] generates a representation in terms of ordinary 2D graphics primitives.

• See Section 2.10.1.

• See also: Plot3D, SurfaceGraphics, ParametricPlot3D.

• Related packages: Graphics`Graphics3D`, Graphics`Shapes`, Graphics`Polyhedra`.

• New in Version 1.

Further Examples