diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-poly')
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/Changes | 6 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/README | 17 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.bib | 164 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.pdf | bin | 0 -> 184120 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.tex | 621 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/pst-poly.pdf | bin | 139994 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/tst-poly.pdf | bin | 52823 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-poly/tst-poly.tex | 332 |
8 files changed, 796 insertions, 344 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-poly/Changes b/Master/texmf-dist/doc/generic/pst-poly/Changes index b36a45fafaa..353b7cf3748 100644 --- a/Master/texmf-dist/doc/generic/pst-poly/Changes +++ b/Master/texmf-dist/doc/generic/pst-poly/Changes @@ -1,5 +1,7 @@ -1.60 2004/11/20 new macro \pspolygonbox, - using pst-xkey (hv) +1.61 2009/12/20 - use \NormalCoor for IntemediatePoint setting + - allow \SpecialCoor for a length + - updated documentation +1.60 2004/11/20 new macro \pspolygonbox, using pst-xkey (hv) 1.50 2001/02/08 Standard packaging (.ins + .dtx files). 1.40 1998/07/09 Define `PolyRotation' parameter as a real number and not as an angle, to allow to use the macro diff --git a/Master/texmf-dist/doc/generic/pst-poly/README b/Master/texmf-dist/doc/generic/pst-poly/README index ce8fe97b08a..d4eccbee649 100644 --- a/Master/texmf-dist/doc/generic/pst-poly/README +++ b/Master/texmf-dist/doc/generic/pst-poly/README @@ -1,12 +1,9 @@ ---------------------------------------------------- -| pst-poly: PSTricks package for polygons | ---------------------------------------------------- +Save the files pst-poly.sty|tex in a directory, +which is part of your local TeX tree. +Then do not forget to run texhash to update this tree. -* Run "tex" on pst-poly.ins and copy pst-poly.tex and pst-poly.sty - in one of your TeX input directories +For more information see the documentation of your LaTeX distribution +on installing packages into your local TeX system or read the +TeX Frequently Asked Questions: +(http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages). -* Run "latex" on pst-poly.dtx to generate the documentation - -* This is a PSTricks (PostScript Tricks) package, which won't - run with pdftex. In this case go to http://PSTricks.de/ - for some help. diff --git a/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.bib b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.bib new file mode 100644 index 00000000000..032e9914720 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.bib @@ -0,0 +1,164 @@ +yy%% -*-bibtex-*- +@STRING{tugboat = {TUGboat} } +@STRING{beiprogramm = {{\TeX}-Beiprogramm} } +@STRING{bretter = {Bretter, die die Welt bedeuten} } +@STRING{dtk = {{D}ie {\TeX}nische {K}om{\"o}die} } +@STRING{editorial = {Editorial} } +@STRING{fremdebuehne = {Von fremden B{\"u}hnen} } +@STRING{fundus = {Aus dem Fundus} } +@STRING{hinterbuehne = {Hinter der B{\"u}hne} } +@STRING{leserbrief = {Leserbrief(e)} } +@STRING{magazin = {Magazin} } +@STRING{rezension = {Rezensionen} } +@STRING{schonimmer = {Was Sie schon immer {\"u}ber {\TeX} wissen wollten \dots} } +@STRING{theaterkasse = {Von der Theaterkasse} } +@STRING{theatertage = {{\TeX}-Theatertage} } + +@Book{PSTricks2, + author = {Herbert Vo\ss}, + title = {{\PST} {G}rafik f\"ur \TeX{} und \LaTeX}, + edition = {fifth}, + publisher = {DANTE -- Lob.media}, + year = {2008}, + address = {Heidelberg/Hamburg} +} + +@Book{companion04, + author = {Frank Mittelbach and Michel Goosens et al}, + title = {The {\LaTeX} {C}ompanion}, + edition = {second}, + publisher = {Addison-Wesley Publishing Company}, + year = {2004}, + address = {Boston} +} + +@Book{unbound, + author = {Alan Hoenig}, + title = {\TeX{} {U}nbound: \LaTeX{} \& \TeX{} {S}trategies, {F}onts, {G}raphics, and {M}ore}, + publisher = {Oxford University Press}, + year = {1998}, + address = {London} +} +@Article{ dtk02.2:jackson.voss:plot-funktionen, + author = {Laura E. Jackson and Herbert Vo{\ss}}, + title = {Die Plot-Funktionen von {\texttt{pst-plot}}}, + journal = dtk, + year = 2002, + volume = {2/02}, + altvolume = 2, + altnumber = 14, + month = jun, + pages = {27--34}, + annote = bretter, + keywords = {}, + abstract = { Im letzten Heft wurden die mathematischen Funktionen von + \PS~im Zusammenhang mit dem {\LaTeX}-Paket + \texttt{pst-plot} zum Zeichnen von Funktionen beschrieben + und durch Beispiele erl{\"a}utert. In diesem Teil werden + die bislang nur erw{\"a}hnten Plot-Funktionen f{\"u}r + externe Daten behandelt. } +} + +@Article{ dtk02.1:voss:mathematischen, + author = {Herbert Vo{\ss}}, + title = {Die mathematischen {F}unktionen von {P}ost{S}cript}, + journal = dtk, + year = 2002, + volume = {1/02}, + altvolume = 1, + altnumber = 14, + month = mar, + pages = {}, + annote = bretter, + keywords = {}, + abstract = { \PS, faktisch genauso alt wie {\TeX}, ist im + Verh{\"a}ltnis dazu allgemein noch weniger bekannt, wenn es + darum geht zu beurteilen, was es denn nun im eigentlichen + Sinne ist. Au{\ss}erdem wird h{\"a}ufig vergessen, dass + sich mit den \PS-Funktionen viele Dinge erledigen lassen, + bei denen sonst auf externe Programme zur{\"u}ckgegriffen + wird. Dies wird im Folgenden f{\"u}r die mathematischen + Funktionen im Zusammenhang mit dem Paket \texttt{pst-plot} + gezeigt. } +} + +@Book{tlgc2, + author = {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Denis Roegel and Herbert Vo{\ss}}, + title = {The {\LaTeX} {G}raphics {C}ompanion}, + publisher = {{Addison-Wesley Publishing Company}}, + edition = second, + year = {2007}, + address = {Reading, Mass.} +} + +@Article{girou:01:, + author = {Denis Girou}, + title = {Pr\'esentation de {PST}ricks}, + journal = {Cahier {GUT}enberg}, + year = 1994, + volume = {16}, + month = apr, + pages = {21-70} +} + +@Article{girou:02:, + author = {{Timothy Van} Zandt and Denis Girou}, + title = {Inside {PST}ricks}, + journal = TUGboat, + year = 1994, + volume = {15}, + month = sep, + pages = {239-246} +} + +@Book{PostScript, + Author = {Kollock, Nikolai G.}, + Title = {PostScript richtig eingesetzt: vom {K}onzept zum + praktischen {E}insatz}, + Publisher = {IWT}, + Address = {Vaterstetten}, + year = 1989, +} + +@Manual{pstricks, + Title = {PSTricks - {\PS} macros for generic {\TeX}}, + Author = {{Timothy Van} Zandt}, + Organization = {}, + Address = {\url{http://www.tug.org/application/PSTricks}}, + Note = {}, + year = 1993 +} + +@Manual{pst-plot, + Title = {\texttt{pst-plot}: Plotting two dimensional functions and data}, + Author = {{Timothy Van} Zandt}, + Organization = {}, + Address = {\url{CTAN:graphics/pstricks/generic/pst-plot.tex}}, + Note = {}, + year = 1999 +} + +@Manual{multido, + Title = {\texttt{multido.tex} - a loop macro, that supports fixed-point addition}, + Author = {{Timothy Van} Zandt}, + Organization = {}, + Address = {\url{CTAN:/graphics/pstricks/generic/multido.tex}}, + Note = {}, + year = 1997 +} + +@MISC{xkeyval, + author = {Hendri Adriaens}, + title = {xkeyval package}, + howpublished = {\url{CTAN:/macros/latex/contrib/xkeyval}}, + year = 2004 +} + +@book{voss:ref, + Title = {{\LaTeX} {Referenz}}, + Author = {Herbert Vo\ss}, + Publisher = {Lehmanns Media/DANTE}, + Edition= 2, + Address= {Berlin/Heidelberg}, + Year= {2010}, +} diff --git a/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.pdf b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.pdf Binary files differnew file mode 100644 index 00000000000..e6549533721 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.pdf diff --git a/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.tex b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.tex new file mode 100644 index 00000000000..7c27442c6d9 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-poly/pst-poly-doc.tex @@ -0,0 +1,621 @@ +\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings + headexclude,footexclude,oneside]{pst-doc} +\usepackage[utf8]{inputenc} +\usepackage{pst-poly} +\let\pstDocFV\fileversion + +\def\bgImage{\PstPolygon[unit=3,linecolor=red,PolyOffset=2,linewidth=0.001, + PolyNbSides=72,PolyEpicycloid]} + +\lstset{explpreset={pos=t,width=-99pt,overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe={}}} +\begin{document} + +\title{\texttt{pst-poly}} +\subtitle{A PSTricks package for drawing polygons; v.\pstDocFV} +\author{Denis Girou\\Herbert Vo\ss} +%\docauthor{Herbert Vo\ss} +\date{\today} +\maketitle + +\tableofcontents + +\clearpage + +\begin{abstract} +\noindent +\LPack{pst-poly} allows to draw easily various kinds of regular or non regular +polygons, using the unique macro \Lcs{PstPolygon}, with various customization +parameters. +It is also a good example of the great power and flexibility of PSTricks, +as in fact it is a very short program (it body is only 100 lines long) but +nevertheless really powerful. + And last, it is also a good pedagogical example of how to design and +program high level graphic objects above PSTricks own ones. +\end{abstract} + +\clearpage + +\section{Introduction} +% +\LPack{pst-poly} offers a unique macro (plus some aliases to define +some often used polygons) with few parameters to interact on it. But we can +also use all the relevant PSTricks parameters to change the size, the +characteristics of lines, to add filling, etc. +The polygons are always drawn counter clockwise. +% +The syntax is simply: +\begin{BDef} +\LcsStar{PstPolygon}\OptArgs\\ +\Lcs{PstTriangle}\OptArgs\\ +\Lcs{PstSquare}\OptArgs\\ +\Lcs{PstPentagon}\OptArgs\\ +\Lcs{PstHexagon}\OptArgs\\ +\Lcs{PstHeptagon}\OptArgs\\ +\Lcs{PstOctogon}\OptArgs\\ +\Lcs{PstNonagon}\OptArgs\\ +\Lcs{PstDecagon}\OptArgs\\ +\Lcs{PstDodecagon}\OptArgs\\% +\Lcs{PstStarFiveLines}\OptArgs\\ +\Lcs{PstStarFive}\OptArgs\\ +\Lcs{pspolygonbox}\OptArgs\Largb{Text}\\ +\end{BDef} + +As for PSTricks closed objects, the \texttt{*} version uses a solid style +to fill the polygon, use the line color for fill color and set the linewidth +to 0. + +By default the polygons are set with a radius of 1 unit for the outer circle. + +\bigskip +\begin{LTXexample}[pos=l,width=0.3\linewidth] +\begin{pspicture}[showgrid=true](-1,-1)(1,1) + \PstPolygon[PstPicture=false] + \pscircle[linestyle=dashed]{1} +\end{pspicture} +\end{LTXexample} + +There is no special optional argument for this radius, the polygon can +be scaled by using the key \Lkeyword{unit}. With \Lkeyword{unit}=1.5, the outer +radius will be of 1.5cm when the current unit is set to 1cm. + + +\section{Optional arguments} +% +There are eight specific optional arguments defined to change the way the +polygons are defined: + +\begin{compactdesc} + \item [\Lkeyword{PstPicture}] (boolean): to define or not a \Lenv{pspicture} + environment for the polygon. We have to define this parameter to + \false\ if we want to mix the polygon with other PSTricks objects + --- see examples later + (\emph{Default:~\true} --- which is not the case for basic PSTricks + objects). With \Lkeyset{PstPicture=false} the image doesn't reserve + any space, it overwrites the text. The resulting box has a width and a height of 0pt. + +\bigskip +\begin{LTXexample}[pos=t] + foo\PstPolygon bar\hfill foo\PstPolygon[PstPicture=false] bar +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyRotation}] (real): rotation angle applied to the polygon + (\emph{Default:~0} --- no rotation). + +\bigskip +\begin{LTXexample}[pos=t] + \PstPolygon\hfill + \PstPolygon[PolyRotation=18]\hfill + \PstPolygon[PolyRotation=36]\hfill + \PstPolygon[PolyRotation=45] +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyNbSides}] (integer): number of sides of the polygon + (\emph{Default:~5}). + +\bigskip +\begin{LTXexample}[pos=t] + \PstPolygon\hfill + \PstPolygon[PolyNbSides=3]\hfill + \PstPolygon[PolyNbSides=4]\hfill + \PstPolygon[PolyNbSides=5]\hfill + \PstPolygon[PolyNbSides=8]\hfill + \PstPolygon[PolyNbSides=50] +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyOffset}] (integer): number of nodes to bypass to obtain each + time the next one (\emph{Default:~1} --- no node bypassed). + +\bigskip +\begin{LTXexample}[pos=t] + \PstPolygon + \PstPolygon[PolyOffset=2] + \PstPolygon[PolyOffset=3] + \PstPolygon[PolyNbSides=7,PolyOffset=2] + \PstPolygon[PolyNbSides=9,PolyOffset=4] + \PstPolygon[PolyNbSides=17,PolyOffset=6] +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyIntermediatePoint}] (real): position of the intermediate point + used to join each time the next node (\emph{Default:~empty} --- not used). + +\bigskip +\begin{LTXexample}[pos=t] + \PstPolygon + \PstPolygon[PolyIntermediatePoint=0.38] + \PstPolygon[PolyIntermediatePoint=0.2] + \PstPolygon[PolyIntermediatePoint=1.2] + \PstPolygon[PolyNbSides=7,PolyOffset=2, + PolyIntermediatePoint=0.38] + \PstPolygon[PolyNbSides=21,PolyOffset=2, + PolyIntermediatePoint=-1.25] +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyCurves}] (boolean): boolean value to choose between straight + line and curve to join each time the next node (\emph{Default:~\false} --- straight lines). + +\bigskip +\begin{LTXexample}[pos=t] + \psset{PolyCurves=true} + \PstPolygon[PolyNbSides=7,PolyIntermediatePoint=0.38]\hfill + \PstPolygon[PolyNbSides=11,PolyIntermediatePoint=0.6]\hfill + \PstPolygon[PolyNbSides=7,PolyIntermediatePoint=0.2, + PolyOffset=2]\hfill + \PstPolygon[PolyNbSides=9,PolyIntermediatePoint=0.1]\hfill + \PstPolygon[PolyNbSides=15,PolyIntermediatePoint=1.2] +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyEpicycloid}] (boolean): boolean value to choose between + polygon and epicycloid (\emph{Default:~\false} --- polygon). + +\bigskip +\begin{LTXexample}[pos=t] + \psset{linewidth=0.001,PolyNbSides=72,PolyEpicycloid=true} +% Epicycloid of factor 1 is cardioid and of factor 2 nephroid + \multido{\i=2+1}{4}{\PstPolygon[PolyOffset=\i]\hfill} + \PstPolygon[PolyOffset=72]\hfill% Epicycloid of factor 71 + \PstPolygon[PolyOffset=73] % Epicycloid of factor 72 +\end{LTXexample} + +\bigskip + \item [\Lkeyword{PolyName}] (string): name of the polygon, useful to have different + names for the nodes of different polygons (\emph{Default:~empty} --- no name). + + The center of the polygon has name \texttt{PolyName0} and the nodes +(vertices) have names \texttt{PolyName1} to \texttt{PolyNameN}. + With this parameter, we can connect as we want nodes of different polygons: + +\bigskip +\begin{LTXexample}[pos=l,width=0.3\linewidth,pos=l] + \psset{PstPicture=false} + \begin{pspicture}(-1,-1)(1,1) + \PstPolygon[unit=0.8,PolyName=A,PolyNbSides=6] + \PstPolygon[unit=1.2,PolyName=B,PolyNbSides=12] + \end{pspicture} + \multido{\i=1+2}{6}{% + \ncline{A\the\multidocount}{B\i}} +\end{LTXexample} + +It is also a way (limited in fact...) to define three dimensional objects in perspective: + +\bigskip +\begin{LTXexample}[pos=l,width=0.3\linewidth,pos=l] +\psset{unit=0.8} +\begin{pspicture}(3,2.5) +% \PstSquare is described later + \rput[lb](0,0){\PstSquare[PolyName=A]} + \rput[lb](2.5,2){\PstSquare[unit=0.5,PolyName=B]} + \multido{\i=1+1}{4}{\ncline{A\i}{B\i}} + \end{pspicture} +\end{LTXexample} + +\end{compactdesc} + +\bigskip + Of course, we can mix specific parameters of \LPack{pst-poly} with +relevant PSTricks ones and combine it with other generic macros +(for repetitions, projection in the 3d space, etc.) + + +\begin{LTXexample}[pos=t] + \PstPolygon[unit=1.5] + \PstPolygon[linewidth=1mm] + \PstPolygon[fillstyle=crosshatch,PolyNbSides=6] + \PstPolygon[linecolor=red,fillstyle=solid,fillcolor=yellow, + PolyRotation=18,PolyOffset=2] + \PstPolygon*[linecolor=cyan,PolyNbSides=7,PolyOffset=2] +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+2}{6}{% + \PstPolygon[PolyNbSides=\i,PolyCurves=true, + PolyIntermediatePoint=0.1,PolyOffset=3]} +\end{LTXexample} + + +\section{Pre-defined polygons} +% + Some often used polygons and other related geometric objects are +pre-defined, for immediate usage : + +\begin{LTXexample}[pos=t] + \PstTriangle + \PstSquare + \PstPentagon[unit=0.5,linestyle=dotted] + \PstHexagon[fillstyle=hlines,hatchangle=90] + \PstHeptagon[fillstyle=vlines] + \PstOctogon*[unit=0.8,linecolor=red] + \PstNonagon[unit=0.5] + \PstDecagon + \PstDodecagon[linecolor=green] \par + \PstStarFiveLines + \PstStarFive +\end{LTXexample} + + +\section{Non regular polygons} + +Until now, we have described only the so-called \emph{regular} polygons, +which are from far the most useful ones (all of them have equal edges and +angles). Nevertheless, it is not so difficult to extend these polygon to +\emph{non regular} ones, using a different value for horizontal and vertical +units (nevertheless, the code is more tricky, as we must do all the +trigonometry explicitely...) +% +\begin{LTXexample}[pos=t] + \PstPentagon[xunit=0.5]\hfill + \PstHexagon[yunit=0.5]\hfill + \PstStarFive[xunit=0.5,yunit=1.5]\hfill + \PstPolygon[xunit=0.8,yunit=1.5,PolyNbSides=9,PolyOffset=2, + PolyIntermediatePoint=0.1,PolyCurves=true] +\end{LTXexample} +% +\section{Nodes (vertices)} +% +And another powerful possibility is to define a command +\Lcs{PstPolygonNode} which will be excuted at each node (\emph{Default:~empty} --- nothing executed). +The counter name for nodes is \Lctr{INode}, starting from 0. The \Lcs{multidocount} counter, from the +\Lcs{multido} command, start itself from 1. + +\begin{LTXexample}[width=0.3\linewidth,pos=l] + \providecommand{\PstPolygonNode}{% + \psdots[dotsize=0.2,linecolor=cyan](1;\INode)} + \PstPentagon +\end{LTXexample} +% +\begin{LTXexample}[width=0.3\linewidth,pos=l] + \newcounter{Letter} + \providecommand{\PstPolygonNode}{% + \setcounter{Letter}{\the\multidocount}% + \rput*{*0}(1;\INode){\small\Alph{Letter}}} + \PstHeptagon[PolyOffset=3] +\end{LTXexample} +% +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \psdots[dotstyle=o,dotsize=0.2](1;\INode) + \psline[linecolor=red]{->}(0.9;\INode)} + \PstPolygon[PolyNbSides=8] +\end{LTXexample} +% +\vspace{3mm} + It is also a way to nest polygons: +\vspace{3mm} +% +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \newbox{\Star} + \savebox{\Star}{% + \PstStarFive*[unit=0.15,linecolor=red]} + \providecommand{\PstPolygonNode}{% + \rput{*0}(1;\INode){\usebox{\Star}}} + \shortstack{\PstNonagon\\[5mm] + \PstDodecagon[linestyle=none]} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \psset{unit=2,PstPicture=false} + \begin{pspicture}(-1.6,-1.6)(1.6,1.6) +% Just to name the nodes, to be able to join some of them. +% by solid curves. We can't draw the polygons now, +% as the node numbers must erase the solid curves... + \PstHexagon[unit=0.8,linestyle=none,PolyName=H]\PstDodecagon[unit=1.2,linestyle=none,PolyName=D] + {\SpecialCoor + \psset{linewidth=0.4pt,border=2pt,nodesep=0.45} + \psccurve(H1)(H4)(D8)([angle=-30]D9)(D11)\psccurve(D3)(H3)(H6)(D12)([angle=90]D1) + \psccurve(D4)(H2)(H5)(D7)([angle=90]D6)} + \psset{linestyle=dotted,framesep=1pt} + \PstTriangle[unit=0.23] + \providecommand{\PstPolygonNode}{\rput*{*0}(1;\INode){\small\the\multidocount}} + \PstHexagon[unit=0.8] \PstDodecagon[unit=1.2] \PstDodecagon[unit=1.6] + \end{pspicture} +\end{LTXexample} +% +\section{Polygonbox} + +The valid options with the predefined values are \Lkeyword{PolyNbSides}=3 and \Lkeyword{PolyRotation}=0 + +\begin{compactitem} +\item There maybe some problems with linearcs and rounding errors. +\item To rotate the text inside the box, one can use the \Lcs{rotatebox} macro from + the \LPack{rotating} package (see examples). +\end{compactitem} + +\begin{LTXexample}[pos=t] + \multido{\nA=3+1}{8}{% + \pspolygonbox[PolyNbSides=\nA,framesep=3mm]{Text}~} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\nA=3+1}{8}{\pspolygonbox[PolyNbSides=\nA,% + framesep=2mm,doubleline=true]{Text}~} +\end{LTXexample} + + +\begin{LTXexample}[pos=t] + \psset{PolyNbSides=4} + \multido{\nA=0+60}{8}{\pspolygonbox[PolyRotation=\nA,% + framesep=2mm,doubleline=true,% + linecolor=red,doublecolor=blue]{\magenta Text}~} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\nA=0+60,\nB=45+60}{8}{\pspolygonbox% + [PolyRotation=\nA,framesep=2mm,doubleline=true,% + linecolor=red,doublecolor=blue,linearc=0.4]% + {\rotatebox{\nB}{\blue Text}}~}\\[1cm] +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\nA=3+1}{8}{% + \pspolygonbox[PolyNbSides=\nA,rot=60,framesep=2pt,% + doubleline=true,linearc=0.2]{Text}~} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\nA=3+1}{8}{% + \pspolygonbox[PolyNbSides=\nA,framesep=10pt,% + fillstyle=solid,fillcolor=cyan,linearc=0.2]{Text}~} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\nA=-5+5}{8}{\pspolygonbox[framesep=\nA pt,% + PolyRotation=90]{\Huge\red T}~} +\end{LTXexample} + +\vspace{1cm} +\begin{LTXexample}[pos=t] + \multido{\nA=-5+5}{7}{\pspolygonbox[framesep=\nA pt,% + PolyRotation=90,boxsep=false]{\Huge\red T}~}\par + \rule{0pt}{1cm} +\end{LTXexample} + +\section{Some more examples} + +\begin{LTXexample}[pos=t] + \multido{\i=3+1}{6}{% + \PstPolygon[PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=3+2}{6}{% + \PstPolygon[PolyOffset=2,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=3+1}{10}{% + \PstPolygon[PolyOffset=3,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+1}{10}{% + \PstPolygon[PolyOffset=4,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+2}{10}{% + \PstPolygon[PolyOffset=5,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+2}{10}{% + \PstPolygon[PolyOffset=7,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+2}{10}{% + \PstPolygon[PolyOffset=8,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=1+1}{10}{% + \PstPolygon[PolyOffset=\i,PolyNbSides=5]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=1+1}{10}{% + \PstPolygon[PolyOffset=\i,PolyNbSides=7]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+1}{10}{% + \PstPolygon[PolyCurves,PolyIntermediatePoint=0.1,PolyNbSides=\i] + \hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+1}{10}{% + \PstPolygon[PolyCurves,PolyIntermediatePoint=0.2, + PolyOffset=2,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\i=5+2}{10}{% + \PstPolygon[PolyCurves,PolyIntermediatePoint=0.1, + PolyOffset=3,PolyNbSides=\i]\hspace{5mm}} +\end{LTXexample} + +% Second serie + +\begin{LTXexample}[pos=t] + \multido{\n=-1.4+0.5}{10}{% + \PstPolygon[PolyNbSides=3,PolyOffset=2,PolyIntermediatePoint=\n] + \hspace{5mm}}\par + \vspace{0pt}{2cm} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\n=-1.4+0.5}{6}{% + \PstPolygon[PolyNbSides=5,PolyOffset=2,PolyIntermediatePoint=\n] + \hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\n=-1.4+0.5}{6}{% + \PstPolygon[PolyNbSides=13,PolyOffset=2,PolyIntermediatePoint=\n] + \hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \multido{\n=-1.4+0.5}{6}{% + \PstPolygon[PolyNbSides=21,PolyOffset=2,PolyIntermediatePoint=\n] + \hspace{5mm}} +\end{LTXexample} + +% Third serie + +\begin{LTXexample}[pos=t] + \psset{unit=1.4,linewidth=0.001,PolyNbSides=72,PolyEpicycloid} + \multido{\i=2+1}{4}{% + % Epicycloid of factor 1 is cardioid and of factor 2 nephroid + \PstPolygon[PolyOffset=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + % Epicycloid of factor 10 + \PstPolygon[unit=2,linewidth=0.003, + PolyEpicycloid,PolyNbSides=72,PolyOffset=11] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + % Epicycloid of factor 22 + \PstPolygon[unit=2,linewidth=0.003, + PolyEpicycloid,PolyNbSides=72,PolyOffset=23] +\end{LTXexample} + +\begin{LTXexample}[pos=t] + \psset{unit=1.9,linewidth=0.001,PolyNbSides=72,PolyEpicycloid} + \multido{\i=71+1}{3}{% + \PstPolygon[PolyOffset=\i]\hspace{5mm}} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + % Epicycloid of factor 100 + \PstPolygon[unit=2,linewidth=0.003, + PolyEpicycloid,PolyNbSides=72,PolyOffset=101] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + % Epicycloid of factor 153 + \PstPolygon[unit=2,linewidth=0.003, + PolyEpicycloid,PolyNbSides=72,PolyOffset=154] +\end{LTXexample} + +% Fourth serie + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \psdots[dotsize=0.2,linecolor=cyan](1;\INode)} + \PstPentagon[unit=2] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \rput{*0}(1.2;\INode){\small\the\multidocount}} + \PstPolygon[unit=2,PolyNbSides=7,PolyOffset=2] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \rput*{*0}(1;\INode){\small\the\multidocount}} + \PstHeptagon[unit=2,PolyOffset=2] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] +% \newcounter{Letter} + \providecommand{\PstPolygonNode}{% + \setcounter{Letter}{\the\multidocount}% + \rput*{*0}(1;\INode){\small\Alph{Letter}}} + \PstHeptagon[unit=2,PolyOffset=3] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \SpecialCoor + \degrees[3] + \rput{0.5}(0.5;\INode){% + \pspolygon*(0.5;0.5)(0.5;1.5)(0.5;2.5)}} + \PstTriangle +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \psdots[dotstyle=o,dotsize=0.2](1;\INode) + \psline[linecolor=red]{->}(0.9;\INode)} + \PstPolygon[unit=2,PolyNbSides=8] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \providecommand{\PstPolygonNode}{% + \psline[linewidth=0.1mm,doubleline=true, + linecolor=green]{<->}(0;0)(1;\INode)} + \PstHexagon[unit=2] +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=0.3\linewidth] + \newbox{\Star} + \savebox{\Star}{% + \PstStarFive*[unit=0.15,linecolor=red]} + \providecommand{\PstPolygonNode}{% + \rput{*0}(1;\INode){\usebox{\Star}}} + \shortstack{% + \PstNonagon\\[5mm] + \PstDodecagon[linestyle=none]} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=5cm] +%\newcounter{Letter}% if not defined +\setcounter{Letter}{\the\multidocount}% +\begin{pspicture}(-2.5,-2.5)(2.5,2.5) +\PstPolygon[PolyName=A,fillstyle=solid,fillcolor=lightgray,linewidth=2pt,PolyNbSides=5,unit=0.5,PstPicture=false] +\PstPolygon[PolyName=B,PolyNbSides=5,linewidth=2pt,PstPicture=false,unit=2.5] +\multido{\iA=1+1,\iB=2+1}{5}{% + \setcounter{Letter}{\the\multidocount}% + \ncline{A\iA}{B\iA}\ncput*{\bf\alph{Letter}}% + \ifnum\iB>5 \def\iB{1}\fi% + \pcline[linestyle=none](B\iA)(B\iB)\ncput*{\bf\iA}} +\end{pspicture} +\end{LTXexample} + +\clearpage +\section{List of all optional arguments for \texttt{pst-poly}} + +\xkvview{family=pst-poly,columns={key,type,default}} + + +\nocite{*} +\bgroup +\RaggedRight +\bibliographystyle{plain} +\bibliography{pst-poly-doc} +\egroup + +\printindex + +\end{document} + + diff --git a/Master/texmf-dist/doc/generic/pst-poly/pst-poly.pdf b/Master/texmf-dist/doc/generic/pst-poly/pst-poly.pdf Binary files differdeleted file mode 100644 index 2fb8ab805d9..00000000000 --- a/Master/texmf-dist/doc/generic/pst-poly/pst-poly.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/generic/pst-poly/tst-poly.pdf b/Master/texmf-dist/doc/generic/pst-poly/tst-poly.pdf Binary files differdeleted file mode 100644 index 347fffd9ff8..00000000000 --- a/Master/texmf-dist/doc/generic/pst-poly/tst-poly.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/generic/pst-poly/tst-poly.tex b/Master/texmf-dist/doc/generic/pst-poly/tst-poly.tex deleted file mode 100644 index a48032e31c0..00000000000 --- a/Master/texmf-dist/doc/generic/pst-poly/tst-poly.tex +++ /dev/null @@ -1,332 +0,0 @@ -%% -%% This is file `tst-poly.tex', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% pst-poly.dtx (with options: `tst-poly') -%% -%% IMPORTANT NOTICE: -%% -%% For the copyright see the source file. -%% -%% Any modified versions of this file must be renamed -%% with new filenames distinct from tst-poly.tex. -%% -%% For distribution of the original source see the terms -%% for copying and modification in the file pst-poly.dtx. -%% -%% This generated file may be distributed as long as the -%% original source files, as listed above, are part of the -%% same distribution. (The sources need not necessarily be -%% in the same archive or directory.) -%% -%% Package `pst-poly.dtx' -%% -%% Denis Girou (CNRS/IDRIS - France) <Denis.Girou@idris.fr> -%% Herbert Voss <voss _at_ pstricks.de> -%% -%% Novermber 20, 2004 -%% -%% This program can be redistributed and/or modified under the terms -%% of the LaTeX Project Public License Distributed from CTAN archives -%% in directory macros/latex/base/lppl.txt. -%% -%% DESCRIPTION: -%% `pst-poly' is a PSTricks package to draw easily various kinds of regular -%% or non regular polygons, with various customizations. -%% -%% `pst-poly' test file. -%% -\documentclass{article} - -\usepackage{fancyvrb} -\usepackage[width=18cm]{geometry} -\usepackage{pstricks} -\usepackage{pst-poly} - - -\makeatletter - - -\def\HLEmphasize#1{\textit{#1}} -\newcommand{\BS}{\texttt{\symbol{`\\}}} -\def\HLMacro#1{\BS{}def\HLMacro@i#1\@nil} -\def\HLMacro@i#1def#2\@nil{\HLReverse{#2}} -\def\HLReverse#1{{\setlength{\fboxsep}{1pt}\HLReverse@i{#1}}} -\def\HLReverse@i#1{\colorbox{black}{\textcolor{white}{\textbf{#1}}}} - -\def\Example{\FV@Environment{}{Example}} -\def\endExample{% -\end{VerbatimOut} -\Below@Example{\jobname.tmp} -\endgroup} - -\def\CenterExample{\FV@Environment{}{Example}} -\def\endCenterExample{% -\end{VerbatimOut} -\begin{center} -\Below@Example{\jobname.tmp} -\end{center} -\endgroup} - -\def\SideBySideExample{\FV@Environment{}{Example}} -\def\endSideBySideExample{% -\end{VerbatimOut} -\SideBySide@Example{\jobname.tmp} -\endgroup} - -\def\FVB@Example{% -\begingroup -\FV@UseKeyValues -\parindent=0pt -\multiply\topsep by 2 -\VerbatimEnvironment -\begin{VerbatimOut}[gobble=2,codes={\catcode`\Z=12}]{\jobname.tmp}} - -\def\Below@Example#1{% -\VerbatimInput[commentchar=Z,commandchars=/?_,frame=single, - numbers=left,numbersep=3pt]{#1} -\catcode`\%=14\relax -\catcode`\Z=9\relax -\catcode`/=0\relax -\catcode`?=1\relax -\catcode`_=2\relax -\def\HLEmphasize##1{##1}% -\def\HLMacro##1{##1}% -\def\HLReverse##1{##1}% -\input{#1}\par} - -\def\SideBySide@Example#1{% -\vskip 1mm -\@tempdimb=\FV@XRightMargin -\advance\@tempdimb -5mm -\begin{minipage}[c]{\@tempdimb} - \fvset{xrightmargin=0pt} - \catcode`\%=14\relax - \catcode`\Z=9\relax - % We suppress the effect of the highlighting macros - \catcode`/=0\relax - \catcode`?=1\relax - \catcode`_=2\relax - \def\HLEmphasize##1{##1}% - \def\HLMacro##1{##1}% - \def\HLReverse##1{##1}% - \input{#1} -\end{minipage}% -\@tempdimb=\textwidth -\advance\@tempdimb -\FV@XRightMargin -\advance\@tempdimb 5mm -\begin{minipage}[c]{\@tempdimb} - \VerbatimInput[commentchar=Z,commandchars=/?_, - frame=single,numbers=left,numbersep=3pt, - xleftmargin=5mm,xrightmargin=0pt]{#1} -\end{minipage} -\vskip 1mm} - -\makeatother - - -\begin{document} - - -\begin{CenterExample} - \multido{\i=3+1}{6}{% - \PstPolygon[PolyNbSides=\i]\hspace{5mm}} - \PstPolygon[PolyNbSides=30] -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=3+2}{6}{% - \PstPolygon[PolyOffset=2,PolyNbSides=\i]\hspace{5mm}} - \PstPolygon[PolyOffset=2,PolyNbSides=31] -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=3+1}{7}{% - \PstPolygon[PolyOffset=3,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=5+1}{7}{% - \PstPolygon[PolyOffset=4,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=5+2}{7}{% - \PstPolygon[PolyOffset=5,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\clearpage -\begin{CenterExample} - \multido{\i=5+2}{7}{% - \PstPolygon[PolyOffset=7,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=5+2}{7}{% - \PstPolygon[PolyOffset=8,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=1+1}{7}{% - \PstPolygon[PolyOffset=\i,PolyNbSides=5]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=1+1}{7}{% - \PstPolygon[PolyOffset=\i,PolyNbSides=7]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=5+1}{7}{% - \PstPolygon[PolyCurves,PolyIntermediatePoint=0.1,PolyNbSides=\i] - \hspace{5mm}} -\end{CenterExample} - -\clearpage -\begin{CenterExample} - \multido{\i=5+1}{7}{% - \PstPolygon[PolyCurves,PolyIntermediatePoint=0.2, - PolyOffset=2,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\i=5+2}{7}{% - \PstPolygon[PolyCurves,PolyIntermediatePoint=0.1, - PolyOffset=3,PolyNbSides=\i]\hspace{5mm}} -\end{CenterExample} - - -\begin{CenterExample} - \multido{\n=-1.4+0.5}{7}{% - \PstPolygon[PolyNbSides=3,PolyOffset=2,PolyIntermediatePoint=\n] - \hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\n=-1.4+0.5}{7}{% - \PstPolygon[PolyNbSides=5,PolyOffset=2,PolyIntermediatePoint=\n] - \hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\n=-1.4+0.5}{7}{% - \PstPolygon[PolyNbSides=13,PolyOffset=2,PolyIntermediatePoint=\n] - \hspace{5mm}} -\end{CenterExample} - -\begin{CenterExample} - \multido{\n=-1.4+0.5}{7}{% - \PstPolygon[PolyNbSides=21,PolyOffset=2,PolyIntermediatePoint=\n] - \hspace{5mm}} -\end{CenterExample} - - -\begin{CenterExample} - \psset{unit=1.4,linewidth=0.001,PolyNbSides=72,PolyEpicycloid} - \multido{\i=2+1}{4}{% - % Epicycloid of factor 1 is cardioid and of factor 2 nephroid - \PstPolygon[PolyOffset=\i]\hspace{5mm}} -\end{CenterExample} - -\begin{SideBySideExample}[xrightmargin=5cm] - % Epicycloid of factor 10 - \PstPolygon[unit=2,linewidth=0.003, - PolyEpicycloid,PolyNbSides=72,PolyOffset=11] -\end{SideBySideExample} - -\begin{SideBySideExample}[xrightmargin=5cm] - % Epicycloid of factor 22 - \PstPolygon[unit=2,linewidth=0.003, - PolyEpicycloid,PolyNbSides=72,PolyOffset=23] -\end{SideBySideExample} - -\clearpage -\begin{CenterExample} - \psset{unit=1.9,linewidth=0.001,PolyNbSides=72,PolyEpicycloid} - \multido{\i=71+1}{3}{% - \PstPolygon[PolyOffset=\i]\hspace{5mm}} -\end{CenterExample} - -\fvset{xrightmargin=5cm} % 5cm reserved for the graphic - -\begin{SideBySideExample} - % Epicycloid of factor 100 - \PstPolygon[unit=2,linewidth=0.003, - PolyEpicycloid,PolyNbSides=72,PolyOffset=101] -\end{SideBySideExample} - -\begin{SideBySideExample}[xrightmargin=5cm] - % Epicycloid of factor 153 - \PstPolygon[unit=2,linewidth=0.003, - PolyEpicycloid,PolyNbSides=72,PolyOffset=154] -\end{SideBySideExample} - -\clearpage - - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \psdots[dotsize=0.2,linecolor=cyan](1;\INode)} - \PstPentagon[unit=2] -\end{SideBySideExample} - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \rput{*0}(1.2;\INode){\small\the\multidocount}} - \PstPolygon[unit=2,PolyNbSides=7,PolyOffset=2] -\end{SideBySideExample} - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \rput*{*0}(1;\INode){\small\the\multidocount}} - \PstHeptagon[unit=2,PolyOffset=2] -\end{SideBySideExample} - -\begin{SideBySideExample} - \newcounter{Letter} - \providecommand{\PstPolygonNode}{% - \setcounter{Letter}{\the\multidocount}% - \rput*{*0}(1;\INode){\small\Alph{Letter}}} - \PstHeptagon[unit=2,PolyOffset=3] -\end{SideBySideExample} - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \SpecialCoor - \degrees[3] - \rput{0.5}(0.5;\INode){% - \pspolygon*(0.5;0.5)(0.5;1.5)(0.5;2.5)}} - \PstTriangle -\end{SideBySideExample} - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \psdots[dotstyle=o,dotsize=0.2](1;\INode) - \psline[linecolor=red]{->}(0.9;\INode)} - \PstPolygon[unit=2,PolyNbSides=8] -\end{SideBySideExample} - -\begin{SideBySideExample} - \providecommand{\PstPolygonNode}{% - \psline[linewidth=0.1mm,doubleline=true, - linecolor=green]{<->}(0;0)(1;\INode)} - \PstHexagon[unit=2] -\end{SideBySideExample} - -\begin{SideBySideExample} - \newbox{\Star} - \savebox{\Star}{% - \PstStarFive*[unit=0.15,linecolor=red]} - \providecommand{\PstPolygonNode}{% - \rput{*0}(1;\INode){\usebox{\Star}}} - \shortstack{% - \PstNonagon\\[5mm] - \PstDodecagon[linestyle=none]} -\end{SideBySideExample} - -\end{document} -\endinput -%% -%% End of file `tst-poly.tex'. |