summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex58
1 files changed, 58 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex
new file mode 100644
index 00000000000..cafe102caad
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-svg-path.tex
@@ -0,0 +1,58 @@
+% Copyright 2009 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{SVG-Path Library}
+\label{section-library-svg-path}
+
+\begin{pgflibrary}{svg.path}
+ This library defines a command that allows you to specify a path
+ using the svg-syntax.
+\end{pgflibrary}
+
+\begin{command}{\pgfpathsvg\marg{path}}
+ This command extends the current path by a \meta{path} given in the
+ \textsc{svg}-path-data syntax. This syntax is described in detail in
+ Section~8.3 of the \textsc{svg}-specification, Version 1.1.
+
+ In principle, the complete syntax is supported and the library just
+ provides a parser and a mapping to basic layer commands. For
+ instance, |M 0 10| is mapped to
+ |\pgfpathmoveto{\pgfpoint{0pt}{10pt}}|. There, however, a few things
+ to be aware of:
+ \begin{itemize}
+ \item The computation underlying the arc commands |A| and |a|
+ are not numerically stable, which may result in quite imprecise
+ arcs. B\'ezier curves, both quadratic and cubic, are not affected,
+ and also not arcs spanning degrees that are multiples of
+ $90^\circ$.
+ \item The dimensionless units of \textsc{svg} are always interpreted
+ at points (|pt|). This is a problem with paths like |M 20000 0|,
+ which will raise an error message since \TeX\ cannot handle
+ dimensions larger than about 16000 points.
+ \item
+ All coordinate and canvas transformations apply to the path in the
+ usual fashion.
+ \item
+ The |\pgfpathsvg| command can be freely intermixed with other path
+ commands.
+ \end{itemize}
+\begin{codeexample}[]
+\begin{pgfpicture}
+ \pgfpathsvg{M 0 0 l 20 0 0 20 -20 0 q 10 0 10 10
+ t 10 10 10 10 h -50 z}
+ \pgfusepath{stroke}
+\end{pgfpicture}
+\end{codeexample}
+\end{command}
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "pgfmanual-pdftex-version"
+%%% End: