summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-02-14 21:36:11 +0000
committerKarl Berry <karl@freefriends.org>2018-02-14 21:36:11 +0000
commitfed9568042a15eccfe2f65969a4daaf85ca85659 (patch)
tree5cd389b8014e00411fa962d87366461e75620011 /Master/texmf-dist/doc
parent81de6ca8799fd9c8484cdede036a8dc59f31780f (diff)
pst-antiprism (14feb18)
git-svn-id: svn://tug.org/texlive/trunk@46643 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/pst-antiprism/Changes10
-rw-r--r--Master/texmf-dist/doc/generic/pst-antiprism/README.md34
-rw-r--r--Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.bib43
-rw-r--r--Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.pdfbin0 -> 457761 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.tex286
5 files changed, 373 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-antiprism/Changes b/Master/texmf-dist/doc/generic/pst-antiprism/Changes
new file mode 100644
index 00000000000..f5592b4c2cb
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-antiprism/Changes
@@ -0,0 +1,10 @@
+pst-antiprism.pro --------
+0.02 2018-02-12 first CTAN version
+
+
+pst-antiprism.tex --------
+0.02 2018-02-12 first CTAN version
+
+
+pst-antiprism.sty --------
+0.02 2018-02-12 first CTAN version
diff --git a/Master/texmf-dist/doc/generic/pst-antiprism/README.md b/Master/texmf-dist/doc/generic/pst-antiprism/README.md
new file mode 100644
index 00000000000..852f31690c1
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-antiprism/README.md
@@ -0,0 +1,34 @@
+Save the files pst-antiprism.sty|tex in a directory, which is part of your
+local TeX tree. pst-antiprism.pro should be saved in ../texmf/dvips/pstricks/
+Then do not forget to run texhash to update this tree.
+pst-antiprism needs pst-solides3d and pstricks, which should be part of your
+local TeX installation, otherwise get it from a CTAN server
+http://mirror.CTAN.org
+
+
+Save the files
+
+pst-antiprism.sty
+pst-antiprism.tex
+pst-antiprism.pro
+
+in any place, where latex or any other TeX program will find it.
+Do not forget to update your database, when installing this
+package the first time.
+
+If you like to get the documentation file in another format run
+
+latex pst-antiprism-doc.tex
+biber pst-antiprism.doc
+latex pst-antiprism-doc.tex
+dvips pst-antiprism-doc.dvi
+
+to get a PostScript file. But pay attention, that the pst-antiprism
+files are saved in the above mentioned way, before you run
+latex on the documentation file.
+
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory CTAN:/macros/latex/base/lppl.txt.
+
+$Id: README.md 730 2018-02-13 17:50:37Z herbert $
diff --git a/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.bib b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.bib
new file mode 100644
index 00000000000..68b88eb2b42
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.bib
@@ -0,0 +1,43 @@
+@STRING{tugboat = {TUGboat} }
+@STRING{dtk = {{D}ie {\TeX}nische {K}om{\"o}die} }
+
+@online{weisstein,
+ author = {Eric Weisstein},
+ title = {Antiprism},
+ url = {http://mathworld.wolfram.com/Antiprism.html},
+ urldate = {2018-02-12}
+}
+
+@online{meyer,
+ author = {Hans-Bernhard Meyer},
+ title = {Hexagonal antiprism},
+ url = {http://www.hbmeyer.de/flechten/ap6/indexeng.html},
+ urldate = {2018-02-12}
+}
+
+@Book{companion,
+ author = {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Dennis Roegel and Herbert Voß},
+ title = {The {\LaTeX} Graphics Companion},
+ publisher = {{Addison-Wesley Publishing Company}},
+ edition = {2},
+ date = {2007},
+ location = {Boston, Mass.}
+}
+
+@ctan{solides3d,
+ Title = {\texttt{pst-solides3d} -- The Basics},
+ Author = {Jean-Paul Vignault and Manuel Luque and Arnauls Schmittbuhl and Jürgen Gilg and Jean-Michel Sarlat and Herbert Voß},
+ url = {/graphics/pstricks/contrib/pst-solides3d/},
+ date = {2017-08-23},
+ urldate = {2018-02-12}
+}
+
+@Book{PSTricksE,
+ author = {Herbert Vo\ss{}},
+ title = {\texttt{PSTricks} -- {G}raphics and {P}ost{S}cript for \LaTeX},
+ edition = {1},
+ publisher = {UIT},
+ date = {2011},
+ location = {Cambridge -- UK}
+}
+
diff --git a/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.pdf b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.pdf
new file mode 100644
index 00000000000..c508e6c1a5c
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.tex b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.tex
new file mode 100644
index 00000000000..020666a859f
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-antiprism/pst-antiprism-doc.tex
@@ -0,0 +1,286 @@
+%% $Id: pst-antiprism-doc.tex 729 2018-02-13 17:48:53Z herbert $
+\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,headings=small,
+ headinclude=false,footinclude=false,oneside=true]{pst-doc}
+\listfiles
+
+\usepackage[utf8]{inputenc}
+\usepackage{pst-antiprism}
+\let\pstFV\fileversion
+\def\bgImage{\resizebox{7cm}{!}{\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism[a=1,n=15,hue=0 1 0.5 1,
+ linecolor={[rgb]{0 0 0.5}}]
+\end{pspicture}}}
+
+\usepackage{showexpl,listings,xltabular,booktabs,animate}
+
+\lstset{explpreset={pos=l,width=-99pt,overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe={}}}
+
+\usepackage{biblatex}
+\addbibresource{\jobname.bib}
+
+
+\definecolor{Miel} {RGB}{218 179 10}
+\definecolor{Maroon} {cmyk}{0 0.87 0.68 0.32}
+
+\begin{document}
+\title{\texttt{pst-antiprism}: Drawing an antiprism \\
+\small v.\pstFV}
+%\docauthor{}
+\author{Manuel Luque\\Herbert Voß}
+
+\maketitle
+
+\tableofcontents
+
+
+
+\section{Introduction}
+
+An antiprism is a semiregular polyhedron constructed with 2 n-gons and 2n triangles.
+The nets are particularly simple, consisting of two n-gons on top and bottom, separated by a
+ribbon of 2n triangles, with the two n-gons being offset by one ribbon segment.
+The duals of the antiprisms are the trapezohedra.~\cite{weisstein}
+
+The macro \Lcs{psAntiprism} has the following syntax:
+
+\begin{BDef}
+\Lcs{psAntiprism}\OptArgs
+\end{BDef}
+
+The special optional arguments with its default values are
+
+\begin{xltabular}{\linewidth}{@{} >{\ttfamily}l l X @{}}\toprule
+\rmfamily\emph{name} & \emph{default} & \emph{description}\\\midrule
+n & 8 & number of the edges of the polygon\\
+a & 1 & the radius of the outer polygon circle\\
+meshbases & true & A boolean to mesh the bases with triangles whose one vertex is the
+ center of the base and the two other two consecutive vertices of the polygon of the base.\\
+colored & false & A boolean which will color the antiprism. This is only possible with \texttt{meshbases=true}.
+ The bases of the triangles allow a coloration by continuity of a triangle of the periphery of the
+ antiprisme and the corresponding triangle of the base. It is an adaptation of the idea of H.\,B.\,Meyer
+ for hexagonal antiprism.~\cite{meyer}\\
+fan & false & draw the antiprism as a fan.\\
+\bottomrule
+\end{xltabular}
+
+
+\section{Examples}
+\subsection{The default behaviour}
+
+For \Lkeyword{viewpoint} and \Lkeyword{Decran} see the documentation of \LPack{pst-solides3d}.~\cite{solides3d}
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism
+\end{pspicture}
+\end{LTXexample}
+
+
+\clearpage
+
+\subsection{Using the optional arguments}
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism[a=1,n=15,hue=0 1 0.5 1,
+ linecolor={[rgb]{0 0 0.5}}]
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=75}
+\psAntiprism[a=2,n=10,fillcolor=Miel,hollow,incolor=yellow!20,
+ linecolor={[rgb]{0 0 0.5}},
+ linewidth=1.5pt,
+ opacity=0.9]
+\end{pspicture}
+\end{LTXexample}
+
+
+
+\subsection{No lines for the base triangles: option \texttt{meshbases=false}}
+In this case, the 2 bases have the numbers 0 and 1 and we can delete them with the optional
+argument setting \Lkeyword{rm}\texttt{=0 1}.
+
+
+
+
+
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism[a=2,n=8,inouthue=1 0 0.5 1,
+ meshbases=false,hollow,
+ opacity=0.8]
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism[a=2,n=8,inouthue=1 0 0.5 1,
+ meshbases=false,numfaces=,hollow,
+ opacity=0.8,rm=0 1,affinage=]
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 60 30 rtp2xyz,Decran=100}
+\psAntiprism[a=2,n=10,fillcolor=Maroon,
+ incolor=yellow!20,
+ linecolor=blue,
+ meshbases=false,hollow,
+ opacity=0.8,affinage=all]
+\end{pspicture}
+\end{LTXexample}
+
+
+\section{Colored anitpriam}
+
+This behaviour needs the setting \texttt{meshbases=true} and \texttt{colored=true}.
+
+It allows coloring by continuity of a triangle
+around the antiprism and the corresponding triangle of the base. The other options didn't changed
+its meaning.
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 90 30 rtp2xyz,Decran=100}
+\psset{a=1,r=1}
+\psAntiprism[colored,n=17]
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[width=0.35\linewidth]
+\begin{pspicture}(-3,-3)(3,3)
+\psset{viewpoint=100 90 -30 rtp2xyz,Decran=100}
+\psset{lightsrc=viewpoint}
+\psset{a=1,r=1,hollow,opacity=0.8,linecolor=blue}
+\psAntiprism[colored,n=17]
+\end{pspicture}
+\end{LTXexample}
+
+
+\section{An antiprism as a fan}
+
+With the optional argument \Lkeyword{fan} the antiprism can be drawn like a fan:
+
+\begin{LTXexample}[width=0.5\linewidth]
+\begin{pspicture}(-4.5,-2.5)(4.5,2.5)
+\psset{viewpoint=200 15 20 rtp2xyz,
+ Decran=500}
+\psAntiprism[fan,a=0.5,n=20,
+ inouthue=0.1 1,hollow,opacity=0.9]
+\end{pspicture}
+\end{LTXexample}
+
+
+
+\begin{LTXexample}[width=0.55\linewidth]
+\begin{pspicture}(-4.5,-3)(4.5,3)
+\psset{viewpoint=100 20 30 rtp2xyz,
+ Decran=150}
+\psAntiprism[fan,n=12,a=1.5,hollow,
+ incolor=yellow,fillcolor=red,
+ linecolor=blue,opacity=0.95,
+ affinage=all,affinagecoeff=0.9]
+\end{pspicture}
+\end{LTXexample}
+
+\begin{LTXexample}[width=0.55\linewidth]
+\begin{pspicture}(-4.5,-3)(4.5,3)
+\psset{viewpoint=200 2 25 rtp2xyz,
+ Decran=500,solidmemory}
+\psAntiprism[fan,n=20,a=0.5,hollow,
+ inouthue=0.1 1,opacity=0.9,
+ plansepare={[1 0 0 0.05]},
+ name=eventail,action=none]
+\psSolid[object=load,load=eventail1,
+ deactivatecolor,hollow,opacity=0.8]
+\end{pspicture}
+\end{LTXexample}
+
+
+\subsection{animation}
+With the package \LPack{animate} one can create inline animations in an easy way:
+
+
+\begin{center}
+\begin{animateinline}[controls,loop,
+ begin={\begin{pspicture}(-4.5,-2.5)(4.5,2.5)},
+ end={\end{pspicture}}]{12}% 25 images/s
+\multiframe{72}{iTheta=0+5}{%
+\psset{viewpoint=200 \iTheta\space 20 rtp2xyz,
+ Decran=500}
+\psAntiprism[fan,a=0.5,n=20,inouthue=0.1 1,hollow,opacity=0.9]}
+\end{animateinline}
+\end{center}
+
+
+\begin{lstlisting}
+\begin{animateinline}[controls,loop,
+ begin={\begin{pspicture}(-4.5,-2.5)(4.5,2.5)},
+ end={\end{pspicture}}]{12}% 25 images/s
+\multiframe{72}{iTheta=0+5}{%
+\psset{viewpoint=200 \iTheta\space 20 rtp2xyz,
+ Decran=500}
+\psAntiprism[fan,a=0.5,n=20,inouthue=0.1 1,hollow,opacity=0.9]}
+\end{animateinline}
+\end{lstlisting}
+
+
+\begin{center}
+\begin{animateinline}[controls,loop,
+ begin={\begin{pspicture}(-4,-4)(4,4)},
+ end={\end{pspicture}}]{12}% 25 images/s
+\multiframe{72}{iTheta=0+5}{%
+\psset{viewpoint=100 90 20 rtp2xyz,Decran=120}
+\psset{lightsrc=viewpoint}
+\psset{a=1,r=1,hollow,opacity=0.8,linecolor=blue,RotSequence=zxy,RotX=\iTheta,RotZ=\iTheta}
+\psAntiprism[colored,n=17]}
+\end{animateinline}
+\end{center}
+
+
+\begin{lstlisting}
+\begin{animateinline}[controls,loop,
+ begin={\begin{pspicture}(-4,-4)(4,4)},
+ end={\end{pspicture}}]{12}% 25 images/s
+\multiframe{72}{iTheta=0+5}{%
+\psset{viewpoint=100 90 20 rtp2xyz,Decran=120}
+\psset{lightsrc=viewpoint}
+\psset{a=1,r=1,hollow,opacity=0.8,linecolor=blue,RotSequence=zxy,RotX=\iTheta,RotZ=\iTheta}
+\psAntiprism[colored,n=17]}
+\end{animateinline}
+\end{lstlisting}
+
+
+
+\clearpage
+
+\section{List of all optional arguments for \texttt{pst-antiprism}}
+
+\xkvview{family=pst-antiprism,columns={key,type,default}}
+
+
+\bgroup
+\raggedright
+\nocite{*}
+\printbibliography
+\egroup
+
+\printindex
+\end{document}
+