summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex127
1 files changed, 113 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
index e0e49b657d9..4850378c8e8 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
@@ -15,11 +15,12 @@
\def\xkeyvalversion{1.8}
\usepackage[version=0.96]{pgf}
+
\usepackage{tikz}
-\usetikzlibrary{arrows,patterns,plotmarks,shapes,snakes,er,3d,automata,backgrounds,topaths,trees,petri,mindmap}
+\usetikzlibrary{arrows,patterns,plotmarks,shapes,snakes,er,3d,automata,backgrounds,topaths,trees,petri,mindmap,matrix,calendar,folding}
-\usepackage[left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
+\usepackage[a4paper,left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
\usepackage{amsmath,amssymb}
\usepackage{xxcolor}
\usepackage{pifont}
@@ -36,7 +37,7 @@
\renewcommand*\l@subsubsection{\@dottedtocline{3}{4.3em}{3.2em}}
\makeatother
-%\includeonly{pgfmanual-en-tutorial-nodes}
+%\includeonly{}
% Global styles:
\tikzstyle{every plot}=[prefix=plots/pgf-]
@@ -50,7 +51,7 @@
\begin{document}
-%\include{pgfmanual-en-license}
+%\include{pgfmanual-en-base-external}
%\end{document}
{
@@ -88,11 +89,14 @@ Manual for version \pgfversion
{
\vbox{}
\vskip0pt plus 1fill
- Für meinen Vater, damit er noch viele schöne \TeX-Graphiken erschaffen kann.
+ Für meinen Vater, damit er noch viele schöne \TeX-Graphiken
+ erschaffen kann.
+ \vskip1em
+ \hfill\emph{Till}
\vskip0pt plus 3fill
\parindent=0pt
- Copyright 2006 by Till Tantau
+ Copyright 2007 by Till Tantau
\medskip
Permission is granted to copy, distribute and/or modify \emph{the documentation}
@@ -124,7 +128,9 @@ Manual for version \pgfversion
\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}}}
-\author{Till Tantau\\
+\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}
@@ -140,6 +146,10 @@ Manual for version \pgfversion
\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
@@ -162,6 +172,11 @@ some guidelines on how you should proceed when creating graphics using
\part{Installation and Configuration}
+{\Large \emph{by Till Tantau}}
+
+
+\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
@@ -189,6 +204,15 @@ installation, read the present part.
(D) edge [loop below] node {1,1,R} (D)
edge node {0,1,R} (A)
(E) edge [bend left] node {1,0,R} (A);
+
+ \node [right=1cm,text width=8cm,font=\footnotesize] at (C)
+ {
+ The current candidate for the busy beaver for five states. It is
+ presumed that this Turing machine writes a maximum number of
+ $1$'s before halting among all Turing machines with five states
+ and the tape alphabet $\{0, 1\}$. Proving this conjecture is an
+ open research problem.
+ };
\end{tikzpicture}
\end{codeexample}
@@ -200,6 +224,11 @@ installation, read the present part.
\part{Ti\emph{k}Z ist \emph{kein} Zeichenprogramm}
\label{part-tikz}
+{\Large \emph{by Till Tantau}}
+
+
+\bigskip
+\noindent
\vskip3cm
\begin{codeexample}[graphic=white]
\begin{tikzpicture}
@@ -241,7 +270,9 @@ installation, read the present part.
\include{pgfmanual-en-tikz-paths}
\include{pgfmanual-en-tikz-actions}
\include{pgfmanual-en-tikz-shapes}
+\include{pgfmanual-en-tikz-matrices}
\include{pgfmanual-en-tikz-trees}
+\include{pgfmanual-en-tikz-plots}
\include{pgfmanual-en-tikz-transformations}
@@ -249,6 +280,11 @@ installation, read the present part.
\part{Libraries}
\label{part-libraries}
+{\Large \emph{by Till Tantau}}
+
+
+\bigskip
+\noindent
In this part the library packages are documented. They
provide additional predefined graphic objects like new arrow heads or
new plot marks. These are not loaded by default since many users will
@@ -271,7 +307,7 @@ not need them.
[level distance=1.75mm,leaf a, line width=.2ex,sibling angle=40]
\pgfarrowsdeclare{leaf}{leaf}
-{\pgfarrowsleftextend{-2pt} \pgfarrowsrightextend{1pt}}
+ {\pgfarrowsleftextend{-2pt} \pgfarrowsrightextend{1pt}}
{
\pgfpathmoveto{\pgfpoint{-2pt}{0pt}}
\pgfpatharc{150}{30}{1.8pt}
@@ -279,7 +315,6 @@ not need them.
\pgfusepathqfill
}
-
\newcommand{\tcslogo}[5]
{
\colorlet{border}{#1}
@@ -301,15 +336,12 @@ not need them.
child foreach \d in {0,1} {
child foreach \leafcolor in {leaf a,leaf b}
{ edge from parent [color=\leafcolor,-#5] }
- }
- }
- }
+ } } }
} edge from parent [shorten >=-1pt,serif cm-,cap=butt]
};
\node [text centered,text width=2cm,below] at (0pt,-.5ex)
- { \textcolor{border}{T}heoretical \\
- \textcolor{border}{C}omputer \\
+ { \textcolor{border}{T}heoretical \\ \textcolor{border}{C}omputer \\
\textcolor{border}{S}cience };
\end{tikzpicture}
}
@@ -324,7 +356,10 @@ not need them.
\include{pgfmanual-en-library-arrows}
\include{pgfmanual-en-library-automata}
\include{pgfmanual-en-library-backgrounds}
+\include{pgfmanual-en-library-calendar}
\include{pgfmanual-en-library-er}
+\include{pgfmanual-en-library-folding}
+\include{pgfmanual-en-library-matrices}
\include{pgfmanual-en-library-mindmaps}
\include{pgfmanual-en-library-patterns}
\include{pgfmanual-en-library-petri}
@@ -342,6 +377,11 @@ not need them.
\part{Utilities}
\label{part-utilities}
+{\Large \emph{by Till Tantau}}
+
+
+\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
@@ -372,13 +412,65 @@ depend on \pgfname\ or they are designed to work well together with
\end{codeexample}
\include{pgfmanual-en-pgffor}
+\include{pgfmanual-en-pgfcalendar}
\include{pgfmanual-en-pages}
\include{pgfmanual-en-xxcolor}
+\part{Mathematical Engine}
+
+{\Large \emph{by Mark Wibrow and Till Tantau}}
+
+
+\bigskip
+\noindent
+\pgfname\ comes with its own mathematical engine. The job of this
+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.
+
+\vskip1cm
+\begin{codeexample}[graphic=white]
+\pgfmathsetseed{1}
+\foreach \col in {black,red,green,blue}
+{
+ \begin{tikzpicture}[x=10pt,y=10pt,ultra thick,baseline,cap=round]
+ \coordinate (current point) at (0,0);
+ \coordinate (old velocity) at (0,0);
+ \coordinate (new velocity) at (rand,rand);
+
+ \foreach \i in {0,1,...,100}
+ {
+ \draw[\col!\i] (current point)
+ .. controls ++([scale=-1]old velocity) and
+ ++(new velocity) .. ++(rand,rand)
+ coordinate (current point);
+ \coordinate (old velocity) at (new velocity);
+ \coordinate (new velocity) at (rand,rand);
+ }
+ \end{tikzpicture}
+}
+\end{codeexample}
+
+\include{pgfmanual-en-math-design}
+\include{pgfmanual-en-math-parsing}
+\include{pgfmanual-en-math-commands}
+\include{pgfmanual-en-math-algorithms}
+
\part{The Basic Layer}
+{\Large \emph{by Till Tantau}}
+
+
+\bigskip
+\noindent
\vskip1cm
\begin{codeexample}[graphic=white]
\begin{tikzpicture}
@@ -416,9 +508,11 @@ depend on \pgfname\ or they are designed to work well together with
\include{pgfmanual-en-base-actions}
\include{pgfmanual-en-base-arrows}
\include{pgfmanual-en-base-nodes}
+\include{pgfmanual-en-base-matrices}
\include{pgfmanual-en-base-transformations}
\include{pgfmanual-en-base-patterns}
\include{pgfmanual-en-base-images}
+\include{pgfmanual-en-base-external}
\include{pgfmanual-en-base-shadings}
\include{pgfmanual-en-base-plots}
\include{pgfmanual-en-base-layers}
@@ -430,6 +524,11 @@ depend on \pgfname\ or they are designed to work well together with
\part{The System Layer}
\label{part-system}
+{\Large \emph{by Till Tantau}}
+
+
+\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.