plotOptions3d
-- scene
options for 3D plotsThis page describes the scene options that may be used when
generating 3D graphics via plot3d
, plotfunc3d
, plot::Scene
, or plot
. Scene options are attributes that
determine the general appearance of a graphical scene such as camera
point, background color, title, axes style etc.
plot3d( <SceneOpt1, SceneOpt2, ...>, graphical
objects)
plotfunc3d( <SceneOpt1, SceneOpt2, ...>, graphical
objects)
plot::Scene(graphical objects, <SceneOpt1, SceneOpt2,
...>)
plot(graphical objects, <SceneOpt1, SceneOpt2,
...>)
graphical objects |
- | see the help pages of plot3d , plotfunc3d , plot::Scene , and plot for details |
SceneOpt1, SceneOpt2, .. |
- | scene options: each is an equation of the form
OptionName = value . |
OptionName |
admissible values | default value |
Arrows | TRUE , FALSE |
FALSE |
Axes | Box, Corner, None, Origin | Box |
AxesOrigin | Automatic, [x0, y0,
z0] |
Automatic |
AxesScaling | [Lin/Log, Lin/Log, Lin/Log] | [Lin, Lin, Lin] |
BackGround | [r, g, b] |
RGB::White |
CameraPoint | Automatic, [x, y,
z] |
Automatic |
FocalPoint | Automatic, [x, y,
z] |
Automatic |
FontFamily | "helvetica" , "lucida" ,
.. |
"helvetica" |
FontSize | positive integers | 8 |
FontStyle | "bold" , .. |
"bold" |
ForeGround | [r, g, b] |
RBG::Black |
Labeling | TRUE , FALSE |
TRUE |
Labels | [string, string, string] |
["x","y","z"] |
LineStyle | SolidLines, DashedLines | SolidLines |
LineWidth | positive integers | 1 |
PlotDevice | Screen, "filename" ,
["filename",Ascii] ,
["filename",Binary] |
Screen |
PointStyle | Circles, FilledCircles, FilledSquares, Squares | FilledSquares |
PointWidth | positive integers | 30 |
Scaling | Constrained, UnConstrained | UnConstrained |
Ticks | Automatic, None, an integer or [xValue, yValue, zValue] .
Admissible values for xValue , yValue ,
zValue are Automatic, an integer, Steps = d , Steps
= [d, n] , or a list of user defined ticks. |
Automatic |
Title | strings | "" (plot3d ) |
"f(x, y)" |
||
"" (plotfunc3d ) |
||
"" (plot::Scene ) |
||
"" (plot ) |
||
TitlePosition | Above, Below, [x, y] |
Above |
ViewingBox | Automatic | Automatic |
plot
, plot::Scene
, plot
, plot2d
, plotfunc2d
, plotOptions2d
, plot3d
, plotfunc3d
value
TRUE
or
FALSE
; the default is Arrows =
FALSE
. This option is ignored if Axes = None or Axes = Box.value
value
[x0,
y0, z0]
; the default is AxesOrigin = Automatic.
[x0, y0, z0]
,
the coordinate axes cross at the specified point. Admissible values for
the coordinates are real numerical
expressions as well as the identifiers XMin,
XMax, YMin, YMax, ZMin, ZMax. These are the extremal coordinates of the scene
which are determined internally when the plot is evaluated.[xScale, yScale, zScale]
xScale
, yScale
, and zScale
are either Lin for a linear scale or Log for a logarithmic scale. The default is AxesScaling = [Lin,Lin,Lin]
.[r, g, b]
r
, g
, b
must
be real numbers between 0
and 1
. They
represent the red, green, and blue contributions according to the RGB
color model. Pre-defined colors are provided by MuPAD's RGB
data structure. The default is
BackGround = [1, 1, 1]
=
RGB::White
.value
[x, y,
z]
. With the default Automatic, the camera
position is chosen automatically outside the graphical scene. Also a
user-defined point should lie outside the scene. A point close to the
scene leads to perspective distortion. A point far from the scene
prevents such distortion (parallel projection). The size of the
projected scene is independent of the distance: the projection is
enlarged automatically such that it fills the canvas.value
[x, y,
z]
. With the default Automatic, the focal
point is chosen automatically as the center of the graphical
scene.FontFamilyString
FontFamilyString
may be one of
"helvetica"
, "lucida"
etc. The default is FontFamily = "helvetica"
.n
n
may have values
between 7 and 36. The default is FontSize = 8.FontStyleString
FontStyleString
may be
one of "bold"
, ... . The default is FontStyle = "bold"
.[r, g, b]
r
, g
, b
must
be real numbers between 0
and 1
. They
represent the red, green, and blue contributions according to the RGB
color model. Pre-defined colors are provided by MuPAD's RGB
data structure. The default is
ForeGround = [0, 0, 0]
=
RGB::Black
.value
TRUE
or
FALSE
; the default is Labeling =
TRUE
.[xString, yString,
zString]
xString
, yString
, and
zString
. The default is Labels =
["x", "y", "z"]
.value
[Mode
= Curve, ..]
, the parameter lines of surfaces, and polygons generated via [Mode = List,
[..polygons..]]
. You can use the option LineStyle in the graphical objects to override this scene
option and display each line object in its individual line style.n
n
are nonnegative integers; the
default is LineWidth = 1.[Mode
= Curve, ..]
, and polygons generated
via [Mode = List, [..polygons..]]
. You can use the option
LineWidth in the graphical objects to override
this scene option and display each line object in its individual line
style.value
"filename"
,
["filename", Ascii]
or
["filename", Binary]
. The default is
PlotDevice = Screen.
["filename",
format]
, the plot is written to the file named
filename
in the specified graphical formats. Available
formats are Ascii and Binary. These are mupad specific formats understood by
MuPAD's graphical tool VCam. A file in such a format can later
be opened and rendered by VCam."filename"
is the
same as PlotDevice = ["filename", Binary]
.value
point
. They can
be displayed via plot3d
using objects of the type [Mode = List, [..points..]]
. You
can use the object option PointStyle to override
this scene option and display each point with its individual
style.n
n
are positive integers; the
default is PointWidth = 30.point
. They can
be displayed via plot3d
using objects of the type [Mode = List, [..points..]]
. You
can use the object option PointWidth to override
this scene option and display each point with its individual
width.value
value
[xValue, yValue, zValue]
. The default is
Ticks = Automatic.
n
, the minimum
value for the ticks on the three axes is specified by the nonnegative
integer n
. Note that more ticks than specified may be
drawn in order to place them at reasonable positions.[xValue, yValue,
zValue]
, the ticks can be specified separately for each
axis.xValue
, yValue
, and
zValue
may be Automatic, a
nonnegative integer, Steps = d
, Steps = [d, n]
, or a list of
user-defined ticks.
[Automatic, Automatic, Automatic]
.n
is equivalent to
Ticks = [n, n, n]
.d
produces ticks at the
positions j*d with all integer values j leading
to ticks inside the viewing range of the plot. The distance
d
between two ticks must be a real positive value.[d, n]
produces the same
``large'' ticks as Steps = d
.
Between such ticks further n
smaller ticks are positioned.
The parameter n
must be a nonnegative integer. The
``large'' ticks carry labels if Labeling =
TRUE
. The ``small'' ticks do not carry labels.[t1, t2,
..]
. Admissible values for t1
, t2
etc.
are real numerical expressions defining the
positions of the ticks. Alternatively, any element of the list may be
an equation of the form t = label
, where t
is
a numerical value and label
is a string. This produces a
tick at the position t
with the string as label. The label
is diplayed if Labeling = TRUE
is
specified. E.g.,
Ticks = [[0.2, PI = "PI"], [sqrt(2), 2,
3], [1, 2, 3]]
produces two ticks on the x-axis at the positions x
= 0.2 and x = PI. The second tick carries the label
"PI"
. On the y- and z-axes, three
ticks without lables are produced.
If ticks outside the viewing range of the plot are specified, then the viewing range is extended automatically such that all ticks are visible.
TitleString
TitleString
to the scene. In plot3d
, plot::Scene
, and plot
, the default is the empty string
Title = , i.e., no title. In plotfunc3d
, the expressions
defining the functions to be plotted are converted to title
strings.value
[x, y]
; the default is TitlePosition
= Above.
[x, y]
, the
title may be placed at any position in the scene. The parameters
x, y
must be real numerical values between 0
and 10
. The position [0, 0]
denotes the upper
left corner of the scene, the position [10, 10]
denotes
the lower right corner.value