summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex29
1 files changed, 16 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex
index e11c922d100..5cac72c8414 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex
@@ -1,6 +1,8 @@
\subsection{3D Axis Configuration}
+{
+\tikzset{external/figure name/.add={}{threedimaxis_}}%
This section described keys which are used to configure the appearance of three dimensional figures. Some of them apply for two--dimensional plots as special case as well, and they will also be discussed in the respective sections of this manual.
\subsubsection{View Configuration}
@@ -43,7 +45,7 @@ This section described keys which are used to configure the appearance of three
The |view| is computed as follows. The view is defined by two rotations: the first rotation uses the \meta{azimuth} angle to rotate around the $z$ axis. Afterwards, the view is rotated \meta{elevation} degrees around the \emph{rotated} $x$ axis (more precisely, it is rotated $-$\meta{elevation} degrees). The resulting transformed $x$--$z$--plane is the viewport, i.e.\ the view direction is always the transformed positive $y$ axis.
- The |view| argument is assignment compatible with matlab (tm), i.e.\ you can use
+ The |view| argument is compatible with the argument of the Matlab (tm) view command, i.e.\ you can use
|[h,v] = view|
@@ -150,13 +152,13 @@ This section described keys which are used to configure the appearance of three
}
\end{codeexample}
- As the name suggests, |every 3d description| can only be used to set styles for axis labels, tick labels and titles. It has \emph{not} been designed to reset other styles, you will need to change these options either for each axis separately or by means of user defined styles. The reason for this limitation is: other options can (and, in many cases) need to be set before the axis is processed. However, the decision whether we have a two dimensional or a three dimensional axis has to be postponed until the processing is more or less complete -- so only some remaining keys can be set.
+ As the name suggests, |every 3d description| can only be used to set styles for axis labels, tick labels and titles. It has \emph{not} been designed to reset other styles, you will need to change these options either for each axis separately or by means of user defined styles. The reason for this limitation is: other options can (and, in many cases, needs to) be set before the axis is processed. However, the decision whether we have a two dimensional or a three dimensional axis has to be postponed until the processing is more or less complete -- so only some remaining keys can be set.
\end{stylekey}
\begin{stylekey}{/pgfplots/every 3d view \marg{h}\marg{v}}
- A style which can be used for fine tuning of the output for specific views.
+ A style which can be used for fine-tuning of the output for specific views.
- This style will be installed right after |every 3d description|, but before other axis description related keys are set (in other words: it has higher precedence than |every 3d description| but less precedence than keys provided to the axis directly).
+ This style will be installed right after |every 3d description|, but before other axis description related keys are set (in other words: it has higher precedence than |every 3d description|, but lower precedence than keys provided to the axis directly).
One example is preconfigured for |view={0}{90}| (from top):
\begin{codeexample}[code only]
@@ -173,17 +175,17 @@ This section described keys which are used to configure the appearance of three
\subsubsection{Appearance Of The 3D Box}
-\begin{pgfplotskey}{plot box ratio=\marg{x stretch}\marg{y stretch}\marg{z stretch} (initially {1}{1}{1})}
+\begin{pgfplotskey}{plot box ratio=\marg{\meta{x stretch} \meta{y stretch} \meta{z stretch}} (initially 1 1 1)}
Allows to customize the aspect ratio between the three different axes in a three dimensional plot.
- The |plot box ratio| is applied before any rotations and stretch--to--fill routines have been invoked. Thus, the initial setting |{1}{1}{1}| makes all axes equally long.
+ The |plot box ratio| is applied before any rotations and stretch--to--fill routines have been invoked. Thus, the initial setting\footnote{Note that you can also use the syntax \texttt{\{1\}\{1\}\{1\}} instead of space-separation.} |1 1 1| makes all axes equally long before the stretch--to--fill routine is applied.
\pgfplotsexpensiveexample
\begin{codeexample}[]
\begin{tikzpicture}
\begin{axis}[
view/h=60,
- plot box ratio={1}{1}{1},
+ plot box ratio=1 1 1,
colormap={violet}{[1cm] rgb255(0cm)=(25,25,122)
color(1cm)=(white) rgb255(5cm)=(238,140,238)},
xlabel=$x$,
@@ -204,7 +206,7 @@ This section described keys which are used to configure the appearance of three
\begin{tikzpicture}
\begin{axis}[
view/h=60,
- plot box ratio={1}{2}{1},
+ plot box ratio=1 2 1,
colormap={violet}{[1cm] rgb255(0cm)=(25,25,122)
color(1cm)=(white) rgb255(5cm)=(238,140,238)},
xlabel=$x$,
@@ -264,7 +266,7 @@ This section described keys which are used to configure the appearance of three
\end{tikzpicture}
\end{codeexample}
- Finally, the choice \declaretext{complete*} is the same as |complete|, but it also draws grid lines.
+ Finally, the choice \declaretext{complete*} is the same as |complete|, but it also draws grid lines in the foreground.
\begin{codeexample}[]
\begin{tikzpicture}
\begin{axis}[
@@ -300,7 +302,7 @@ This section described keys which are used to configure the appearance of three
\subsubsection{Axis Line Variants}
\label{sec:pgfplots:axislines:3d}
-Three dimensional axes also benefit from the |axis lines=box| or |axis lines=center| styles discussed in section~\ref{sec:pgfplots:axislines}. The choice |axis lines=box| is standard, it draws a box (probably affected by the |3d box=complete| key).
+Three dimensional axes also benefit from the |axis lines=box| or |axis lines=center| styles discussed in Section~\ref{sec:pgfplots:axislines}. The choice |axis lines=box| is standard, it draws a box (probably affected by the |3d box=complete| key).
The choice |axis lines=center| draws all three axes such that they pass through the origin. It might be necessary to combine this key with |axis on top| as there is no depth information.
\begin{codeexample}[]
@@ -317,9 +319,9 @@ The choice |axis lines=center| draws all three axes such that they pass through
\end{tikzpicture}
\end{codeexample}
-The remaining choices |axis lines*=left| and |axis lines*=right| select different sets of axes in a way such that tick labels and axis label won't disturb the plot's content. The `|*|' suppress the use of special styles which are mainly adequate for 2d axes, see the documentation of |axis lines|. Such a set of axes is always on the boundary of the two--dimensional projection.
+The remaining choices |axis lines*=left| and |axis lines*=right| select different sets of axes in a way such that tick labels and axis label won't disturb the plot's content. The `|*|' suppresses the use of special styles which are mainly adequate for two-dimensional axes, see the documentation of |axis lines|. Such a set of axes is always on the boundary of the two-dimensional projection.
-The choice |axis lines*=left| chooses a set of axes which are left (or bottom, respectively) whereas the choice |axis lines*=right| chooses a set of axes which are on the right (or top, respectively):
+The choice |axis lines*=left| chooses a set of axes which are on the left (or bottom, respectively) whereas the choice |axis lines*=right| chooses a set of axes which are on the right (or top, respectively):
\begin{codeexample}[]
\begin{tikzpicture}
@@ -345,5 +347,6 @@ The choice |axis lines*=left| chooses a set of axes which are left (or bottom, r
\end{tikzpicture}
\end{codeexample}
-It is not (yet) possible to mix different styles like |axis x line=center,axis z line=top|.
+It is not possible to mix different styles like |axis x line=center,axis z line=top|.
+}