Built-in Mathematica Symbol

Graphics3D

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

Graphics3D is displayed in StandardForm as a graphical image. In InputForm it is displayed as an explicit list of primitives.

The following graphics primitives can be used:

	Cuboid[{x_min,y_min,z_min},...]	cuboid
	Cylinder[{{x₁,x₂,x₃},...},...]	cylinder
	GraphicsComplex[pts,prims]	complex of graphics objects
	GraphicsGroup[{g₁,g₂,...}]	objects treated as a group
	Inset[obj,...]	inset object
	Line[{{x₁,y₁,z₁},...}]	line
	Point[{x,y,z}]	point
	Polygon[{{x₁,y₁,z₁},...}]	polygon
	Sphere[{x,y,z},...]	sphere
	Text[expr,{x,y,z}]	text

The following graphics directives can be used:

	AbsoluteDashing[{w₁,...}]	absolute line dashing specification
	AbsolutePointSize[d]	absolute point size specification
	AbsoluteThickness[w]	absolute line thickness specification
	CMYKColor[c,m,y,k]	color specification
	Dashing[{w₁,...}]	line dashing specification
	Directive[g₁,g₂,...]	composite graphics directive
	EdgeForm[spec]	polygon edge specification
	FaceForm[spec]	polygon face specification
	Glow[c]	glow color specification
	GrayLevel[i]	gray-level specification
	Hue[h]	hue specification
	Opacity[a]	opacity specification
	PointSize[d]	point size specification
	RGBColor[r,g,b]	color specification
	Specularity[s]	surface specularity specification
	Thickness[w]	line thickness specification

The following wrappers can be used at any level:

	Annotation[obj,label]	give an annotation
	Button[obj,action]	make obj act as a button
	Dynamic[obj]	use the dynamically updated current value
	EventHandler[obj,...]	attach an event handler
	Hyperlink[obj,URI]	make obj a hyperlink
	Mouseover[obj,over]	specify a mouseover form
	PopupWindow[obj,cont]	attach a popup window
	StatusArea[obj,label]	specify a label to appear in the status area
	Style[obj,opts]	specify a style
	Tooltip[obj,label]	attach a tooltip

The following options can be given:

AlignmentPoint	Center	the default point in the graphic to align with
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	{}	graphics directives to specify the style for axes
Background	None	background color for the plot
BaselinePosition	Automatic	how to align with a surrounding text baseline
BaseStyle	{}	base style specifications for the graphic
Boxed	True	whether to draw the bounding box
BoxRatios	Automatic	bounding 3D box ratios
BoxStyle	Automatic	style specifications for the box
ContentSelectable	Automatic	whether to allow contents to be selected
ControllerLinking	Automatic	when to link to external rotation controllers
ControllerMethod	Automatic	how external controllers should operate
ControllerPath	Automatic	what external controllers to try to use
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
FaceGridsStyle	{}	style specifications for face grids
FormatType	TraditionalForm	default format type for text
ImageMargins	0.	the margins to leave around the graphic
ImagePadding	All	what extra padding to allow for labels, etc.
ImageSize	Automatic	absolute size at which to render the graphic
LabelStyle	{}	style specifications for labels
Lighting	Automatic	simulated light sources to use
Method	Automatic	details of 3D graphics methods to use
PlotLabel	None	a label for the plot
PlotRange	All	range of values to include
PlotRangePadding	Automatic	how much to pad the range of values
PlotRegion	Automatic	final display region to be filled
PreserveImageOptions	Automatic	whether to preserve image options when displaying new versions of the same graphic
Prolog	{}	2D graphics primitives to be rendered before the main plot
RotationAction	"Fit"	how to render after interactive rotation
SphericalRegion	False	whether to make the circumscribing sphere fit in final display area
Ticks	Automatic	specification for ticks
TicksStyle	{}	style specification for ticks
ViewAngle	All	angle of the field of view
ViewCenter	{1/2,1/2,1/2}	point to display at the center
ViewMatrix	Automatic	explicit transformation matrix
ViewPoint	{1.3,-2.4,2.}	viewing position
ViewRange	All	range of viewing distances to include
ViewVector	Automatic	position and direction of a simulated camera
ViewVertical	{0,0,1}	direction to make vertical

Nested lists of graphics constructs can be given. Directive specifications such as GrayLevel normally remain in effect only until the end of the list which contains them.

A list containing only graphics directives is treated as if its elements were directly inserted into an enclosing list.

Style[obj, opts] can be used to apply the options or directives opts to obj.

In a notebook front end, ViewPoint, ViewVertical, ViewCenter and ViewAngle can be changed by direct interactive manipulation.

Dragging with the mouse rotates a 3D graphic.

Directives such as RGBColor specify surface colors for objects that follow. Final colors are determined from simulated illumination, including Glow and Specularity components.

By default, four light sources of different colors are used, arranged at particular fixed locations outside the bounding box.

By default, ViewAngle is set so that if possible the projection of the whole 3D object just fills the 2D viewing area.

The settings for BaseStyle are appended to the default style typically given by the "Graphics3D" style in the current stylesheet. The settings for BoxStyle, LabelStyle, etc. are appended to the default styles given for "Graphics3DBox", "Graphics3DLabel", etc.