diff options
author | Karl Berry <karl@freefriends.org> | 2013-02-18 23:43:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-02-18 23:43:32 +0000 |
commit | b6d19726223b2c38cafc53ce388116c33db29f9f (patch) | |
tree | ffb9991eff80cfbaa91ee2a7725193f03c6c2103 | |
parent | 0215784026487c71c14c5c80ff66a05af143b888 (diff) |
flowchart (18feb13)
git-svn-id: svn://tug.org/texlive/trunk@29153 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Master/texmf-dist/doc/latex/flowchart/README | 32 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/flowchart/flowchart.pdf | bin | 0 -> 434271 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/flowchart/flowchart.dtx | 1390 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/flowchart/flowchart.ins | 88 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/flowchart/flowchart.sty | 296 | ||||
-rwxr-xr-x | Master/tlpkg/bin/tlpkg-ctan-check | 2 | ||||
-rw-r--r-- | Master/tlpkg/tlpsrc/collection-pictures.tlpsrc | 1 | ||||
-rw-r--r-- | Master/tlpkg/tlpsrc/flowchart.tlpsrc | 0 |
8 files changed, 1808 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/flowchart/README b/Master/texmf-dist/doc/latex/flowchart/README new file mode 100644 index 00000000000..6bd65aa3c09 --- /dev/null +++ b/Master/texmf-dist/doc/latex/flowchart/README @@ -0,0 +1,32 @@ +flowchart 3.2 (28 January 2013) + +This package provides a set of shapes that can be used in +TikZ picture environments to draw programming flowcharts. + +To install the package, run LaTeX on the installation script +flowchart.ins and follow the instructions provided by the script +itself. + +It requires that the makeshape and TikZ packages are also +installed. + +Run LaTeX on flowchart.dtx to get the package's documentation. +Comment out this files 'OnlyDescription' line to include the +implementation documentation. + +Copyright (C) 2013 by Adrian P Robson + adrian.robson@nepsweb.co.uk + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any later +version. The latest version of this license is in + http://www.latex-project.org/lppl.txt + +This work has the LPPL maintenance status `maintained'. +The Current Maintainer of this work is Adrian Robson. + +This work consists of the files flowchart.dtx and + flowchart.ins +and the derived files flowchart.sty and + flowchart.pdf diff --git a/Master/texmf-dist/doc/latex/flowchart/flowchart.pdf b/Master/texmf-dist/doc/latex/flowchart/flowchart.pdf Binary files differnew file mode 100644 index 00000000000..1882161bc84 --- /dev/null +++ b/Master/texmf-dist/doc/latex/flowchart/flowchart.pdf diff --git a/Master/texmf-dist/source/latex/flowchart/flowchart.dtx b/Master/texmf-dist/source/latex/flowchart/flowchart.dtx new file mode 100644 index 00000000000..0d2ec82e9db --- /dev/null +++ b/Master/texmf-dist/source/latex/flowchart/flowchart.dtx @@ -0,0 +1,1390 @@ +% \iffalse meta-comment +% +% Flowchart 3.2 +% 28 January 2013 +% +% flowchart.dtx +% +% Documented LaTeX file for the flowchart package. +% +% Run LaTeX on flowchart.ini to make the package's +% flowchart.sty file. +% +% Run LaTeX on this file to produce the package +% documentation. +% +% The flowchart package is an outcome of the Fluxion +% project. +% +% Copyright (C) 2013 by Adrian P Robson +% adrian.robson@nepsweb.co.uk +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either +% version 1.3c of this license or (at your option) any later +% version. The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainer of this work is Adrian Robson. +% +% This work consists of the files flowchart.dtx and +% flowchart.ins +% and the derived files flowchart.sty and +% flowchart.pdf +% ----------------------------------------------------------- +% \fi +% +% \iffalse +%<package>\NeedsTeXFormat{LaTeX2e}[2011/06/27] +%<package>\ProvidesPackage{flowchart} +%<package>[2013/01/28 3.2 Flowchart shapes for TikZ] +%<*driver> +\documentclass[10pt,a4paper]{ltxdoc} + +\usepackage{flowchart} +\usetikzlibrary{arrows} + +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\usepackage{textcomp} + +\usepackage{fancyvrb} +\usepackage{enumitem} +\usepackage{url} +\usepackage{array} + +\EnableCrossrefs +\CodelineIndex +\RecordChanges +%\OnlyDescription % comment out for code implementation + +\newcommand{\mnote}[1] +{\marginpar{\scriptsize \raggedright #1 }} + +\def\tikzname{Ti\emph{k}Z} + +\begin{document} +\DocInput{flowchart.dtx} +\end{document} +%</driver> +% \fi +% +%^^A------------------------------------------------------------------- +%^^A Change log... +%^^A------------------------------------------------------------------- +%^^A +%^^A 27 January 2013 +%^^A Original +% \changes{v3.1}{2014/01/27}{ +% The package name is changed from 'fluxion' to 'flowchart'. +% It replaces version 2.4 of the package. +% This is a significant rewrite of the package to use the +% new version 2.1 of Silhouette (makeshape.sty). +% An improved terminal shape has been written. +% The decide shape has been renamed decision. +% The user guide has been extended and clarified. +% Installation has been converted to dtx format, and the +% flowchart.sty is generated by the flowchart.ins file. +% } +%^^A +%^^A 28 January 2013 +%^^A Original +% \changes{v3.2}{2014/01/28}{ +% The decision shape was replaced a better shape that does +% not have an outer separation problem. +% } +%^^A +%^^A------------------------------------------------------------------- +% +% \CheckSum{0} ^^A no checksum for development +%^^A \CheckSum{59} +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% \GetFileInfo{flowchart.sty} +% +% \title{The {\tt flowchart} package\thanks{ +% This document corresponds to \textsf{flowchart}~\fileversion, +% dated~\filedate.}\\[0.5ex] +% Flowchart Shapes for \tikzname} +% +% \author{Adrian P. Robson\thanks{\texttt{adrian.robson@nepsweb.co.uk}}} +% \date{28 January 2013} +% +% \maketitle +% +%^^A \tableofcontents +% +%^^A------------------------------------------------------------------- +%^^A Start report body +%^^A------------------------------------------------------------------- +% +% \section{Introduction} +% +% This package provides shapes for drawing program flowcharts. +% They are based on the classic \emph{IBM Flowcharting Template}, +% which conforms to ISO~1028:1973, with some IBM extensions. +% (this has since been revised by ISO 5807:1985). +% +% At the moment, there is only a limited selection of the standard symbols, +% but other symbols might be added in the future. +% +% This package requires that |makeshape| \cite{makeshape} and of course +% PGF/\tikzname{} \cite{pgfMan} are also installed . +% +% \section{The Symbols}\label{symbols} +% +% The package provides the following symbols as defined in the ISO standard: +% +% \def\colA{3.2cm} +% \def\colB{8cm} +% +% \def\swide{2.8cm} +% \def\pht{1.3cm} +% \def\dht{1.8cm} +% \def\ppht{\pht} +% \def\sht{\pht} +% \def\tht{0.75cm} +% +%^^A - process symbol +% \vspace{3mm} +% \noindent +% \begin{tabular}{m{\colA} m{\colB}} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% \node (process1) at (0,0) [draw, process, +% minimum width=\swide, +% minimum height=\pht] {PROCESS}; %PROCESS +% \end{tikzpicture} +% & +% {\bf Process} -- Any processing function; or defined operations causing change in value, +% form or location of information.\\ +% \end{tabular} +% +%^^A - decision symbol +% \vspace{3mm} +% \noindent +% \begin{tabular}{m{\colA} m{\colB}} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% \node at (0,0) [draw, decision, %aspect=1.5, +% minimum width=\swide, +% minimum height=\dht] {DECISION}; +% \end{tikzpicture} +% & +% {\bf Decision} -- A decision or switching-type operation that determines +% which of a number of alternative paths are followed.\\ +% \end{tabular} +% +%^^A - predefined process symbol +% \vspace{5mm} +% \noindent +% \begin{tabular}{m{\colA} m{\colB}} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% \node at (0,0) [draw, predproc, align=left, +% minimum width=\swide, +% minimum height=\ppht] {Predefined\\ +% Process}; +% \end{tikzpicture} +% & +% {\bf Predefined Process} -- One or more named operations or program steps specified +% in a subroutine or another set of flowcharts.\\ +% \end{tabular} +% +%^^A - storage symbol +% \vspace{5mm} +% \noindent +% \begin{tabular}{m{\colA} m{\colB}} +% \hspace*{-1.85mm} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% \node at (0,0) [draw, storage, +% minimum width=\swide, +% minimum height=\sht] {STORAGE}; +% \end{tikzpicture} +% & +% {\bf Storage} -- Input or output using any kind of online storage.\\ +% +% \end{tabular} +% +%^^A - terminal symbol +% \vspace{4mm} +% \noindent +% \begin{tabular}{m{\colA} m{\colB}} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% \node at (0,0) [ draw, terminal, +% minimum width=\swide, +% minimum height=\tht] {TERMINAL}; +% \end{tikzpicture} +% & +% {\bf Terminal} -- A terminal point in a flowchart: start, stop, halt delay or interrupt. +% It may show exit from a closed subroutine.\\ +% \end{tabular} +% +% \section{Usage} +% +% The example below uses all of the symbols given in \S\ref{symbols}, +% and shows how they can be laid out and connected with \tikzname: +% +% \begin{center} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% +% \def\smbwd{2cm} +% +% \node (terminal1) at (0,0) [draw, terminal, +% minimum width=\smbwd, +% minimum height=0.5cm] {START}; +% +% \node (predproc1) at (0,-1.5) [draw, predproc, align=left, +% minimum width=\smbwd, +% minimum height=1cm] {GET\\ DATA}; +% +% \node (decide1) at (0,-3.5) [draw, decision, +% minimum width=\smbwd, +% minimum height=1cm] {C$<$3}; +% +% \node (storage1) at (0,-5.5) [draw, storage, +% minimum width=\smbwd, +% minimum height=1cm] {STORE}; +% +% \node (process1) at (3,-5.5) [draw, process, +% minimum width=\smbwd, +% minimum height=1cm] {PROCESS}; +% +% \coordinate (point1) at (0,-6.75); +% +% \node (terminal2) at (0,-7.75) [draw, terminal, +% minimum width=\smbwd, +% minimum height=0.5cm] {END}; +% +% \draw[->] (terminal1) -- (predproc1); +% \draw[->] (predproc1) -- (decide1); +% \draw[->] (decide1) -| node[above]{YES} (process1); +% \draw[->] (decide1) -- (storage1); +% \draw[->] (process1) |- (point1); +% \draw[->] (storage1) -- (point1) -- (terminal2); +% +% \end{tikzpicture} +% \end{center} +% +% It needs the following in the document's preamble: +% +% \begin{VerbatimOut}[gobble=5]{\jobname.tmp} +% \usepackage{flowchart} +% \usetikzlibrary{arrows} +% \end{VerbatimOut} +% \VerbatimInput[]{\jobname.tmp} +% +% \noindent +% The \tikzname{} package is included in |flowchart|, so it does not have to be explicitly loaded. +% However, any |\usetikzlibrary| commands that are needed must be placed after +% |\loadpackage{flowchart}|. +% +% The flowchart above is produced by the following |tikzpicture| environment: +% +% \begin{VerbatimOut}[gobble=1]{\jobname.tmp} +% \begin{tikzpicture}[>=latex',font={\sf \small}] +% +% \def\smbwd{2cm} +% +% \node (terminal1) at (0,0) [draw, terminal, +% minimum width=\smbwd, +% minimum height=0.5cm] {START}; +% +% \node (predproc1) at (0,-1.5) [draw, predproc, align=left, +% minimum width=\smbwd, +% minimum height=1cm] {GET\\ DATA}; +% +% \node (decide1) at (0,-3.5) [draw, decision +% minimum width=\smbwd, +% minimum height=1cm] {C$<$3}; +% +% \node (storage1) at (0,-5.5) [draw, storage, +% minimum width=\smbwd, +% minimum height=1cm] {STORE}; +% +% \node (process1) at (3,-5.5) [draw, process, +% minimum width=\smbwd, +% minimum height=1cm] {PROCESS}; +% +% \coordinate (point1) at (0,-6.75); +% +% \node (terminal2) at (0,-7.75) [draw, terminal, +% minimum width=\smbwd, +% minimum height=0.5cm] {END}; +% +% \draw[->] (terminal1) -- (predproc1); +% \draw[->] (predproc1) -- (decide1); +% \draw[->] (decide1) -| node[above]{YES} (process1); +% \draw[->] (decide1) -- (storage1); +% \draw[->] (process1) |- (point1); +% \draw[->] (storage1) -- (point1) -- (terminal2); +% +% \end{tikzpicture} +% \end{VerbatimOut} +% \VerbatimInput[numbers=left]{\jobname.tmp} +% +% \subsection{Symbols} +% +% The flow chart symbols are created as nodes, as shown in lines 5-7, +% which defines a |terminal| shape. +% The minimum dimension keys should be used to create consistently sized symbols. +% In particular, a defined value should be used for the width in all symbols. +% So |\smbwd| is defined on line 3, and used in lines 6, 10, 14, 18, 22, and 28. +% +% \subsection{Layout} +% +% In this example, we have used absolute coordinates to position the diagram's nodes. +% This works well for small flowcharts, but relative positioning might be better for larger diagrams. +% +% \subsection{Connectors} +% +% The shapes are connected by drawing lines between them as shown in lines 31-36 of the example. +% Here, unqualified node names are used, +% but explicit anchor names such as |(nodename.north east)| could be used instead. +% +% It can sometimes be convenient to place a connector at an arbitrary point on a shape. +% The |(nodename.45)| notation achieves this, where the number gives the angle from the centre of the +% shape to the connecting point on its boundary. +% +% Right angled connections are traditionally used in flowcharts, and these are created with +% the \verb+-|+ and \verb+|-+ notations shown in lines 33 and 35 of the example. +% +% Joining connectors is best done by declaring a named coordinate, and using it as the meeting point. +% In the example, a coordinate called |point1| is declared on line 25, +% and then used in line 35 and 36 % to connect |process1| and |storage1| to |terminal2|. +% +%^^A------------------------------------------------------------------- +%^^A References +%^^A------------------------------------------------------------------- +% +% \def\mybib{ +% \begin{thebibliography}{9} +% \raggedright +% \bibitem{makeshape} +% Adrian P. Robson, +% \emph{The makeshape package +% and a method for creating custom shapes in PGF}, 2013. +% Available as {\tt makeshape.pdf} from \url{ctan.org}. +% \bibitem{pgfMan} +% Till Tantau, +% \emph{The TikZ and PGF Packages, Manual for version 2.10}, +% 2010. +% Available as {\tt pgfmanual.pdf} from \url{ctan.org}. +% \end{thebibliography} +% } +% +%^^A------------------------------------------------------------------- +%^^A Start code implementation +%^^A------------------------------------------------------------------- +% +% \StopEventually{\mybib} +%^^A \StopEventually{\mybib \PrintChanges} +%^^A -> Run pdfLaTeX flowchart.dtx +%^^A makeindex -s gglo.ist -o flowchart.gls flowchart.glo +%^^A pdfLaTeX flowchart.dtx +% +% \section{Implementation} +% +% The implementation of |flowchart.sty| uses the |makeshape| package, +% which provides support for custom PGF shapes. +% With this, we have only have to create boundary and anchor path macros, +% and anchor points for each shape. +% +% There are three pairs of keys that have to be accommodated by PGF shapes: +% inner and outer separation, and minimum dimensions. +% The |makeshape| package has corrected text box macros |\ctbnex| and |\ctbney|, +% which automatically handle inner separation; +% and the PGF keys |\pgfshapeouterxsep|, |\pgfshapeouterysep|, |\pgfshapeminheight| and +% |\pgfshapeminwidth|, which give the outer separation and minimum dimensions of the shape. +% +% \subsection{Preamble} +% The |makeshape| package provides the |tikz| package. However, the |shapes| library is also needed: +% +% \begin{macrocode} +\RequirePackage{makeshape} +\RequirePackage{tikz} +\usetikzlibrary{shapes} +% \end{macrocode} +% +%^^A ************************************************************ +%^^A * Predefined Process shape starts +%^^A ************************************************************ +% \subsection{Predproc Shape} +% +% This is the Predefined Process symbol. +% +% \subsubsection{Anchor and background paths}\label{predprocpaths} +% +% +% These macros define the paths that are used by the |makeshape| |setpaths| command in +% the shape's |\pgfdeclareshape| macro, which is described in \S\ref{predprocShape}. +% +% \begin{macro}{\band} +% The shape's side band size is an internal constant: +% \begin{macrocode} +\def\band{10pt} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\predprocAnchorpath} +% The |\predprocAnchorpath| macro defines the shape's \emph{anchor path}. +% It `draws' the path on which the shape's calculated anchor points lay. +% It is very similar to first part of |\predproc@shape| that draws the outer path, +% but it corrects for outer separation and does not draw any side bands. +% \begin{macrocode} +\def\predprocAnchorpath{ +% \end{macrocode} +% +% First, get the corrected text box's NE corner using |\ctbnex| and |\ctbney|, +% then make room for the side band. +% \begin{macrocode} + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \band +% \end{macrocode} +% Correct for minimum dimensions and outer separation: +% \begin{macrocode} + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep +% \end{macrocode} +% +% Finally, draw the anchor path, which is a rectangle, +% using the values in |\pgf@xa| and |\pgf@ya| that were calculated above: +% \begin{macrocode} + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathclose +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\predprocBackground} +% The |\predprocBackground| macro draws the shape's path, including its side band. +% It is used in the shape's |\backgroundpath| macro. +% \begin{macrocode} +\def\predprocBackground{ +% \end{macrocode} +% +% First, get the corrected text box's NE corner using |\ctbnex| and |\ctbney|, +% then make room for the side band. +% \begin{macrocode} + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \band +% \end{macrocode} +% Correct for minimum dimensions but \emph{do not add} outer separation: +% \begin{macrocode} + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \mincorrect{\pgf@ya}{\pgfshapeminheight} +% \end{macrocode} +% +% Finally, draw the outer shape, which is a rectangle, +% using the values in |\pgf@xa| and |\pgf@ya| that were calculated above: +% \begin{macrocode} + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathclose +% \end{macrocode} +% +% Finally, we draw the inner shape, which completes the shape with its side bands. +% The x-coordinate is aligned on the right side band position, then the side bands are drawn: +% \begin{macrocode} + \advance\pgf@xa by -\band + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathmoveto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} +} +% \end{macrocode} +% \end{macro} +% +% +% \subsubsection{Predproc shape declaration}\label{predprocShape} +% +% \begin{macro}{\pgfdeclareshape} +% \begin{macro}{predproc} +% This is the |\pgfdeclareshape| declaration for the |predproc| shape. +% \begin{macrocode} +\pgfdeclareshape{predproc}{ +% \end{macrocode} +% The path macros defined in \S\ref{predprocpaths} are used as follows +% with the |setpaths| command provided by the |makeshape| package to draw the +% shape and make boundary intersection calculations. +% \begin{macrocode} + \setpaths{\predprocAnchorpath}{\predprocBackground} +% \end{macrocode} +% +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeast} +% The |\northeast| saved anchor is used to define the position of the NE corner of the shape. +% The calculation is similar that used in the anchor path described in \S\ref{predprocpaths}, +% and corrects for inner and outer separation, and minimum dimensions. +% It returns the coordinates of the point in |\pgf@x| and |\pgf@y|. +% \begin{macrocode} + \savedanchor{\northeast}{ + \pgf@x = \ctbnex + \advance\pgf@x by \band + \mincorrect{\pgf@x}{\pgfshapeminwidth} + \advance\pgf@x\pgfshapeouterxsep + \pgf@y = \ctbney + \mincorrect{\pgf@y}{\pgfshapeminheight} + \advance\pgf@y\pgfshapeouterysep + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north} +% \begin{macro}{north east} +% \begin{macro}{east} +% \begin{macro}{south east} +% \begin{macro}{south} +% \begin{macro}{south west} +% \begin{macro}{west} +% \begin{macro}{north west} +% There are some standard anchors, which +% are all based on the |\northeast| saved anchor: +% \begin{macrocode} + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeast \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeast \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \begin{macrocode} +} +% \end{macrocode} +% \end{macro} ^^A end predproc +% \end{macro} ^^A end \pgfdeclareshape +% +%^^A ************************************************************ +%^^A * Predefined Process shape ends +%^^A ************************************************************ +% +%^^A ************************************************************ +%^^A * Storage shape starts +%^^A ************************************************************ +% \subsection{Storage Shape} +% +% \subsubsection{Support Macros} +% +% \begin{macro}{\storagepath} +% The |storage| shape's background path is defined in |\storagepath|. +% It requires the following register to be set: +% +% \begin{tabular}{ll} +% |\pgf@x| & x coordinate of NE corner excluding outer separation\\ +% |\pgf@y| & y coordinate of NE corner excluding outer separation\\ +% |\pgf@xc| & arc offset for y coordinate +% \end{tabular} +% +%\medskip +% The NE corner is stored in |\pgf@xa| and |\pgf@ya| and +% and the SW corner is put in |\pgf@xb| and |\pgf@yb|. +% The SW x-coordinate has to be moved right by the arc offset to compensate for the +% curve of the shapes west side. +% \begin{macrocode} +\def\storagepath{ + \pgf@xa=\pgf@x \pgf@ya=\pgf@y + \pgf@xb=-\pgf@xa \pgf@yb=-\pgf@ya + \advance\pgf@xb by \pgf@xc +% \end{macrocode} +% The shape is drawn from its SW corner moving counter clockwise. +% The radius for the arcs is the height. +% \begin{macrocode} + \pgfpathmoveto{\pgfpoint{\pgf@xb}{\pgf@yb}} + \pgfpatharc{210}{150}{2*\pgf@ya} + \pgfpathlineto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpatharc{150}{210}{2*\pgf@ya} + \pgfpathclose +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\arcoffset} +% The |storage| shape's arc offset is calculated by the |\arcoffset| macro. +% The required arc offset is $b$, and the shape's height is $h$ in the diagram below. +% \medskip +% +% \begin{tabular}{cc} +% \begin{tikzpicture} +% \def\sht{4cm} +% \def\oset{0.536cm} +% \def\a{\sht+\oset} +% \draw[] (0,0) -- (-\sht,0); +% \draw[] (-\sht,0) arc (0:40:-\sht); +% \draw[] (-\sht,0) arc (180:140:\sht); +% \draw[] (-\a,-\sht*0.5) -- (-\a,\sht*0.5); +% \draw[] (-\a,\sht*0.5) -- (0,0); +% \draw[] (-\a,\sht*0.5) -- ++(-1,0); +% \draw[] (-\a,-\sht*0.5) -- ++(-1,0); +% \node at (-2cm,1.5cm) [] {$h$}; +% \node at (-3.1cm,0.7cm) [] {$h/2$}; +% \node at (-2cm,-0.2cm) [] {$a$}; +% \node at (-3.7cm,-0.2cm) [] {$b$}; +% \end{tikzpicture} +% & +% \begin{minipage}[b]{6.5cm} +% \begin{eqnarray} +% h^2 &=& a^2 + \left(\frac{h}{2}\right)^2 \nonumber\\[3pt] +% a^2 &=& h^2 - \frac{h^2}{4} = \frac{3h^2}{4} \nonumber\\[2pt] +% a &=& h \sqrt{3/4}\\[2ex] +% b &=& h - a = h - h \sqrt{3/4} \nonumber\\[2pt] +% &=& h(1 - \sqrt{3/4}) \approx 0.134h \label{equoffset} \\\nonumber +% \end{eqnarray} +% \end{minipage} +% \end{tabular} +% +% \bigskip +% \noindent +% The macro's parameters are: +% +% \begin{tabular}{ll} +% |#1| & the calculated arc offset\\ +% |#2| & half the height\\ +% \end{tabular} +% +% \medskip\noindent +% Equation \ref{equoffset} given above is implemented as follows: +% \begin{macrocode} +\def\arcoffset#1#2{ + \pgfmathsetlength#1{0.134*2*#2} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\storageParams} +% The |\storageParams| macro calculates reference values for the shape +% with no outer separation. +% The following have values assigned after it is called: +% +% \begin{tabular}{ll} +% |\pgf@x| & x-coordinate of NE corner excluding outer separation\\ +% |\pgf@y| & y-coordinate of NE corner excluding outer separation\\ +% |\pgf@xc| & arc offset for y-coordinate +% \end{tabular} +% +% \medskip +% First get the shape's corrected text box: +% \begin{macrocode} +\def\storageParams{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney +% \end{macrocode} +% Correct for minimum height but not for outer separation. +% \begin{macrocode} + \mincorrect{\pgf@ya}{\pgfshapeminheight} +% \end{macrocode} +% Calculate the room needed for the side arc, which is one of the macro's outputs, +% and use it to change the x-coordinate: +% \begin{macrocode} + \arcoffset{\pgf@xc}{\pgf@ya} + \advance\pgf@xa by \pgf@xc +% \end{macrocode} +% Finally, correct for minimum width and set the output registers: +% \begin{macrocode} + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \pgf@x=\pgf@xa + \pgf@y=\pgf@ya +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\storageParamsOuter} +% The |\storageParamsOuter| macro calculates reference values for the shape +% with its outer separation included. +% The following have values assigned after it is called: +% \begin{tabular}{ll} +% |\pgf@x| & x coordinate of NE corner including outer separation\\ +% |\pgf@y| & y coordinate of NE corner including outer separation\\ +% |\pgf@xc| & arc offset for y coordinate +% \end{tabular} +% +% \medskip +% Its implementation has a lot in common with |\storageParams|. +% First, get the NE corner of the corrected text box: +% \begin{macrocode} +\def\storageParamsOuter{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney +% \end{macrocode} +% Correct for minimum height and outer separation: +% \begin{macrocode} + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep +% \end{macrocode} +% Calculate the arc offset, which is an output, and make room for the side curve: +% \begin{macrocode} + \arcoffset{\pgf@xc}{\pgf@ya} + \advance\pgf@xa by \pgf@xc +% \end{macrocode} +% Finally, correct for minimum width and outer separation. Then set the output registers: +% \begin{macrocode} + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \pgf@x=\pgf@xa + \pgf@y=\pgf@ya +} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Anchor and background paths}\label{storagepaths} +% +% The anchor and background path macros both use |\storagepath|, but with with different parameters. +% The output registers of the macros |\storageParams| and |\storageParamsOuter| +% are compatible with the inputs of |\storagepath|. +% +% \begin{macro}{\storageAnchorpath} +% The |\storageAnchorpath| macro defines the shape's \emph{anchor path}. +% It `draws' the path on which the shape's calculated anchor points lay. +% This is similar to the background path but it is corrected for outer separation +% and minimum dimensions. +% \begin{macrocode} +\def\storageAnchorpath{ + \storageParamsOuter + \storagepath +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\storageBackground} +% The |\storageBackground| macro draws the path that is the outer boundary of the +% |storage| shape. This excludes outer separation but corrects for minimum height and width. +% \begin{macrocode} +\def\storageBackground{ + \storageParams + \storagepath +} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Storage shape declaration} +% +% \begin{macro}{\pgfdeclareshape} +% \begin{macro}{storage} +% This is the |\pgfdeclareshape| declaration for the |storage| shape. +% \begin{macrocode} +\pgfdeclareshape{storage}{ +% \end{macrocode} +% The path macros defined in \S\ref{storagepaths} are used +% with the |setpaths| command provided by the |makeshape| package to draw the +% shape and make boundary intersection calculations: +% \begin{macrocode} + \setpaths{\storageAnchorpath}{\storageBackground} +% \end{macrocode} +% +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeast} +% There are two saved anchors defined for the |storage| shape. +% The |\northeast| saved anchor is used to define the position of the NE corner of the shape. +% The calculation is similar that used in the anchor path described in \S\ref{storagepaths}, +% and corrects for inner and outer separation, and minimum dimensions. +% It returns the coordinates of the point in |\pgf@x| and |\pgf@y|, +% and its implementation is trivial since |\storageParamsOuter| does the required work. +% \begin{macrocode} + \savedanchor{\northeast}{ + \storageParamsOuter + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeast} +% The |\northeastArc| saved anchor is similar, but corrects for the arc offset. +% +% \begin{macrocode} + \savedanchor{\northeastArc}{ + \storageParamsOuter + \advance\pgf@x by -\pgf@xc + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north} +% \begin{macro}{north east} +% \begin{macro}{east} +% \begin{macro}{south east} +% \begin{macro}{south} +% \begin{macro}{south west} +% \begin{macro}{west} +% \begin{macro}{north west} +% The standard anchors are defined. +% These are based on the |\northeast| and |\northeastArc| saved anchors: +% \begin{macrocode} + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeastArc \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeastArc \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeast \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeastArc \pgf@x=-\pgf@x } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north} +% \begin{macro}{north east} +% \begin{macro}{east} +% Three additional anchors are defined that follow the shape's bounding rectangle. +% \begin{macrocode} + \anchor{east r}{ \northeast \pgf@y=0pt } + \anchor{north west r}{ \northeast \pgf@x=-\pgf@x } + \anchor{south west r}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macrocode} +} +% \end{macrocode} +% \end{macro} ^^A end storage +% \end{macro} ^^A end \pgfdeclareshape +% +%^^A ************************************************************ +%^^A * Storage shape ends +%^^A ************************************************************ +% +%^^A ************************************************************ +%^^A * Process shape starts +%^^A ************************************************************ +% \subsection{Process Shape} +% +% \begin{macro}{\pgfdeclareshape} +% \begin{macro}{process} +% The {\tt process} shape is simply implemented +% by inheriting relevant anchors and paths from the standard |rectangle| shape +% without any changes: +% \begin{macrocode} +\pgfdeclareshape{process}{ + \inheritsavedanchors[from=rectangle] + \inheritanchor[from=rectangle]{center} + \inheritanchor[from=rectangle]{text} + \inheritanchor[from=rectangle]{north} + \inheritanchor[from=rectangle]{north east} + \inheritanchor[from=rectangle]{east} + \inheritanchor[from=rectangle]{south east} + \inheritanchor[from=rectangle]{south} + \inheritanchor[from=rectangle]{south west} + \inheritanchor[from=rectangle]{west} + \inheritanchor[from=rectangle]{north west} + \inheritbackgroundpath[from=rectangle] + \inheritanchorborder[from=rectangle] +} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +%^^A ************************************************************ +%^^A * Process shape ends +%^^A ************************************************************ +% +%^^A ************************************************************ +%^^A * Decision shape starts +%^^A ************************************************************ +% \subsection{Decision Shape} +% +% \subsubsection{Support Macros} +% +% Two macros |\decisionref| and |\decisionrefout| give a reference point for the |decision| shape. +% The default shape is a rotated square which touches the corrected text box. +% The location and calculation of the default reference point is illustrated below: +% +% \begin{center} +% \begin{tikzpicture} +% +% ^^A - Axis +% \draw [dotted] (0,0) -- +(3cm,0) -- +(-3cm,0) +(0,3cm) -- +(0,-1cm); +% +% ^^A - draw line +% \draw [] (0,2.5cm) -- (2.5cm,0); +% +% ^^A East point +% \node at (3.4cm,-0.3cm) [] {$(0,x_t + y_t)$}; +% \draw [] (2.5cm,0) circle (2pt); +% +% ^^A North point +% \node at (-1cm,2.5cm) [] {$(y_t + x_t,0)$}; +% \draw [] (0,2.5cm) circle (2pt); +% \node at (-0.6cm,1.8cm) [outer sep=-2pt] (angletxt) {$45^\circ$}; +% \node at (0.15cm,2.1cm) [coordinate] (anglepnt) {}; +% \draw [->] (angletxt) -- (anglepnt); +% +% ^^A Reference point +% \draw [dotted] (0,2.5cm) -- +(3,0); +% \draw [dotted] (2.5cm,0) -- +(0,3); +% \node at (3.7cm,2.7cm) [] {\sf \small reference point}; +% \node at (3.9cm,2.2cm) [] {$(y_t+x_t,x_t+y_t)$}; +% \draw (2.5cm,2.5cm) circle (2pt); +% \draw (2.5cm,2.5cm) -- +(4pt,0) -- +(-4pt,0) +(0,4pt) -- +(0,-4pt); +% +% ^^A - Corrected text box +% \node at (-1.5cm,0.7cm) [] {\sf \small corrected text box}; +% \node at (2.5cm,0.7cm) [rectangle,draw,fill,white,minimum height=12pt] {}; +% \node at (2.6cm,0.7cm) [] {$(x_t,y_t)$}; +% \draw [] (2cm,0.5cm) circle (2pt); +% \node at (0,0) +% [rectangle, draw, +% minimum width=4cm, +% minimum height=1cm, +% ] (ctb) {}; +% +% \end{tikzpicture} +% \end{center} +% \vspace{-2ex} +% +% \begin{macro}{\decisionrefout} +% The |\decisionrefout| macro gives a reference point on the bounding rectangle of +% the |decision| shape. +% Inner and outer separation are included, and it is corrected for the shape's minimum dimensions. +% On completion, the coordinates of the point are in |\pgf@xa| and |\pgf@ya|. +% +% First, the coordinates of the corrected text box are put into some registers: +% \begin{macrocode} +\def\decisionrefout{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \pgf@xb=\ctbnex + \pgf@yb=\ctbney +% \end{macrocode} +% The reference point's x-coordinates is calculated and corrected for minimum width, +% and outer x-separation: +% \begin{macrocode} + \advance\pgf@xa by \pgf@yb + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa by \pgfshapeouterxsep +% \end{macrocode} +% Then the calculation and correction is repeated for the y-coordinate: +% \begin{macrocode} + \advance\pgf@ya by \pgf@xb + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya by \pgfshapeouterysep +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\decisionref} +% The |\decisionref| macro is almost the same as |\decisionrefout| +% but has no correction for outer separation. +% Again, the coordinates of the point are in |\pgf@xa| and |\pgf@ya| on completion: +% \begin{macrocode} +\def\decisionref{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \pgf@xb=\ctbnex + \pgf@yb=\ctbney + \advance\pgf@xa by \pgf@yb + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@ya by \pgf@xb + \mincorrect{\pgf@ya}{\pgfshapeminheight} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\decisionpath} +% The |\decisionpath| macro draws the |\decision| shape's path. +% It expects the reference point coordinates to be in |\pgf@xa| and |\pgf@ya|. +% The path is drawn clockwise starting at the top: +% \begin{macrocode} +\def\decisionpath{ + \def\refx{\pgf@xa} + \def\refy{\pgf@ya} + \pgfpathmoveto{\pgfpoint{0}{\refy}} + \pgfpathlineto{\pgfpoint{\refx}{0}} + \pgfpathlineto{\pgfpoint{0}{-\refy}} + \pgfpathlineto{\pgfpoint{-\refx}{0}} + \pgfpathclose +} +% \end{macrocode} +% \end{macro} +% +%\subsubsection{Anchor and background paths}\label{decisionpaths} +% +% \begin{macro}{\decisionanchor} +% The |\decisionanchor| macro is the anchor path for the shape's |setpath|: +% \begin{macrocode} +\def\decisionanchor{ + \decisionrefout + \decisionpath +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\decisionborder} +% The |\decisionborder| macro is the border path for the shape's |setpath|: +% \begin{macrocode} +\def\decisionborder{ + \decisionref + \decisionpath +} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Decision shape declaration} +% +% \begin{macro}{\pgfdeclareshape} +% \begin{macro}{decision} +% This is the |\pgfdeclareshape| declaration for the |decision| shape. +% \begin{macrocode} +\pgfdeclareshape{decision}{ +% \end{macrocode} +% The path macros defined in \S\ref{terminalpaths} are used +% with the |setpaths| command provided by the |makeshape| package to draw the +% shape and make boundary intersection calculations: +% \begin{macrocode} + \setpaths{\decisionanchor}{\decisionborder} +% \end{macrocode} +% +% There are three saved anchors defined for the |decision| shape. +% They have to correct for inner and outer separation, and minimum dimensions; +% and return the coordinates of the point in |\pgf@x| and |\pgf@y|. +% However, this is simplified because |\decisionrefout| does the required work. +% \begin{macro}{\savedanchor} +% \begin{macro}{\north} +% The |\north| saved anchor uses the y-coordinate of the reference point: +% \begin{macrocode} + \savedanchor{\north}{ + \decisionrefout + \pgf@x = 0pt + \pgf@y = \pgf@ya + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \begin{macro}{\savedanchor} +% \begin{macro}{\north} +% The |\east| saved anchor uses the x-coordinate of the reference point: +% \begin{macrocode} + \savedanchor{\east}{ + \decisionrefout + \pgf@x = \pgf@xa + \pgf@y = 0pt + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeast} +% The |\northeast| saved anchor uses the both coordinates of the reference point to +% calculate the required point: +% \begin{macrocode} + \savedanchor{\northeast}{ + \decisionrefout + \divide\pgf@xa by 2 + \divide\pgf@ya by 2 + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north} +% \begin{macro}{north east} +% \begin{macro}{east} +% \begin{macro}{south east} +% \begin{macro}{south} +% \begin{macro}{south west} +% \begin{macro}{west} +% \begin{macro}{north west} +% The standard anchors are defined. +% These are based on the |\north| |\east| and |\northeast| saved anchors: +% \begin{macrocode} + \anchor{north}{ \north } + \anchor{north east}{ \northeast } + \anchor{east}{ \east } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \north \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \east \pgf@x=-\pgf@x } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macrocode} +} +% \end{macrocode} +% \end{macro} ^^A end decision +% \end{macro} ^^A end \pgfdeclareshape +% +%^^A ************************************************************ +%^^A * Decision shape ends +%^^A ************************************************************ +% +%^^A ************************************************************ +%^^A * Terminal shape starts +%^^A ************************************************************ +% \subsection{Terminal Shape} +% +% \subsubsection{Support Macros} +% +% Two macros |\terminalrefneout| and |\terminalrefne| give a reference point on the +% boundary surface of the |terminal| shape. +% +% \begin{center} +% \begin{tikzpicture} +% ^^A - Axis +% \draw [dotted] (0,0) -- +(2cm,0) -- +(-2cm,0) +(0,1cm) -- +(0,-1cm); +% ^^A - Terminal shape +% \node (terminal) at (0,0) [draw,terminal,minimum height=1cm, minimum width=3cm] {}; +% ^^ A - Reference point +% \draw (terminal.north east) circle (2pt); +% \node at (1.7cm,0.8cm) [] {\sf \small reference point}; +% \draw [dotted] (terminal.north east) -- +(0,-1.5cm) -- +(0,0.2cm); +% \end{tikzpicture} +% \end{center} +% \vspace{-2ex} +% +% \begin{macro}{\terminalrefneout} +% The |\terminalrefneout| macro gives a reference point on the boundary surface of +% the |terminal| shape. +% Inner and outer separation are included, and it is corrected for the shape's minimum dimensions. +% On completion, the coordinates of the point are in |\pgf@xa| and |\pgf@ya|. +% +% First, the coordinates of the corrected text box are obtained, +% and then the width of the rounded end is add to the x-coordinate to get the bounding +% dimensions: +% \begin{macrocode} +\def\terminalrefneout{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \pgf@ya +% \end{macrocode} +% Then these bounding coordinates are corrected for minimum dimensions, and outer separation: +% \begin{macrocode} + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep +% \end{macrocode} +% Finally, the corrected x-coordinate is reduced by the width of the rounded end to give +% the required reference point: +% \begin{macrocode} + \advance\pgf@xa by -\pgf@ya +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\terminalrefne} +% The |\terminalrefne| macro is almost the same as |\terminalrefneout| +% but has no correction for outer separation. +% Again, the coordinates of the point are in |\pgf@xa| and |\pgf@ya| on completion: +% \begin{macrocode} +\def\terminalrefne{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \pgf@ya + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@xa by -\pgf@ya +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\terminalpath} +% The |\terminalpath| macro draws the |terminal| shape's path. +% It expects the reference point coordinates to be in |\pgf@xa| and |\pgf@ya|. +% The path is drawn anticlockwise: +% \begin{macrocode} +\def\terminalpath{ + \def\refx{\pgf@xa} + \def\refy{\pgf@ya} + \def\radius{\refy} + \pgfpathmoveto{\pgfpoint{\refx}{\refy}} + \pgfpathlineto{\pgfpoint{-\refx}{\refy}} + \pgfpatharc{90}{270}{\radius} + \pgfpathlineto{\pgfpoint{\refx}{-\refy}} + \pgfpatharc{270}{360}{\radius} + \pgfpatharc{0}{90}{\radius} + \pgfpathclose +} +% \end{macrocode} +% \end{macro} +% +%\subsubsection{Anchor and background paths}\label{terminalpaths} +% +% \begin{macro}{\terminalanchor} +% The |\terminalanchor| macro is the anchor path for the shape's |setpath|: +% \begin{macrocode} +\def\terminalanchor{ + \terminalrefneout + \terminalpath +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\terminalborder} +% The |\terminalborder| macro is the border path for the shape's |setpath|: +% \begin{macrocode} +\def\terminalborder{ + \terminalrefne + \terminalpath +} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Terminal shape declaration} +% +% \begin{macro}{\pgfdeclareshape} +% \begin{macro}{terminal} +% This is the |\pgfdeclareshape| declaration for the |terminal| shape. +% \begin{macrocode} +\pgfdeclareshape{terminal}{ +% \end{macrocode} +% The path macros defined in \S\ref{terminalpaths} are used +% with the |setpaths| command provided by the |makeshape| package to draw the +% shape and make boundary intersection calculations: +% \begin{macrocode} + \setpaths{\terminalanchor}{\terminalborder} +% \end{macrocode} +% +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeast} +% There are two saved anchors defined for the |terminal| shape. +% The |\northeast| saved anchor gives the position of the shape's `reference point' used above. +% It corrects for inner and outer separation, and minimum dimensions. +% It returns the coordinates of the point in |\pgf@x| and |\pgf@y|, +% and its implementation is simple since |\terminalrefneout| does the required work. +% \begin{macrocode} + \savedanchor{\northeast}{ + \terminalrefneout + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\savedanchor} +% \begin{macro}{\northeastBB} +% The |\northeastBB| macro gives the coordinates of the NE corner of the shape's +% bounding rectangle in |\pgf@x| and |\pgf@y|. +% It corrects for inner and outer separation, and minimum dimensions. +% It is obtain by adding the width of the shape's round end to the x-coordinate of the +% reference point: +% \begin{macrocode} + \savedanchor{\northeastBB}{ + \terminalrefneout + \advance \pgf@xa by \pgf@ya + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north} +% \begin{macro}{north east} +% \begin{macro}{east} +% \begin{macro}{south east} +% \begin{macro}{south} +% \begin{macro}{south west} +% \begin{macro}{west} +% \begin{macro}{north west} +% The standard anchors are defined. +% These are based on the |\northeast| and |\northeastBB| saved anchors: +% \begin{macrocode} + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeastBB \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeastBB \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\anchor} +% \begin{macro}{north east r} +% \begin{macro}{south east r} +% \begin{macro}{south west r} +% \begin{macro}{north west r} +% Four additional anchors are defined that follow the shape's bounding rectangle. +% \begin{macrocode} + \anchor{north east r}{\northeastBB} + \anchor{south east r}{\northeastBB \pgf@y=-\pgf@y} + \anchor{south west r}{\northeastBB \pgf@x=-\pgf@x \pgf@y=-\pgf@y} + \anchor{north west r}{\northeastBB \pgf@x=-\pgf@x} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macrocode} +} +% \end{macrocode} +% \end{macro} ^^A end terminal +% \end{macro} ^^A end \pgfdeclareshape +% +%^^A ************************************************************ +%^^A * Terminal shape ends +%^^A ************************************************************ +% +% \Finale +\endinput diff --git a/Master/texmf-dist/source/latex/flowchart/flowchart.ins b/Master/texmf-dist/source/latex/flowchart/flowchart.ins new file mode 100644 index 00000000000..c75538a2688 --- /dev/null +++ b/Master/texmf-dist/source/latex/flowchart/flowchart.ins @@ -0,0 +1,88 @@ +% +% Flowchart 3.2 +% 28 January 2013 +% +% flowchart.ins +% +% Installation file for the flowchart package. +% +% Run LaTeX on this file, with flowchart.dtx in the same +% folder to make the package's flowchart.sty file. +% +% Run LaTeX on flowchart.dtx to produce the package +% documentation. +% +% The flowchart package is an outcome of the Fluxion +% project. +% +% Copyright (C) 2013 by Adrian P Robson +% adrian.robson@nepsweb.co.uk +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either +% version 1.3c of this license or (at your option) any later +% version. The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainer of this work is Adrian Robson. +% +% This work consists of the files flowchart.dtx and +% flowchart.ins +% and the derived files flowchart.sty and +% flowchart.pdf +% ----------------------------------------------------------- + +\input docstrip.tex +\keepsilent +\askforoverwritefalse + +\preamble + +Copyright (C) 2013 by Adrian P Robson + adrian.robson@nepsweb.co.uk + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any later +version. The latest version of this license is in + http://www.latex-project.org/lppl.txt + +This work has the LPPL maintenance status `maintained'. +The Current Maintainer of this work is Adrian Robson. + +This work consists of the files flowchart.dtx and + flowchart.ins +and the derived files flowchart.sty and + flowchart.pdf + +\endpreamble + +\Msg{} +\Msg{**********************************************************} +\Msg{* The flowchart package} +\Msg{* flowchart.ins and flowchart.dtx are being processed} +\Msg{**********************************************************} + +\generate{\file{flowchart.sty}{\from{flowchart.dtx}{package}}} + +\Msg{**********************************************************} +\Msg{* Processing complete ...} +\Msg{*} +\Msg{* To finish the installation, put flowchart.sty in a} +\Msg{* suitable place on your system's TeX search path.} +\Msg{*} +\Msg{* Run LaTeX on flowchart.dtx to produce the documentation.} +\Msg{* Comment out its 'OnlyDescription' line to include the} +\Msg{* implementation documentation. } +\Msg{*} +\Msg{* You might like to keep flowchart.ins and flowchart.dtx} +\Msg{* somewhere safe as a backup, or in case you want to } +\Msg{* pass the flowchart package on to someone.} +\Msg{*} +\Msg{* Do not forget to delete the auxiliary files.} +\Msg{**********************************************************} +\Msg{} + +\endbatchfile
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/flowchart/flowchart.sty b/Master/texmf-dist/tex/latex/flowchart/flowchart.sty new file mode 100644 index 00000000000..347da322261 --- /dev/null +++ b/Master/texmf-dist/tex/latex/flowchart/flowchart.sty @@ -0,0 +1,296 @@ +%% +%% This is file `flowchart.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% flowchart.dtx (with options: `package') +%% +%% Copyright (C) 2013 by Adrian P Robson +%% adrian.robson@nepsweb.co.uk +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% +%% This work has the LPPL maintenance status `maintained'. +%% The Current Maintainer of this work is Adrian Robson. +%% +%% This work consists of the files flowchart.dtx and +%% flowchart.ins +%% and the derived files flowchart.sty and +%% flowchart.pdf +%% +\NeedsTeXFormat{LaTeX2e}[2011/06/27] +\ProvidesPackage{flowchart} +[2013/01/28 3.2 Flowchart shapes for TikZ] +\RequirePackage{makeshape} +\RequirePackage{tikz} +\usetikzlibrary{shapes} +\def\band{10pt} +\def\predprocAnchorpath{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \band + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathclose +} +\def\predprocBackground{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \band + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathclose + \advance\pgf@xa by -\band + \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{\pgf@xa}{-\pgf@ya}} + \pgfpathmoveto{\pgfpoint{-\pgf@xa}{\pgf@ya}} + \pgfpathlineto{\pgfpoint{-\pgf@xa}{-\pgf@ya}} +} +\pgfdeclareshape{predproc}{ + \setpaths{\predprocAnchorpath}{\predprocBackground} + \savedanchor{\northeast}{ + \pgf@x = \ctbnex + \advance\pgf@x by \band + \mincorrect{\pgf@x}{\pgfshapeminwidth} + \advance\pgf@x\pgfshapeouterxsep + \pgf@y = \ctbney + \mincorrect{\pgf@y}{\pgfshapeminheight} + \advance\pgf@y\pgfshapeouterysep + } + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeast \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeast \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } +} +\def\storagepath{ + \pgf@xa=\pgf@x \pgf@ya=\pgf@y + \pgf@xb=-\pgf@xa \pgf@yb=-\pgf@ya + \advance\pgf@xb by \pgf@xc + \pgfpathmoveto{\pgfpoint{\pgf@xb}{\pgf@yb}} + \pgfpatharc{210}{150}{2*\pgf@ya} + \pgfpathlineto{\pgfpoint{\pgf@xa}{\pgf@ya}} + \pgfpatharc{150}{210}{2*\pgf@ya} + \pgfpathclose +} +\def\arcoffset#1#2{ + \pgfmathsetlength#1{0.134*2*#2} +} +\def\storageParams{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \arcoffset{\pgf@xc}{\pgf@ya} + \advance\pgf@xa by \pgf@xc + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \pgf@x=\pgf@xa + \pgf@y=\pgf@ya +} +\def\storageParamsOuter{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep + \arcoffset{\pgf@xc}{\pgf@ya} + \advance\pgf@xa by \pgf@xc + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \pgf@x=\pgf@xa + \pgf@y=\pgf@ya +} +\def\storageAnchorpath{ + \storageParamsOuter + \storagepath +} +\def\storageBackground{ + \storageParams + \storagepath +} +\pgfdeclareshape{storage}{ + \setpaths{\storageAnchorpath}{\storageBackground} + \savedanchor{\northeast}{ + \storageParamsOuter + } + \savedanchor{\northeastArc}{ + \storageParamsOuter + \advance\pgf@x by -\pgf@xc + } + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeastArc \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeastArc \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeast \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeastArc \pgf@x=-\pgf@x } + \anchor{east r}{ \northeast \pgf@y=0pt } + \anchor{north west r}{ \northeast \pgf@x=-\pgf@x } + \anchor{south west r}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } +} +\pgfdeclareshape{process}{ + \inheritsavedanchors[from=rectangle] + \inheritanchor[from=rectangle]{center} + \inheritanchor[from=rectangle]{text} + \inheritanchor[from=rectangle]{north} + \inheritanchor[from=rectangle]{north east} + \inheritanchor[from=rectangle]{east} + \inheritanchor[from=rectangle]{south east} + \inheritanchor[from=rectangle]{south} + \inheritanchor[from=rectangle]{south west} + \inheritanchor[from=rectangle]{west} + \inheritanchor[from=rectangle]{north west} + \inheritbackgroundpath[from=rectangle] + \inheritanchorborder[from=rectangle] +} +\def\decisionrefout{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \pgf@xb=\ctbnex + \pgf@yb=\ctbney + \advance\pgf@xa by \pgf@yb + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa by \pgfshapeouterxsep + \advance\pgf@ya by \pgf@xb + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya by \pgfshapeouterysep +} +\def\decisionref{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \pgf@xb=\ctbnex + \pgf@yb=\ctbney + \advance\pgf@xa by \pgf@yb + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@ya by \pgf@xb + \mincorrect{\pgf@ya}{\pgfshapeminheight} +} +\def\decisionpath{ + \def\refx{\pgf@xa} + \def\refy{\pgf@ya} + \pgfpathmoveto{\pgfpoint{0}{\refy}} + \pgfpathlineto{\pgfpoint{\refx}{0}} + \pgfpathlineto{\pgfpoint{0}{-\refy}} + \pgfpathlineto{\pgfpoint{-\refx}{0}} + \pgfpathclose +} +\def\decisionanchor{ + \decisionrefout + \decisionpath +} +\def\decisionborder{ + \decisionref + \decisionpath +} +\pgfdeclareshape{decision}{ + \setpaths{\decisionanchor}{\decisionborder} + \savedanchor{\north}{ + \decisionrefout + \pgf@x = 0pt + \pgf@y = \pgf@ya + } + \savedanchor{\east}{ + \decisionrefout + \pgf@x = \pgf@xa + \pgf@y = 0pt + } + \savedanchor{\northeast}{ + \decisionrefout + \divide\pgf@xa by 2 + \divide\pgf@ya by 2 + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } + \anchor{north}{ \north } + \anchor{north east}{ \northeast } + \anchor{east}{ \east } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \north \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \east \pgf@x=-\pgf@x } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } +} +\def\terminalrefneout{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \pgf@ya + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \advance\pgf@xa\pgfshapeouterxsep + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@ya\pgfshapeouterysep + \advance\pgf@xa by -\pgf@ya +} +\def\terminalrefne{ + \pgf@xa=\ctbnex + \pgf@ya=\ctbney + \advance\pgf@xa by \pgf@ya + \mincorrect{\pgf@xa}{\pgfshapeminwidth} + \mincorrect{\pgf@ya}{\pgfshapeminheight} + \advance\pgf@xa by -\pgf@ya +} +\def\terminalpath{ + \def\refx{\pgf@xa} + \def\refy{\pgf@ya} + \def\radius{\refy} + \pgfpathmoveto{\pgfpoint{\refx}{\refy}} + \pgfpathlineto{\pgfpoint{-\refx}{\refy}} + \pgfpatharc{90}{270}{\radius} + \pgfpathlineto{\pgfpoint{\refx}{-\refy}} + \pgfpatharc{270}{360}{\radius} + \pgfpatharc{0}{90}{\radius} + \pgfpathclose +} +\def\terminalanchor{ + \terminalrefneout + \terminalpath +} +\def\terminalborder{ + \terminalrefne + \terminalpath +} +\pgfdeclareshape{terminal}{ + \setpaths{\terminalanchor}{\terminalborder} + \savedanchor{\northeast}{ + \terminalrefneout + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } + \savedanchor{\northeastBB}{ + \terminalrefneout + \advance \pgf@xa by \pgf@ya + \pgf@x = \pgf@xa + \pgf@y = \pgf@ya + } + \anchor{north}{ \northeast \pgf@x=0pt } + \anchor{north east}{ \northeast } + \anchor{east}{ \northeastBB \pgf@y=0pt } + \anchor{south east}{ \northeast \pgf@y=-\pgf@y } + \anchor{south}{ \northeast \pgf@x=0pt \pgf@y=-\pgf@y } + \anchor{south west}{ \northeast \pgf@x=-\pgf@x \pgf@y=-\pgf@y } + \anchor{west}{ \northeastBB \pgf@x=-\pgf@x \pgf@y=0pt } + \anchor{north west}{ \northeast \pgf@x=-\pgf@x } + \anchor{north east r}{\northeastBB} + \anchor{south east r}{\northeastBB \pgf@y=-\pgf@y} + \anchor{south west r}{\northeastBB \pgf@x=-\pgf@x \pgf@y=-\pgf@y} + \anchor{north west r}{\northeastBB \pgf@x=-\pgf@x} +} +\endinput +%% +%% End of file `flowchart.sty'. diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index ef88702bbcb..6f5a4c0d3cd 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -175,7 +175,7 @@ my @TLP_working = qw( fjodor flabels flacards flagderiv flashcards flashmovie flipbook flippdf float floatflt floatrow - flowfram fltpoint + flowchart flowfram fltpoint fmp fmtcount fn2end fnbreak fncychap fncylab fnpara fnpct fntproof fnumprint foekfont foilhtml fonetika diff --git a/Master/tlpkg/tlpsrc/collection-pictures.tlpsrc b/Master/tlpkg/tlpsrc/collection-pictures.tlpsrc index 5ec18a0a549..1959cfd02ad 100644 --- a/Master/tlpkg/tlpsrc/collection-pictures.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-pictures.tlpsrc @@ -27,6 +27,7 @@ depend epspdf depend epspdfconversion depend esk depend fig4latex +depend flowchart depend forest depend gincltex depend gnuplottex diff --git a/Master/tlpkg/tlpsrc/flowchart.tlpsrc b/Master/tlpkg/tlpsrc/flowchart.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d --- /dev/null +++ b/Master/tlpkg/tlpsrc/flowchart.tlpsrc |