From 6b6e76c3af4749246c999e2c6c6166a437c5d9cb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 13 Nov 2009 14:30:47 +0000 Subject: new pstricks package pst-knot 0.2 (12nov09) git-svn-id: svn://tug.org/texlive/trunk@16000 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/pst-knot/Changes | 10 ++ Master/texmf-dist/doc/generic/pst-knot/README | 12 ++ .../doc/generic/pst-knot/pst-knot-doc.bib | 141 ++++++++++++++++++++ .../doc/generic/pst-knot/pst-knot-doc.pdf | Bin 0 -> 66578 bytes .../doc/generic/pst-knot/pst-knot-doc.tex | 148 +++++++++++++++++++++ 5 files changed, 311 insertions(+) create mode 100644 Master/texmf-dist/doc/generic/pst-knot/Changes create mode 100644 Master/texmf-dist/doc/generic/pst-knot/README create mode 100644 Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.bib create mode 100644 Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.pdf create mode 100644 Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.tex (limited to 'Master/texmf-dist/doc/generic/pst-knot') diff --git a/Master/texmf-dist/doc/generic/pst-knot/Changes b/Master/texmf-dist/doc/generic/pst-knot/Changes new file mode 100644 index 00000000000..c3b8c07cf62 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-knot/Changes @@ -0,0 +1,10 @@ +..... pst-knot.tex +0.01 2009-11-07 initial version + +..... pst-knot.pro +0.01 2009-11-07 initial version + +..... pst-fun.sty + 2009-11-07 first version + + diff --git a/Master/texmf-dist/doc/generic/pst-knot/README b/Master/texmf-dist/doc/generic/pst-knot/README new file mode 100644 index 00000000000..bdb06be8c2c --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-knot/README @@ -0,0 +1,12 @@ +pst-knot: plotting special knots + +Save the files pst-knot.sty|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. +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). + +PSTricks is PostScript Tricks, the documentation cannot be run +with pdftex, use the sequence latex->dvips->ps2pdf. \ No newline at end of file diff --git a/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.bib b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.bib new file mode 100644 index 00000000000..aa2a55a632f --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.bib @@ -0,0 +1,141 @@ +%% -*-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} } + +@Article{ dtk02.2:jackson.voss:plot-funktionen, + author = {Laura E. Jackson and Herbert Vo{\ss}}, + 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{\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{companion, + 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 = 2, + year = {2007}, + address = {Reading, Mass.} +} + +@Book{PSTricks2, + author = {Herbert Vo\ss}, + title = {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX}, + edition = {4.}, + publisher = {DANTE -- Lehmanns}, + year = {2007}, + address = {Heidelberg/Hamburg} +} + +@Book{LaTeXRef, + author = {Herbert Vo\ss}, + title = {\LaTeX\ Referenz}, + edition = {1.}, + publisher = {DANTE -- Lehmanns}, + year = {2007}, + address = {Heidelberg/Hamburg} +} +@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, +} + +@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 +} + diff --git a/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.pdf b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.pdf new file mode 100644 index 00000000000..252505e68a8 Binary files /dev/null and b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.pdf differ diff --git a/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.tex b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.tex new file mode 100644 index 00000000000..3a96773f79d --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-knot/pst-knot-doc.tex @@ -0,0 +1,148 @@ +%% $Id: pst-knot-doc.tex 137 2009-10-08 18:15:14Z herbert $ +\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false, + smallheadings, headexclude,footexclude,oneside]{pst-doc} +\usepackage[utf8]{inputenc} +\usepackage{pst-knot} +\let\pstKnotFV\fileversion +\renewcommand\bgImage{% +\begin{pspicture}(-2,-2)(2,2) + \psKnot[knotscale=2,linewidth=5pt,linecolor=blue](0,0){5-1} +\end{pspicture} +} +\lstset{pos=t,wide=false,language=PSTricks, + morekeywords={psKnot},basicstyle=\footnotesize\ttfamily} +% +\begin{document} + +\title{\texttt{pst-knot}} +\subtitle{Plotting special knots; v.\pstKnotFV} +\author{Herbert Vo\ss} +\docauthor{} +\date{\today} +\maketitle + +\tableofcontents + +\section{introduction} +This is the very first try of drawing knots. The package uses the \PS\ +subroutines from the file \LFile{psMath.pro} from Matthias Buch-Kromann.) +Currentlx there is only one macro with two mandatory arguments, the origin +of the image and the knot type. The following list shows all available knot types. + +\begin{BDef} +\Lcs{psKnot}\OptArgs\Largr{\CAny}\Largb{knot type} +\end{BDef} + + +\begin{LTXexample} +\begin{pspicture}[showgrid=true](-2,-2)(2,2) + \psKnot[linewidth=3pt,linecolor=red](0,0){0-1} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=t] +\begin{pspicture}[showgrid=true](-2,-2)(8,2) + \psKnot[linewidth=3pt,linecolor=red](0,0){3-1} + \psKnot[linewidth=3pt,linecolor=blue](4,0){4-1} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=t] +\begin{pspicture}(-2,-2)(8,2) + \psKnot[linewidth=3pt,linecolor=blue](0,0){5-1} + \psKnot[linewidth=3pt,linecolor=blue](4,0){5-2} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=t] +\begin{pspicture}(-2,-2)(10,2) + \psKnot[linewidth=3pt,linecolor=blue](0,0){6-1} + \psKnot[linewidth=3pt,linecolor=blue](4,0){6-2} + \psKnot[linewidth=3pt,linecolor=blue](8,0){6-3} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample} +\begin{pspicture}(-2,-2)(10,2) + \psKnot[linewidth=3pt,linecolor=red](0,0){7-1} + \psKnot[linewidth=3pt,linecolor=blue](4,0){7-2} + \psKnot[linewidth=3pt,linecolor=green](8,0){7-3} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample} +\begin{pspicture}(-2,-2)(10,2) + \psKnot[linewidth=3pt,linecolor=red](0,0){7-4} + \psKnot[linewidth=3pt,linecolor=green](4,0){7-5} + \psKnot[linewidth=3pt,linecolor=blue](8,0){7-6} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample} +\begin{pspicture}[showgrid=true](-2,-2)(2,2) + \psKnot[linewidth=3pt,linecolor=blue](0,0){7-7} +\end{pspicture} +\end{LTXexample} + +\section{Special settings} +There exists three special optional arguments for the macro \Lcs{psKnot}. + +\subsection{Scaling} +The image can be scaled with \Lkeyword{scale}, which can take one or two +values for x and y scaling. For only one value it is scaled for x and y +with the same value. The default is 1 1. + +\begin{LTXexample}[pos=t] +\begin{pspicture}(-4,-4)(4,4) + \psKnot[linewidth=5pt,linecolor=blue,knotscale=2](0,0){6-1} +\end{pspicture} +\end{LTXexample} + +\subsection{Border color} +The background color of the border can be controlled by \Lkeyword{knotbgcolor} +with only a numerical value of $[0..1]$ for a grayscale color. It makes +only sense for a colored background to get the same color for the crossing. + +\begin{LTXexample}[pos=t] +\begin{pspicture}(-2,-2)(6,2) + \psframe[fillcolor=black!20,fillstyle=solid](-2,-2)(6,2) + \psKnot[linewidth=5pt,linecolor=red!50](0,0){7-4} + \psKnot[linewidth=5pt,linecolor=red!50, + knotbgcolor=0.8](4,0){7-4} +\end{pspicture} +\end{LTXexample} + +Pay attention that black!20 is the same as 0,8 of gray. + +\subsection{Border width} +The width of the border is controlled by the keyword \Lkeyword{knotborder} and +it is preset to 2 as a factor to the current linewidth. +It must at least be the currentlinewidth (1.0). + +\begin{LTXexample}[pos=t] +\begin{pspicture}(-2,-2)(6,2) + \psKnot[linewidth=3pt,linecolor=cyan!60](0,0){6-3} + \psKnot[linewidth=3pt,linecolor=red!50, + knotborder=5](4,0){6-3} +\end{pspicture} +\end{LTXexample} + + +\clearpage +\section{List of all optional arguments for \nxLPack{pst-knot}} + +\xkvview{family=pst-knot,columns={key,type,default}} + + +\bgroup +\raggedright +\nocite{*} +\bibliographystyle{plain} +\bibliography{\jobname} +\egroup + +\printindex + +\end{document} + + -- cgit v1.2.3