diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-rubans/Changes | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-rubans/README | 44 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.bib | 100 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.pdf | bin | 0 -> 597921 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.tex | 340 |
5 files changed, 486 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-rubans/Changes b/Master/texmf-dist/doc/generic/pst-rubans/Changes new file mode 100644 index 00000000000..94e67286ca3 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-rubans/Changes @@ -0,0 +1,2 @@ +pst-rubans.tex -------- +1.20 2011-02-10 - initial CTAN version diff --git a/Master/texmf-dist/doc/generic/pst-rubans/README b/Master/texmf-dist/doc/generic/pst-rubans/README new file mode 100644 index 00000000000..8a0a5d32cc5 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-rubans/README @@ -0,0 +1,44 @@ +%% Package `pst-rubans.tex' +%% +%% Manuel Luque <Manuel.Luque27@gmail.com> +%% Herbert Voss <hvoss@tug.org> (Germany) +%% +%% 2011-02-10 +%% + +PSTricks offers excellent macros to insert more or less complex +graphics into a document. pstricks.tex itself is the base for several +other additional packages, which are mostly named pst-xxxx, +like pst-rubans. + +Save the files + +pst-rubans.sty +pst-rubans.tex + +in any place, where latex or any other TeX program will find it. + +pst-rubans uses the extended version of the keyval package. So +be sure that you +- have installed xkeyval with the special pst-xkey + (CTAN: tex-archive/macros/latex/contrib/xkeyval/) +- do not load another package after pst-rubans, which loads + the old keyval.sty or pst-key.tex + + +If you like to get the documentation file in another format run + +latex pst-rubans-doc.tex +bibtex pst-rubans-doc +latex pst-rubans-doc.tex +dvips pst-rubans-doc.dvi + +to get a PostScript file. But pay attention, that the pst-rubans +files are saved in the above mentioned way, before you run +latex on the documentation file. + +The intermediate DVI file works only with viewers which can +interprete the embedded PostScript code. + +For another PDF output read the introduction from +the documentation. diff --git a/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.bib b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.bib new file mode 100644 index 00000000000..387fbc637cf --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.bib @@ -0,0 +1,100 @@ +%% -*-bibtex-*- +@STRING{tugboat = {TUGboat} } +@STRING{dtk = {{D}ie {\TeX}nische {K}om{\"o}die} } + +@Book{casselman05, + author = {Bill Casselman}, + title = {Mathematical {I}llustrations -- a manual of geometry and {P}ost{S}cript}, + publisher = {Cambridge University Press}, + year = {2005}, + address = {Cambridge}, +} + + +@Book{PSTricks2, + author = {Herbert Vo\ss}, + title = {{PSTricks} {G}rafics for \TeX{} and \LaTeX}, + edition = {}, + publisher = {UIT}, + year = {2011}, + address = {Cambridge} +} + +} + +@Book{companion04, + author = {Frank Mittelbach and Michel Goosens et al}, + title = {The {\LaTeX} {C}ompanion}, + edition = {2nd}, + 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} +} + +@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 = {2nd}, + 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} +} + +@MISC{xkeyval, + author = {Hendri Adriaens}, + title = {xkeyval package}, + howpublished = {\url{CTAN:/macros/latex/contrib/xkeyval}}, + year = 2004 +} + +@Article{rahtz:96-1, + author = {Sebastian Rahtz}, + title = {An introduction to {PST}ricks, part {I}}, + journal = {Baskerville}, + address = {\url{CTAN: /usergrps/uktug/baskervi/}}, + year = 1996, + volume = 6, + number = 1, + month = feb, + pages = {22-34} +} +@Article{rahtz:96-2, + author = {Sebastian Rahtz}, + title = {An introduction to {PST}ricks, part {II}}, + journal = {Baskerville}, + address = {\url{CTAN: /usergrps/uktug/baskervi/}}, + year = 1996, + volume = 6, + number = 2, + month = apr, + pages = {23-33} +} + diff --git a/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.pdf b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.pdf Binary files differnew file mode 100644 index 00000000000..a091db24a16 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.pdf diff --git a/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.tex b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.tex new file mode 100644 index 00000000000..27f7a8b32e4 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-rubans/pst-rubans-doc.tex @@ -0,0 +1,340 @@ +%% $Id: pst-rubans-doc.tex 511 2011-06-06 15:39:40Z herbert $ +\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false, + smallheadings, headexclude,footexclude,oneside]{pst-doc} +\usepackage[latin9]{inputenc} +\usepackage{pst-rubans} +\let\pstRubansFV\fileversion +\renewcommand\bgImage{% +%\begin{pspicture}(-10,0)(0,0.2) +%\pshelices[lightsrc=30 5 17,incolor=yellow!50,R=0.3,h=12,spires=10,dZ=0.2,RotX=90,viewpoint=100 45 0,resolution=180,Decran=100]% +%\end{pspicture} +\psset{viewpoint=20 20 70 rtp2xyz,Decran=20,lightsrc=viewpoint,resolution=360} +\psset{unit=0.6} +\begin{pspicture}(-5,-5)(5,5) +\psSpiralRing[incolor=yellow!50, + r1=4,r0=1,hue=0 1]% +\end{pspicture} +} +\lstset{pos=l,wide=false,language=PSTricks, + morekeywords={psSpiralRing},basicstyle=\footnotesize\ttfamily} +% +\begin{document} + +\title{\texttt{pst-rubans}} +\subtitle{Plotting 3D bands -- an extension of \nxLPack{pst-solides3d}; v.\pstRubansFV} +\author{Manuel Luque\\Herbert Vo\ss} +\docauthor{} +\date{\today} +\maketitle + +\tableofcontents + +\clearpage + + +\section{introduction} +\LPack{pst-rubans} est une extension de \LPack{pst-solides3d} qui permet de tracer des rubans sur +certains solides de révolution : cylindre, tore, sphère, paraboloïde et cône. La largeur du ruban, +le nombre de spires, la couleur de la face externe ainsi que celle de la face interne peuvent +être paramétrées. Dans le cas des hélices circulaire et conique, on peut aussi choisir le nombre de rubans. + +\section{Ruban enroulé autour d'un cylindre} +On peut paramétrer le rayon \LKeyword{R=2}, la hauteur \LKeyword{h=6}, l'épaisseur(ou largeur) du +ruban \LKeyword{dZ=0.5}, le nombre de spires \LKeyword{spires=10} de chaque hélice, le nombre de +rubans \LKeyword{rubans=1}, le nombre d'éléments par ruban \LKeyword{resolution=36}, la couleur +de l'intérieur et de l'extérieur du ruban. + +La base et le couvercle ne font pas partie de la commande. +\subsection{Nombre de rubans \nxLkeyword{rubans=1}} + +\begin{BDef} +\Lcs{pshelices}\OptArgs\OptArg*{\Largr{$x_0,y_0,z_0$}} +\end{BDef} + + + +{\psset{lightsrc=viewpoint,viewpoint=50 45 30 rtp2xyz,Decran=50,dZ=0.2,resolution=72,spires=2,unit=0.5} +\begin{LTXexample}[pos=l,width=4cm] +\begin{pspicture}(-2,-1)(2,7) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,-0.2) +\pshelices[incolor=yellow!50,R=1.5,h=6,hue=0 1,grid](0,0,0) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,6) +\end{pspicture} +\end{LTXexample} + +\subsection{Nombre de rubans \nxLkeyword{rubans=2}, nombre de spires \nxLkeyword{spires=2}} +\begin{LTXexample}[pos=l,width=4cm] +\begin{pspicture}(-2,-1)(2,7) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,-0.2) +\pshelices[incolor=yellow!50,R=1.5,h=6,hue=0 1,rubans=2,grid](0,0,0) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,6) +\end{pspicture} +\end{LTXexample} + +\clearpage +\subsection{Nombre de rubans \nxLkeyword{rubans=3}, nombre de spires \nxLkeyword{spires=2}} +\begin{LTXexample}[pos=l,width=4cm] +\begin{pspicture}(-2,-1)(2,7) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,-0.2) +\pshelices[incolor=yellow!50,R=1.5,h=6,hue=0 1,rubans=3,grid](0,0,0) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,6) +\end{pspicture} +\end{LTXexample} + +\subsection{Nombre de rubans \nxLkeyword{rubans=4}, nombre de spires \nxLkeyword{spires=2}} +\begin{LTXexample}[pos=l,width=4cm] +\begin{pspicture}(-2,-1)(2,7) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,-0.2)% +\pshelices[incolor=yellow!50,R=1.5,h=6,hue=0 1,rubans=4,grid](0,0,0) +\psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36](0,0,6)% +\end{pspicture} +\end{LTXexample} +} + +\subsection{Nombre de rubans \nxLkeyword{rubans=4}, on fait varier la hauteur \texttt{[h=2,3,4,5]}} + +\begin{LTXexample}[pos=t,wide] +\psset{lightsrc=30 5 17,viewpoint=50 45 10,Decran=50,resolution=90,spires=2} +\multido{\nH=2+1}{4}{% + \begin{pspicture}(-1.5,-1)(1.5,4) + \psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36,grid](0,0,-0.2)% + \pshelices[incolor=yellow!50,R=1.5,h=\nH,linewidth=0.5\pslinewidth,dZ=0.15,hue=0 1,rubans=4,grid](0,0,0) + \psSolid[object=cylindre,r=1.5,h=0.2,ngrid=1 36,grid](0,0,\nH\space dz add)% + \end{pspicture}} +\end{LTXexample} + +\clearpage +\subsection{Rubans disposés sur un plan} + +\begin{LTXexample}[width=8cm,preset=\centering] +\psset{lightsrc=30 5 17,Decran=50,resolution=90,spires=2} +\begin{pspicture}(-4,-1)(4,4) +\psset{R=1,h=2,dZ=0.2,linewidth=0.5\pslinewidth,viewpoint=50 60 10} +\psSolid[object=grille,base=-5 5 -5 5]% +\psSolid[object=cylindre,r=1,h=0.2,ngrid=1 36](-3,-3,0) +\psSolid[object=cylindre,r=1,h=0.2,ngrid=1 36](-3,3,0) +\psSolid[object=cylindre,r=1,h=0.2,ngrid=1 36](3,3,0) +\psSolid[object=cylindre,r=1,h=0.2,ngrid=1 36](3,-3,0) +\pshelices[incolor=red!50,rubans=2](-3,-3,0.2) +\pshelices[incolor=yellow!50,rubans=2](-3,3,0.2) +\pshelices[incolor=green!50,rubans=2](3,3,0.2) +\pshelices[incolor=gray!50,rubans=2](3,-3,0.2) +\end{pspicture} +\end{LTXexample} + +\section{Ruban enroulé autour d'un tore} + +\begin{BDef} +\Lcs{psSpiralRing}\OptArgs\OptArg*{\Largr{$x_0,y_0,z_0$}} +\end{BDef} + +%\begin{lstlisting} +%\psSpiralRing[incolor=yellow!50,r1=4,r0=1,hue,lightsrc=30 5 17](x,y,z) +%\end{lstlisting} + +On peut paramétrer le rayon moyen \LKeyword{r1=2}, le rayon intérieur \LKeyword{r0=1}, +l'épaisseur du ruban \LKeyword{dPHI=2}, en degrés suivant la latitude, le nombre de +spires \LKeyword{spires=10} +du ruban, le nombre de brins du ruban \LKeyword{resolution=36}, la couleur de +l'intérieur et de l'extérieur du ruban. +{ +\psset{viewpoint=20 20 70 rtp2xyz,Decran=20,lightsrc=viewpoint,resolution=360} +\begin{LTXexample}[pos=l,width=7.5cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psSpiralRing[incolor=yellow!50, + r1=4,r0=1,hue=0 1]% +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=7.5cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psframe*(-5,-5)(5,5) +\psSpiralRing[incolor=yellow!20,r1=4,r0=1, + fillcolor=orange,grid, + dPHI=10,spires=5]% +\end{pspicture} +\end{LTXexample} + + +\begin{LTXexample}[pos=l,width=7.5cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psSpiralRing[r1=4,r0=1,fillcolor=blue, + incolor=gray!50,grid, + dPHI=2,spires=20, + resolution=720]% +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=7.5cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psSolid[object=tore,r0=1,r1=4,action=draw*,ngrid=18 36]% +\defFunction[algebraic]{solenoidetorique}(t){(4+cos(10*t))*cos(t)}{(4+cos(10*t))*sin(t)}{sin(10*t)} +\psSolid[object=courbe,linecolor=blue,r=0, + resolution=720,range=0 2 pi mul, + function=solenoidetorique]% +\end{pspicture} +\end{LTXexample} +} +\section{Ruban enroulé autour d'un paraboloïde} + +\begin{BDef} +\Lcs{psSpiralParaboloid}\OptArgs\OptArg*{\Largr{$x_0,y_0,z_0$}} +\end{BDef} + +On peut paramétrer la hauteur du paraboloïde \LKeyword{h=6}, l'épaisseur du ruban +\LKeyword{dz=.25}, le nombre de spires \LKeyword{spires=10} +du ruban, le nombre de brins du ruban \LKeyword{resolution=36}, le paramètre de la +parabole \LKeyword{p=2}, la couleur de l'intérieur et de l'extérieur du ruban. + +\begin{LTXexample}[wide,preset=\centering] +\psset{lightsrc=40 25 17} +\psset{unit=0.75,viewpoint=50 30 20,Decran=50} +\begin{pspicture}(-7,-3)(7,8) +\psSpiralParaboloid[incolor=yellow!50,h=6,hue=0 1,resolution=360,spires=5,grid,dZ=0.5] +\gridIIID[QZ=3,Zmin=0,Zmax=6](-5,5)(-5,5) +\end{pspicture} +\end{LTXexample} + + +{\psset{lightsrc=40 25 17,viewpoint=50 30 20,Decran=50} +\begin{LTXexample}[pos=l,width=9cm,wide] +\psset{unit=0.60} +\begin{pspicture}(-5,-4)(5,9) +\defFunction[algebraic]{spiraleparabolique}(t) + {2*(sqrt(t))*cos(10*t)}{2*(sqrt(t))*sin(10*t)}{t} +\psSolid[object=courbe,linecolor=blue,r=0, + resolution=720,range=0 6, + function=spiraleparabolique]% +\gridIIID[QZ=3,Zmin=0,Zmax=6](-5,5)(-5,5) +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[pos=l,width=9cm,wide] +\psset{unit=0.60} +\begin{pspicture}(-7,-4)(7,9) +\psSpiralParaboloid[incolor=yellow!50, + h=6,hue=0 1, + resolution=360, + dZ=0.25] +\gridIIID[QZ=3,Zmin=0,Zmax=6](-5,5)(-5,5) +\end{pspicture} +\end{LTXexample} +} +\section{Ruban enroulé autour d'une sphère} + +\begin{BDef} +\Lcs{psSphericalSpiral}\OptArgs\OptArg*{\Largr{$x_0,y_0,z_0$}} +\end{BDef} + +%\begin{lstlisting} +%\psSphericalSpiral[incolor=yellow!50,R=4,hue=0 1,dPHI=2,spires=10](x,y,z) +%\end{lstlisting} + +On peut paramétrer le rayon \LKeyword{R=2}, l'épaisseur du ruban +\LKeyword{dPHI=2}, en degrés suivant la latitude, le nombre de spires \LKeyword{spires=10} +de chaque hélice, le nombre de brins du ruban \LKeyword{resolution=36}, +la couleur de l'intérieur et de l'extérieur du ruban. + +\psset{viewpoint=50 20 10,Decran=50,resolution=180} +\begin{LTXexample}[width=9cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\defFunction[algebraic]{helicespherique}(t){4*cos(10*t)*cos(t)}{4*sin(10*t)*cos(t)}{4*sin(t)} +\psSolid[object=courbe,linecolor=blue,r=0, + resolution=720,range=pi 2 div neg pi 2 div, + function=helicespherique]% +\psSolid[object=sphere,r=4,action=draw,ngrid=18 18]% +\gridIIID[Zmin=-4,Zmax=4](-4,4)(-4,4) +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[width=9cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psset{viewpoint=50 20 10,Decran=50,resolution=180} +\psSphericalSpiral[incolor=yellow!50,R=4,hue=0 1,lightsrc=30 5 17]% +\gridIIID[Zmin=-4,Zmax=4](-4,4)(-4,4) +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[width=9cm] +\psset{unit=0.75} +\begin{pspicture}(-5,-5)(5,5) +\psframe*(-5,-5)(5,5) +\psset{viewpoint=50 20 30,Decran=50,resolution=360} +\psSphericalSpiral[incolor=yellow!20,R=4,fillcolor=orange,lightsrc=40 15 25,grid,dPHI=10](0,0,0) +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[width=9cm] +\begin{pspicture}(-4,-4)(4,4) +\psframe*(-4,-4)(4,4) +\psset{unit=0.6} +\psset{viewpoint=50 20 10,Decran=50,resolution=360} +\psSphericalSpiral[incolor=yellow!50,R=4,fillcolor=green!50,lightsrc=32 38 -10,grid] +\white% +\gridIIID[Zmin=-4,Zmax=4,linecolor=white](-4,4)(-4,4) +\end{pspicture} +\end{LTXexample} + +\section{Rubans enroulés autour d'un cône} + +\begin{BDef} +\Lcs{psSpiralCone}\OptArgs\OptArg*{\Largr{$x_0,y_0,z_0$}} +\end{BDef} + + + +On peut paramétrer le rayon \LKeyword{R=2}, la hauteur \LKeyword{h=6}: +il s'agit d'un double cône vertical, l'épaisseur(ou largeur) du ruban +\LKeyword{dZ=0.5}, le nombre de spires \LKeyword{spires=10} de chaque hélice, +le nombre de rubans \LKeyword{rubans=1}, le nombre d'éléments par ruban +\LKeyword{resolution=36}, la couleur de l'intérieur et de l'extérieur du ruban. + +\psset{unit=0.75} +\begin{LTXexample}[pos=t] +\begin{pspicture}(-7,-7)(7,9) +\psset{viewpoint=50 20 10 rtp2xyz,Decran=50,lightsrc=viewpoint,spires=10} +\psSolid[object=cone, + h=5,r=4,mode=4, + action=draw](0,0,-5) +\psSolid[object=cone,RotX=180, + h=5,r=4,mode=4, + action=draw](0,0,5) +\psSpiralCone[incolor=yellow!50,h=10,hue=0 1,resolution=360,dZ=0.25,grid]% +\gridIIID[Zmin=-5,Zmax=5,planmarks=true](-4,4)(-4,4) +\end{pspicture} +\end{LTXexample} + +\psset{unit=0.75} +\begin{LTXexample}[pos=t] +\begin{pspicture}(-7,-8)(7,9) +\psframe*(-7,-8)(7,9) +\psset{viewpoint=50 20 30 rtp2xyz,Decran=50,lightsrc=viewpoint,spires=10,rubans=4} +\psSpiralCone[incolor=yellow!50,h=10,R=5,fillcolor=green!50,resolution=720,dZ=0.1,grid]% +\end{pspicture} +\end{LTXexample} + + + +\clearpage +\section{List of all optional arguments for \texttt{pst-ruban}} + +\xkvview{family=pst-rubans,columns={key,type,default}} + + +\bgroup +\nocite{*} +\raggedright +\bibliographystyle{plain} +\bibliography{\jobname} +\egroup + +\printindex + + +\end{document} |