diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex | 186 |
1 files changed, 98 insertions, 88 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex index d34656b688f..78b72d5ab8c 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main-body.tex @@ -183,7 +183,7 @@ { \vbox{} \vskip0pt plus 1fill - F\"ur meinen Vater, damit er noch viele sch\"one \TeX-Graphiken + Für meinen Vater, damit er noch viele schöne \TeX-Graphiken erschaffen kann. \vskip1em \hfill\emph{Till} @@ -193,26 +193,25 @@ Copyright 2007 to 2013 by Till Tantau \medskip - Permission is granted to copy, distribute and/or modify \emph{the documentation} - under the terms of the \textsc{gnu} Free Documentation License, Version 1.2 - or any later version published by the Free Software Foundation; - with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. - A copy of the license is included in the section entitled \textsc{gnu} - Free Documentation License. + Permission is granted to copy, distribute and/or modify \emph{the + documentation} under the terms of the \textsc{gnu} Free Documentation + License, Version 1.2 or any later version published by the Free Software + Foundation; with no Invariant Sections, no Front-Cover Texts, and no + Back-Cover Texts. A copy of the license is included in the section entitled + \textsc{gnu} Free Documentation License. \medskip - Permission is granted to copy, distribute and/or modify \emph{the - code of the package} under the terms of the \textsc{gnu} Public License, Version 2 - or any later version published by the Free Software Foundation. - A copy of the license is included in the section entitled \textsc{gnu} - Public License. + Permission is granted to copy, distribute and/or modify \emph{the code of the + package} under the terms of the \textsc{gnu} Public License, Version 2 or any + later version published by the Free Software Foundation. A copy of the + license is included in the section entitled \textsc{gnu} Public License. \medskip - Permission is also granted to distribute and/or modify \emph{both - the documentation and the code} under the conditions of the LaTeX - Project Public License, either version 1.3 of this license or (at - your option) any later version. A copy of the license is included in - the section entitled \LaTeX\ Project Public License. + Permission is also granted to distribute and/or modify \emph{both the + documentation and the code} under the conditions of the LaTeX Project Public + License, either version 1.3 of this license or (at your option) any later + version. A copy of the license is included in the section entitled \LaTeX\ + Project Public License. \vbox{} \clearpage @@ -221,14 +220,15 @@ \title{\bfseries The \tikzname\ and {\Large PGF} Packages\\ \large Manual for version \pgfversion\\[1mm] -\large\href{http://sourceforge.net/projects/pgf}{\texttt{http://sourceforge.net/projects/pgf}}} +\large\href{https://sourceforge.net/projects/pgf}{\texttt{https://sourceforge.net/projects/pgf}}} \author{Till Tantau\footnote{Editor of this documentation. Parts of this documentation have been written by other authors as indicated in these parts or chapters and in Section~\ref{section-authors}.}\\ - \normalsize Institut f\"ur Theoretische Informatik\\[-1mm] - \normalsize Universit\"at zu L\"ubeck} + \normalsize Institut für Theoretische Informatik\\[-1mm] + \normalsize Universität zu Lübeck} \maketitle +\label{table-of-contents} \tableofcontents @@ -238,18 +238,17 @@ \include{pgfmanual-en-introduction} + \part{Tutorials and Guidelines} {\Large \emph{by Till Tantau}} \bigskip -\noindent -To help you get started with \tikzname, instead of a long installation -and configuration section, this manual starts with tutorials. They -explain all the basic and some of the more advanced features of the -system, without going into all the details. This part also contains -some guidelines on how you should proceed when creating graphics using -\tikzname. +\noindent To help you get started with \tikzname, instead of a long +installation and configuration section, this manual starts with tutorials. They +explain all the basic and some of the more advanced features of the system, +without going into all the details. This part also contains some guidelines on +how you should proceed when creating graphics using \tikzname. \vskip3cm @@ -258,6 +257,7 @@ some guidelines on how you should proceed when creating graphics using (0,0) -- (0,2) -- (1,3.25) -- (2,2) -- (2,0) -- (0,2) -- (2,2) -- (0,0) -- (2,0); \end{codeexample} + \include{pgfmanual-en-tutorial} \include{pgfmanual-en-tutorial-nodes} \include{pgfmanual-en-tutorial-Euclid} @@ -273,11 +273,10 @@ some guidelines on how you should proceed when creating graphics using \bigskip -\noindent -This part explains how the system is installed. Typically, someone has -already done so for your system, so this part can be skipped; but if -this is not the case and you are the poor fellow who has to do the -installation, read the present part. +\noindent This part explains how the system is installed. Typically, someone +has already done so for your system, so this part can be skipped; but if this +is not the case and you are the poor fellow who has to do the installation, +read the present part. \vskip1cm @@ -313,11 +312,13 @@ installation, read the present part. \end{tikzpicture} \end{codeexample} + \include{pgfmanual-en-installation} \include{pgfmanual-en-license} \include{pgfmanual-en-drivers} + \part{Ti\emph{k}Z ist \emph{kein} Zeichenprogramm} \label{part-tikz} @@ -331,24 +332,24 @@ installation, read the present part. \begin{tikzpicture}[angle radius=.75cm] - \node (A) at (-2,0) [red,left] {$A$}; + \node (A) at (-2,0) [red,left] {$A$}; \node (B) at ( 3,.5) [red,right] {$B$}; - \node (C) at (-2,2) [blue,left] {$C$}; - \node (D) at ( 3,2.5) [blue,right] {$D$}; - \node (E) at (60:-5mm) [below] {$E$}; - \node (F) at (60:3.5cm) [above] {$F$}; + \node (C) at (-2,2) [blue,left] {$C$}; + \node (D) at ( 3,2.5) [blue,right] {$D$}; + \node (E) at (60:-5mm) [below] {$E$}; + \node (F) at (60:3.5cm) [above] {$F$}; \coordinate (X) at (intersection cs:first line={(A)--(B)}, second line={(E)--(F)}); \coordinate (Y) at (intersection cs:first line={(C)--(D)}, second line={(E)--(F)}); - - \path + + \path (A) edge [red, thick] (B) (C) edge [blue, thick] (D) (E) edge [thick] (F) - pic ["$\alpha$", draw, fill=yellow] {angle = F--X--A} - pic ["$\beta$", draw, fill=green!30] {angle = B--X--F} - pic ["$\gamma$", draw, fill=yellow] {angle = E--Y--D} - pic ["$\delta$", draw, fill=green!30] {angle = C--Y--E}; + pic ["$\alpha$", draw, fill=yellow] {angle = F--X--A} + pic ["$\beta$", draw, fill=green!30] {angle = B--X--F} + pic ["$\gamma$", draw, fill=yellow] {angle = E--Y--D} + pic ["$\delta$", draw, fill=green!30] {angle = C--Y--E}; \node at ($ (D)!.5!(B) $) [right=1cm,text width=6cm,rounded corners,fill=red!20,inner sep=1ex] { @@ -360,7 +361,6 @@ installation, read the present part. \end{codeexample} - \include{pgfmanual-en-tikz-design} \include{pgfmanual-en-tikz-scopes} \include{pgfmanual-en-tikz-coordinates} @@ -376,6 +376,8 @@ installation, read the present part. \include{pgfmanual-en-tikz-transparency} \include{pgfmanual-en-tikz-decorations} \include{pgfmanual-en-tikz-transformations} +\include{pgfmanual-en-tikz-animations} + \part{Graph Drawing} @@ -385,11 +387,9 @@ installation, read the present part. \bigskip \noindent -\emph{Graph drawing algorithms} do the tough work of computing a -layout of a graph for you. \tikzname\ comes with powerful -such algorithms, but you can also implement new algorithms in the -Lua programming language. -\vskip1cm +\emph{Graph drawing algorithms} do the tough work of computing a layout of a +graph for you. \tikzname\ comes with powerful such algorithms, but you can also +implement new algorithms in the Lua programming language. \vskip1cm \ifluatex \begin{codeexample}[graphic=white] @@ -410,14 +410,15 @@ Lua programming language. "CB Unix 1" -> "CB Unix 2" -> "CB Unix 3" -> { "Unix/TS++", "PDP-11 Sys V" }; { "USG 2.0" -> "USG 3.0", "PWB 2.0", "Unix/TS 1.0" } -> "Unix/TS 3.0"; { "Unix/TS++", "CB Unix 3", "Unix/TS 3.0" } -> "TS 4.0" -> "System V.0" -> "System V.2" -> "System V.3"; - }; + }; \end{codeexample} \else -You need to use Lua\TeX\ to typeset this part of the manual (and, -also, to use algorithmic graph drawing). + You need to use Lua\TeX\ to typeset this part of the manual (and, also, to + use algorithmic graph drawing). \fi + \include{pgfmanual-en-gd-overview} \include{pgfmanual-en-gd-usage-tikz} \include{pgfmanual-en-gd-usage-pgf} @@ -428,7 +429,7 @@ also, to use algorithmic graph drawing). \include{pgfmanual-en-gd-phylogenetics} \include{pgfmanual-en-gd-edge-routing} % -% XXX : disabled because of +% XXX : disabled because of % 1. compile-time dependencies which are hard to resolve % 2. it is "hardly usable anyway" (TT) %\include{pgfmanual-en-gd-ogdf} @@ -436,7 +437,8 @@ also, to use algorithmic graph drawing). \include{pgfmanual-en-gd-algorithms-in-c} \include{pgfmanual-en-gd-display-layer} \include{pgfmanual-en-gd-binding-layer} - + + \part{Libraries} \label{part-libraries} @@ -446,11 +448,10 @@ also, to use algorithmic graph drawing). \bigskip \noindent -In this part the library packages are documented. They -provide additional predefined graphic objects like new arrow heads or -new plot marks, but sometimes also extensions of the basic \pgfname\ -or \tikzname\ system. The libraries are not loaded by default since -many users will not need them. +In this part the library packages are documented. They provide additional +predefined graphic objects like new arrow heads or new plot marks, but +sometimes also extensions of the basic \pgfname\ or \tikzname\ system. The +libraries are not loaded by default since many users will not need them. \medskip \noindent @@ -511,6 +512,8 @@ many users will not need them. \end{minipage} \end{codeexample} + +\include{pgfmanual-en-library-3d} \include{pgfmanual-en-library-angles} \include{pgfmanual-en-library-arrows} \include{pgfmanual-en-library-automata} @@ -537,6 +540,7 @@ many users will not need them. \include{pgfmanual-en-library-plot-handlers} \include{pgfmanual-en-library-plot-marks} \include{pgfmanual-en-library-profiler} +\include{pgfmanual-en-library-rdf} \include{pgfmanual-en-library-shadings} \include{pgfmanual-en-library-shadows} \include{pgfmanual-en-library-shapes} @@ -546,6 +550,8 @@ many users will not need them. \include{pgfmanual-en-library-through} \include{pgfmanual-en-library-trees} \include{pgfmanual-en-library-turtle} +\include{pgfmanual-en-library-views} + \part{Data Visualization} @@ -582,6 +588,7 @@ data [format=function] { }; \end{codeexample} + \include{pgfmanual-en-dv-introduction} \include{pgfmanual-en-dv-main} \include{pgfmanual-en-dv-formats} @@ -592,6 +599,7 @@ data [format=function] { \include{pgfmanual-en-dv-backend} + \part{Utilities} \label{part-utilities} @@ -600,10 +608,10 @@ data [format=function] { \bigskip \noindent -The utility packages are not directly involved in creating graphics, -but you may find them useful nonetheless. All of them either directly -depend on \pgfname\ or they are designed to work well together with -\pgfname\ even though they can be used in a stand-alone way. +The utility packages are not directly involved in creating graphics, but you +may find them useful nonetheless. All of them either directly depend on +\pgfname\ or they are designed to work well together with \pgfname\ even though +they can be used in a stand-alone way. \vskip2cm \medskip @@ -629,6 +637,7 @@ depend on \pgfname\ or they are designed to work well together with \end{tikzpicture} \end{codeexample} + \include{pgfmanual-en-pgfkeys} \include{pgfmanual-en-pgffor} \include{pgfmanual-en-pgfcalendar} @@ -637,6 +646,7 @@ depend on \pgfname\ or they are designed to work well together with \include{pgfmanual-en-module-parser} + \part{Mathematical and Object-Oriented Engines} {\Large \emph{by Mark Wibrow and Till Tantau}} @@ -644,24 +654,21 @@ depend on \pgfname\ or they are designed to work well together with \bigskip \noindent -\pgfname\ comes with two useful engines: One for doing mathematics, -one for doing object-oriented programming. Both engines can be used -independently of the main \pgfname. - -The job of the mathematical -engine is to support mathematical operations like addition, -subtraction, multiplication and division, using both integers and -non-integers, but also functions such as square-roots, sine, cosine, -and generate pseudo-random numbers. -Mostly, you will use the mathematical facilities of \pgfname\ -indirectly, namely when you write a coordinate like |(5cm*3,6cm/4)|, -but the mathematical engine can also be used independently of +\pgfname\ comes with two useful engines: One for doing mathematics, one for +doing object-oriented programming. Both engines can be used independently of +the main \pgfname. + +The job of the mathematical engine is to support mathematical operations like +addition, subtraction, multiplication and division, using both integers and +non-integers, but also functions such as square-roots, sine, cosine, and +generate pseudo-random numbers. Mostly, you will use the mathematical +facilities of \pgfname\ indirectly, namely when you write a coordinate like +|(5cm*3,6cm/4)|, but the mathematical engine can also be used independently of \pgfname\ and \tikzname. -The job of the object-oriented engine is to support simple -object-oriented programming in \TeX. It allows the definition of -\emph{classes} (without inheritance), \emph{methods}, -\emph{attributes} and \emph{objects}. +The job of the object-oriented engine is to support simple object-oriented +programming in \TeX. It allows the definition of \emph{classes} (without +inheritance), \emph{methods}, \emph{attributes} and \emph{objects}. \vskip1cm \begin{codeexample}[graphic=white] @@ -686,6 +693,7 @@ object-oriented programming in \TeX. It allows the definition of } \end{codeexample} + \include{pgfmanual-en-math-design} \include{pgfmanual-en-math-parsing} \include{pgfmanual-en-math-commands} @@ -694,6 +702,7 @@ object-oriented programming in \TeX. It allows the definition of \include{pgfmanual-en-oo} + \part{The Basic Layer} {\Large \emph{by Till Tantau}} @@ -747,12 +756,12 @@ object-oriented programming in \TeX. It allows the definition of \include{pgfmanual-en-base-layers} \include{pgfmanual-en-base-shadings} \include{pgfmanual-en-base-transparency} +\include{pgfmanual-en-base-animations} \include{pgfmanual-en-base-internalregisters} \include{pgfmanual-en-base-quick} - \part{The System Layer} \label{part-system} @@ -762,15 +771,15 @@ object-oriented programming in \TeX. It allows the definition of \bigskip \noindent This part describes the low-level interface of \pgfname, called the -\emph{system layer}. This interface provides a complete abstraction of -the internals of the underlying drivers. +\emph{system layer}. This interface provides a complete abstraction of the +internals of the underlying drivers. -Unless you intend to port \pgfname\ to another driver or unless you intend -to write your own optimized frontend, you need not read this part. +Unless you intend to port \pgfname\ to another driver or unless you intend to +write your own optimized frontend, you need not read this part. -In the following it is assumed that you are familiar with the basic -workings of the |graphics| package and that you know what -\TeX-drivers are and how they work. +In the following it is assumed that you are familiar with the basic workings of +the |graphics| package and that you know what \TeX-drivers are and how they +work. \vskip1cm \begin{codeexample}[graphic=white] @@ -798,10 +807,12 @@ workings of the |graphics| package and that you know what \end{tikzpicture} \end{codeexample} + \include{pgfmanual-en-pgfsys-overview} \include{pgfmanual-en-pgfsys-commands} \include{pgfmanual-en-pgfsys-paths} \include{pgfmanual-en-pgfsys-protocol} +\include{pgfmanual-en-pgfsys-animations} @@ -835,7 +846,6 @@ workings of the |graphics| package and that you know what \end{document} - %%% Local Variables: %%% mode: latex %%% TeX-master: "~/pgf/doc/generic/pgf/version-for-luatex/en/pgfmanual" |