From 3a42c1fa608c2ce1e17a6301f9f96bf20fce0a2e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 2 Oct 2019 21:19:32 +0000 Subject: pst-turtle (2oct19) git-svn-id: svn://tug.org/texlive/trunk@52261 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/pst-turtle/Changes | 10 ++ Master/texmf-dist/doc/generic/pst-turtle/README.md | 19 ++ .../doc/generic/pst-turtle/pst-turtle-doc.bib | 168 +++++++++++++++++ .../doc/generic/pst-turtle/pst-turtle-doc.pdf | Bin 0 -> 64625 bytes .../doc/generic/pst-turtle/pst-turtle-doc.tex | 200 +++++++++++++++++++++ 5 files changed, 397 insertions(+) create mode 100644 Master/texmf-dist/doc/generic/pst-turtle/Changes create mode 100644 Master/texmf-dist/doc/generic/pst-turtle/README.md create mode 100644 Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.bib create mode 100644 Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.pdf create mode 100644 Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.tex (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/generic/pst-turtle/Changes b/Master/texmf-dist/doc/generic/pst-turtle/Changes new file mode 100644 index 00000000000..c44b1dd7125 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-turtle/Changes @@ -0,0 +1,10 @@ +..... pst-turtle.tex +0.02 2019-10-02 new documentation +0.01 2019-05-17 first CTAN version + +..... pst-turtle.sty +0.01 2019-05-17 first CTAN version + + +..... pst-turtle.pro +0.01 2019-05-17 first CTAN version diff --git a/Master/texmf-dist/doc/generic/pst-turtle/README.md b/Master/texmf-dist/doc/generic/pst-turtle/README.md new file mode 100644 index 00000000000..950bb35123d --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-turtle/README.md @@ -0,0 +1,19 @@ +# pst-turtle: Turtle graphics# + +%% 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. + +Save the files pst-turtle.sty|pro|tex in a directory, which is part of your +local TeX tree. The pro file should go into $TEXMF/dvips/pstricks/ +Then do not forget to run texhash to update this tree. + +pst-turtle needs pstricks, which should +be part of your local TeX installation, otherwise get it from a +CTAN server, http://mirror.ctan.org + +PSTricks is PostScript Tricks, the documentation cannot be run +with pdftex, use the sequence latex->dvips->ps2pdf or +pdflatex with package auto-pst-pdf or xelatex. + +%% $Id: README.md 1064 2019-05-19 09:17:21Z herbert $ diff --git a/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.bib b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.bib new file mode 100644 index 00000000000..e749f71bfb1 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.bib @@ -0,0 +1,168 @@ +@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} } + +@Article{ dtk02.2:jackson.voss:plot-funktionen, + author = {Laura E. Jackson and Herbert Voß}, + title = {Die {P}lot-{F}unktionen 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ß}, + 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ß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ß}, + title = {The {\LaTeX} {G}raphics {C}ompanion}, + publisher = {{Addison-Wesley Publishing Company}}, + edition = 2, + 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 = {Post{S}cript richtig eingesetzt: vom {K}onzept zum + praktischen {E}insatz}, + Publisher = {IWT}, + Address = {Vaterstetten}, + year = 1989, +} + +@online{pstricks, + Title = {PSTricks - {\PS} macros for generic {\TeX}}, + Author = {{Timothy van} Zandt}, + Organization = {}, + url = {http://www.tug.org/application/PSTricks}, + year = 1993 +} + +@ctan{pst-plot, + Title = {\texttt{pst-plot}: Plotting two dimensional functions and data}, + Author = {{Timothy van} Zandt and Herbert Voß}, + Organization = {}, + url = {/graphics/pstricks/generic/pst-plot.tex}, + year = 1999 +} + +@ctan{multido, + Title = {\texttt{multido.tex} - a loop macro, that supports fixed-point addition}, + Author = {{Timothy van} Zandt}, + url = {/graphics/pstricks/generic/multido.tex}, + Note = {}, + year = 1997 +} + +@Book{PSTricks2, + author = {Herbert Voß}, + title = {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX}, + edition = {7}, + publisher = {DANTE -- Lehmanns}, + year = {2016}, + publisher = {Heidelberg and Berlin} +} + +@Book{voss:math, + author = {Herbert Voß}, + title = {Typesetting mathematics with \LaTeX}, + publisher = {UIT}, + year = {2010}, + address = {Cambridge} +} + +@Book{PSTricks2-UIT, + author = {Herbert Voß}, + title = {PSTricks -- Graphics for \TeX\ and \LaTeX}, + publisher = {UIT}, + year = {2011}, + address = {Cambridge} +} + +@Book{LaTeXRef-UIT, + author = {Herbert Voß}, + title = {{\LaTeX} quick reference}, + publisher = {UIT}, + year = {2012}, + address = {Cambridge} +} + +@online{wolfram, + author = {Eric Weisstein}, + title = {Wolfram MathWorld}, + publisher = {{Wolfram}}, + year = {2007}, + url = {http://mathworld.wolfram.com} +} + +@ctan{pst-tools, + author = {Herbert Voß}, + title = {\texttt{pst-tools} -- Helper functions}, + year = {2012}, + url = {/graphics/pstricks/contrib/pst-tools} +} diff --git a/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.pdf b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.pdf new file mode 100644 index 00000000000..4fcb9a2df41 Binary files /dev/null and b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.pdf differ diff --git a/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.tex b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.tex new file mode 100644 index 00000000000..ccd26f5813f --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-turtle/pst-turtle-doc.tex @@ -0,0 +1,200 @@ +%% $Id: pst-turtle-doc.tex 1093 2019-10-02 11:28:36Z herbert $ +\documentclass[fontsize=11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false, + headings=small, headinclude=false,footinclude=false,oneside]{pst-doc} +\usepackage{pst-turtle} +\let\pstTurtleFV\fileversion +\renewcommand\bgImage{} + +%\usepackage[style=dtk]{biblatex} +\addbibresource{pst-turtle-doc.bib} + +\begin{document} + +\title{\texttt{pst-turtle}} +\subtitle{Turtle graphics; v.\pstTurtleFV} +\author{Herbert Vo\ss} +\docauthor{} +\date{\today} +\maketitle + +\tableofcontents + +\clearpage + +\begin{abstract} +\noindent +\LPack{pst-turtle} loads by default the following packages: \LPack{pstricks}, +and \LPack{pst-xkey}. +All should be already part of your local \TeX\ installation. If not, or in case +of having older versions, go to \url{http://www.CTAN.org/} and load the newest version. + +\vfill\noindent +Thanks to \\ + +\end{abstract} + + +\section{Usage} + +\begin{BDef} +\Lcs{psTurtle}\OptArgs\Largr{$x_0,y_0$}\Largb{Turtle code} +\end{BDef} + +The turle commands must be in PostScript notation, where you can use the +short or long version of the commands: + +\begin{verbatim} +/bk { back } bind def +/fd { forward } bind def +/lt { left } bind def +/pd { pendown } bind def +/pu { penup } bind def +/rt { right } bind def +\end{verbatim} + +The default unit is cm. + +\bigskip +\begin{LTXexample}[width=4cm,pos=l] +\begin{pspicture}[showgrid](3,3) +\psTurtle[linewidth=2pt,arrows=->](0,0){ 3 forward } +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=4cm,pos=l] +\begin{pspicture}[showgrid](3,3) +\psTurtle[linewidth=2pt,arrows=->](0,0){ + 3 fd + 90 left 3 fd } +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=4cm,pos=l] +\begin{pspicture}[showgrid](3,3) +\psTurtle[linewidth=2pt,arrows=->](0,0){ + 3 fd + 90 left 3 fd + 90 left 3 fd + 135 left 18 sqrt fd} +\end{pspicture} +\end{LTXexample} + + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](0.8,0){ + 5 { 2.5 fd 72 left } repeat +} +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](2,1){ + 5 { 72 left 1 fd 72 right 1 fd 72 left} repeat +} +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](2,0){ + /Angle { 360 7 div } bind def + 7 { Angle left 1 fd Angle right 1 fd Angle left} repeat +} +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](2,2){ + /Angle { 360 7 div } bind def + 7 { Angle left 1 fd Angle 3 mul right 1 fd Angle left} repeat +} +\end{pspicture} +\end{LTXexample} + + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](2,1){ + /Angle 40 def + 75 { 0.25 fd Angle left /Angle Angle 0.5 sub def } repeat +} +\end{pspicture} +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=5cm,pos=l] +\begin{pspicture}[showgrid](4,4) +\psTurtle[linewidth=2pt](0,3.5){ + 5 { 3 fd 144 right } repeat +} +\end{pspicture} +\end{LTXexample} + + +\bigskip +\begin{LTXexample}[width=6cm,pos=l] +\begin{pspicture}[showgrid](5,5) +\psTurtle[linewidth=0.2pt](1,1.75){ + 75 { 3.5 fd 123 left } repeat +} +\end{pspicture} +\end{LTXexample} + + +\bigskip +\begin{LTXexample}[width=11cm,pos=l] +\begin{pspicture}[showgrid](10,10) +\psTurtle[linewidth=0.5pt](5,5){ + /L 1 def + 150 { L fd 120 left L fd 120 left L fd /L L 0.03 add def 1.25 rotate } repeat +} +\end{pspicture} +\end{LTXexample} + + + + +\iffalse +\def\a{3 } +\begin{pspicture}[showgrid](12,6) +\psset{linecolor=red,linewidth=1.5pt,unit=1cm} +\psTurtle(0,0){ + 90 left \a 1.5 mul fd 159 rt \a fd 120 lt \a fd 120 lt \a fd + pu \a bk pd -125 rt \a fd 90 lt \a fd 90 lt \a fd 90 lt \a fd + pu 90 lt \a fd 90 lt \a fd pd + -37 lt \a fd 4 { 72 lt \a fd } repeat + pu 2 { 72 lt \a fd } repeat pd + -152 lt \a fd +} +%\psdot[dotscale=3](! Turtle8) +\end{pspicture} +\fi + + + + + +%\clearpage +%\section{List of all optional arguments for \texttt{pst-turtle}} +%\xkvview{family=pst-turtle,columns={key,type,default}} + +\bgroup +\RaggedRight +\nocite{*} +%\bibliographystyle{plain} +\printbibliography{pst-turtle-doc} +\egroup + +\printindex + +\end{document} -- cgit v1.2.3