summaryrefslogtreecommitdiff
path: root/graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex')
-rw-r--r--graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex116
1 files changed, 116 insertions, 0 deletions
diff --git a/graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex b/graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex
new file mode 100644
index 0000000000..d6d8f7cb28
--- /dev/null
+++ b/graphics/pgf/base/doc/pgfmanual-en-library-plot-marks.tex
@@ -0,0 +1,116 @@
+% Copyright 2018 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+% See the file doc/generic/pgf/licenses/LICENSE for more details.
+
+
+\section{Plot Mark Library}
+
+\begin{pgflibrary}{plotmarks}
+ This library defines a number of plot marks.
+\end{pgflibrary}
+
+This library defines the following plot marks in addition to |*|, |x|, and |+|
+(the filling color has been set to a dark yellow):
+
+{
+\catcode`\|=12
+\medskip
+\begin{tabular}{lc}
+ \plotmarkentry{-}
+ \index{*vbar@\protect\texttt{\protect\myvbar} plot mark}%
+ \index{Plot marks!*vbar@\protect\texttt{\protect\myvbar}}
+ %
+ \texttt{\char`\\pgfuseplotmark\char`\{\declare{|}\char`\}} &
+ \tikz\draw [color=black!25] plot [
+ mark=|,mark options={fill=yellow,draw=black}
+ ] coordinates {(0,0) (.5,0.2) (1,0) (1.5,0.2)};\\
+ \plotmarkentry{o}
+ \plotmarkentry{asterisk}
+ \plotmarkentry{star}
+ \plotmarkentry{10-pointed star}
+ \plotmarkentry{oplus}
+ \plotmarkentry{oplus*}
+ \plotmarkentry{otimes}
+ \plotmarkentry{otimes*}
+ \plotmarkentry{square}
+ \plotmarkentry{square*}
+ \plotmarkentry{triangle}
+ \plotmarkentry{triangle*}
+ \plotmarkentry{diamond}
+ \plotmarkentry{diamond*}
+ \plotmarkentry{halfdiamond*}
+ \plotmarkentry{halfsquare*}
+ \plotmarkentry{halfsquare right*}
+ \plotmarkentry{halfsquare left*}
+ \plotmarkentry{pentagon}
+ \plotmarkentry{pentagon*}
+ \plotmarkentry{Mercedes star}
+ \plotmarkentry{Mercedes star flipped}
+ \plotmarkentry{halfcircle}
+ \plotmarkentry{halfcircle*}
+ \plotmarkentry{heart}
+ \plotmarkentry{text}
+\end{tabular}
+}
+
+Note that each of the provided marks can be rotated freely by means of
+|mark options={rotate=90}| or |every mark/.append style={rotate=90}|.
+
+\begin{key}{/pgf/mark color=\marg{color} (initially empty)}
+ Defines the additional fill color for the |halfcircle|, |halfcircle*|,
+ |halfdiamond*| and |halfsquare*| markers. An empty value uses |white|
+ (which is the initial configuration). The special value |none| disables
+ filling of the respective parts.
+
+ Note that |halfsquare| will be filled with |mark color|, and the starred
+ variant |halfsquare*| will be filled half with |mark color| and half with
+ the actual |fill| color.
+\end{key}
+
+
+{
+\def\showit#1{%
+ \tikz\draw[color=black!25] plot[#1,mark options={fill=examplefill,draw=black}] coordinates{(0,0) (.5,0.2) (1,0) (1.5,0.2)};}%
+
+\begin{key}{/pgf/text mark=\marg{text} (initially p)}
+ Changes the text shown by |mark=text|.
+
+ With |/pgf/text mark=m|: \pgfkeys{/pgf/text mark=m}\showit{mark=text}
+
+ With |/pgf/text mark=A|: \pgfkeys{/pgf/text mark=A}\showit{mark=text}
+
+ There is no limitation about the number of characters or whatever. In fact,
+ any \TeX\ material can be inserted as \marg{text}, including images.
+\end{key}
+
+\begin{key}{/pgf/text mark as node=\marg{boolean} (initially false)}
+ Configures how |mark=text| will be drawn: either as |\node| or as |\pgftext|.
+
+ The first choice is highly flexible and possibly slow, the second is very
+ fast and usually enough.
+\end{key}
+
+\begin{key}{/pgf/text mark style=\marg{options for \texttt{mark=text}}}
+ Defines a set of options which control the appearance of |mark=text|.
+
+ If |/pgf/text mark as node=false| (the default), \marg{options} is provided
+ as argument to |\pgftext| -- which provides only some basic keys like
+ |left|, |right|, |top|, |bottom|, |base| and |rotate|.
+
+ If |/pgf/text mark as node=true|, \marg{options} is provided as argument to
+ |\node|. This means you can provide a very powerful set of options
+ including |anchor|, |scale|, |fill|, |draw|, |rounded corners| etc.
+\end{key}
+
+}
+
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "pgfmanual-pdftex-version"
+%%% End: