summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex29
1 files changed, 17 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex
index 99dfc3a5137..9290451c7f5 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex
@@ -5,15 +5,15 @@
\PGFPlots\ provides many styles to customize its appearance and behavior. They can be defined and changed in any place where keys are allowed. Furthermore, own styles are defined easily.
\begin{handler}{{.style}=\marg{key-value-list}}
- Defines or redefines a style \meta{key}. A style is a normal key which will set all options in \marg{key-value-list} when it is set.
+ Defines or redefines a style \meta{key}. A style is a normal key which will set all options in \meta{key-value-list} when it is set.
- Use |\pgfplotsset{|\meta{key}|/.style={|\meta{key-value-list}|}}| to (re-) define a style \meta{key} in the namespace |/pgfplots|.
+ Use |\pgfplotsset{|\meta{key}|/.style={|\meta{key-value-list}|}}| to (re)define a style \meta{key} in the namespace |/pgfplots|.
\end{handler}
\begin{handler}{{.append style}=\marg{key-value-list}}
- Appends \marg{key-value-list} to an already existing style \meta{key}. This is the preferred method to change the predefined styles: if you only append, you maintain compatibility with future versions.
+ Appends \meta{key-value-list} to an already existing style \meta{key}. This is the preferred method to change the predefined styles: if you only append, you maintain compatibility with future versions.
- Use |\pgfplotsset{|\meta{key}|/.append style={|\meta{key-value-list}|}}| to append \marg{key-value-list} to the style \meta{key}. This will assume the prefix |/pgfplots|.
+ Use |\pgfplotsset{|\meta{key}|/.append style={|\meta{key-value-list}|}}| to append \meta{key-value-list} to the style \meta{key}. This will assume the prefix |/pgfplots|.
\end{handler}
\subsubsection*{Styles installed for linear/logarithmic axis}
@@ -31,7 +31,7 @@
\end{stylekey}
\begin{stylekey}{/pgfplots/every loglog axis (initially empty)}
- Installed at the beginning of every double--logarithmic plot.
+ Installed at the beginning of every log--log plot.
\end{stylekey}
\begin{stylekey}{/pgfplots/every linear axis (initially empty)}
@@ -83,7 +83,8 @@
\pgfplotsshortstylekey label style=every axis label\pgfeov
\begin{xystylekey}{/pgfplots/every axis \x\ label}
- Used only~$x$ or only for~$y$ labels, installed after `|every axis label|'.
+Used only for $x$, $y$, or $z$ labels, respectively and installed after
+ `|every axis label|'.
The initial settings are set by |xlabel absolute| and its variants (if the initial configuration |compat=pre 1.3| is active) or |xlabel near ticks| which provides the better spacing as it incorporates the tick label sizes to compute the position.
@@ -158,11 +159,11 @@ which can be reset if needed.
inner axis line style=\marg{key-value-list},
outer axis line style=\marg{key-value-list},
\x\ axis line style=\marg{key-value-list}}
- These options modify selects parts of the axis line styles. They set |every inner x axis line| and |every outer x axis line| and the respective $y$ variants.
+ These options modify parts of the axis line styles. They append options to |every inner x axis line| and |every outer x axis line| and the respective $y$/$z$ variants.
\end{pgfplotsxykeylist}
\noindent
-Please refer to section~\ref{pgfplots:page:axislines} on page~\pageref{pgfplots:page:axislines} for details about styles for axis lines.
+Please refer to Section~\ref{pgfplots:page:axislines} on page~\pageref{pgfplots:page:axislines} for details about styles for axis lines.
\begin{stylekey}{/pgfplots/every 3d box foreground}
Installed for the parts drawn by |3d box=complete|. This affects axis lines, tick lines and grid lines drawn in the \emph{foreground}. The background drawing operations have already been done when this style is evaluated.
@@ -202,19 +203,23 @@ Please refer to section~\ref{pgfplots:page:axislines} on page~\pageref{pgfplots:
\pgfplotsshortxystylekeys tick label style,ticklabel style=every tick label\pgfeov
\begin{xystylekey}{/pgfplots/every \x\ tick label (initially empty)}
- Used for each $x$ (or $y$, respectively) tick label, installed after `|every tick label|'.
+ Used for each $x$ (or $y$ or $z$, respectively) tick label, installed after `|every tick label|'.
\end{xystylekey}
\pgfplotsshortxystylekeys \x\ tick label style,\x ticklabel style=every \x\ tick label\pgfeov
\begin{xystylekey}{/pgfplots/every \x\ tick scale label}
- Configures placement and display of the nodes containing the order of magnitude of tick labels, see section~\ref{sec:scaled:ticks} for more information about |scaled ticks|.
+ Configures placement and display of the nodes containing the order of magnitude of tick labels, see Section~\ref{sec:scaled:ticks} for more information about |scaled ticks|.
The initial settings are
\begin{codeexample}[code only]
\pgfplotsset{
every x tick scale label/.style={at={(1,0)},yshift=-2em,left,inner sep=0pt},
- every y tick scale label/.style={at={(0,1)},above right,inner sep=0pt,yshift=0.3em}}
+ every y tick scale label/.style={at={(0,1)},above right,inner sep=0pt,yshift=0.3em},
+ every z tick scale label/.style={
+ at={(zticklabel cs:1.2,-\pgfplotsvalueoflargesttickdimen z -0.3em)},
+ anchor=near zticklabel,inner sep=0pt},
+ }
\end{codeexample}
\end{xystylekey}
@@ -319,7 +324,7 @@ The initial setting is
\pgfplotsshortstylekey error bars/error bar style=every error bar\pgfeov
-\subsubsection{(Re-)Defining Own Styles}
+\subsubsection{(Re)Defining Own Styles}
\label{sec:styles:own}%
Use |\pgfplotsset{|\meta{style name}|/.style=|\marg{key-value-list}|}|
to create own styles. If \meta{style name} exists already, it will be replaced. Please note that it is \emph{not} possible to use the \Tikz-command |\tikzstyle|\marg{style name}|=[]| in this context\footnote{This was possible in a previous version and is still supported for backwards compatibility. But in some cases, it may not work as expected.}.