summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-14 23:07:19 +0000
committerKarl Berry <karl@freefriends.org>2011-08-14 23:07:19 +0000
commita6f1bf5e02c8819c63809f345c5a803cb274c9d5 (patch)
tree4822d0d50c334c78c73d0edcf71b94a913879a68 /Master/texmf-dist/doc
parent135d4e294c8799bf72c97ae9ae12f679d57a2450 (diff)
pst-coil
git-svn-id: svn://tug.org/texlive/trunk@23558 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/pst-coil/Changes9
-rw-r--r--Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.bib38
-rw-r--r--Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.pdfbin271634 -> 298604 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex99
4 files changed, 116 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-coil/Changes b/Master/texmf-dist/doc/generic/pst-coil/Changes
index 3e7c54cf69a..9e342b4e6d2 100644
--- a/Master/texmf-dist/doc/generic/pst-coil/Changes
+++ b/Master/texmf-dist/doc/generic/pst-coil/Changes
@@ -1,7 +1,11 @@
pst-coil.sty --------
- 2006-08-11 message for loading the pro file
+ 2010-02-01 message for loading the pro file
pst-coil.tex --------
+v. 1.05 2011-07-12 - added optional argument bow for circular
+ zigzags
+v. 1.04 2010-02-02 - allow an absolute value for the period
+ with a rounding or truncating option
v. 1.03 2010-02-01 - allow an absolute value for the period
with a rounding option
v. 1.02 2010-01-31 - allow an absolute value for the period
@@ -11,6 +15,9 @@ v. 1.01 2010-01-30 added \pcsin and ncsin for trigonometrial
v. 1.00 2006-08-11 using pst-xkey for the key handling
pst-coil.pro --------
+v. 1.05 2011-07-12 - added circular function
+v. 1.04 2010-02-02 - allow an absolute value for the period
+ with a rounding or truncating option
v. 1.03 2010-02-01 - allow an absolute value for the period
with a rounding option
v. 1.02 2010-01-31 - allow an absolute value for the period
diff --git a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.bib b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.bib
index ba07f2211ce..1e97f17565b 100644
--- a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.bib
+++ b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.bib
@@ -3,14 +3,13 @@
@STRING{dtk = {{D}ie {\TeX}nische {K}om{\"o}die} }
@Book{companion,
- author = {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Dennis Roegel and Herbert Vo\ss},
+ 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},
+ edition = second,
year = {2007},
- address = {Boston, Mass.}
+ address = {Reading, Mass.}
}
-
@Article{girou:01:,
author = {Denis Girou},
title = {Pr\'esentation de {PST}ricks},
@@ -40,11 +39,29 @@
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-coil,
+ Title = {\texttt{pst-coil}: Coils and zigzags},
+ Author = {{Timothy Van} Zandt},
+ Organization = {},
+ Address = {\url{CTAN:graphics/pstricks/generic/}},
+ 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:/macros/generic/multido.tex}},
+ Address = {\url{CTAN:/graphics/pstricks/generic/multido.tex}},
Note = {},
year = 1997
}
@@ -52,9 +69,16 @@
@Book{PSTricks2,
author = {Herbert Vo\ss{}},
title = {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX},
- edition = {fifth},
+ edition = {third},
publisher = {DANTE -- Lehmanns},
- year = {2008},
+ year = {2006},
address = {Heidelberg/Hamburg}
}
+@Book{PSTricks2-UIT,
+ author = {Herbert Vo\ss},
+ title = {PSTricks -- Graphics for \LaTeX},
+ publisher = {UIT},
+ year = {2011},
+ address = {Cambridge/UK}
+}
diff --git a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.pdf b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.pdf
index 73235d74a8b..4f1569b1d41 100644
--- a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.pdf
+++ b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex
index 419791c44f1..201f8298c06 100644
--- a/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex
+++ b/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex
@@ -1,4 +1,4 @@
-%% $Id: pst-coil-doc.tex 277 2010-02-01 12:36:13Z herbert $
+%% $Id: pst-coil-doc.tex 539 2011-07-12 08:22:33Z herbert $
\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
headexclude,footexclude,oneside,dvipsnames,svgnames]{pst-doc}
\listfiles
@@ -22,7 +22,7 @@
\begin{document}
\title{\texttt{pst-coil}\\Special node connections \\\small v.\pstFV}
\docauthor{Herbert Vo\ss}
-\author{Timothy Van Zandt\\Herbert Vo\ss}
+\author{Timothy Van Zandt\\Herbert Vo\ss\\Michael Sharpe}
\date{\today}
\maketitle
@@ -55,12 +55,11 @@ Marco Daniel, Denis Girou, Uwe Siart.
Table~\ref{tab:pst-coil:parameter} shows a compilation of the special parameters
valid for \LPack{pst-coil}.
-\begin{longtable}{@{}>{\ttfamily}l>{\ttfamily}l>{\ttfamily}l@{}}
-\caption{Compilation of all parameters for \texttt{pst-coil}}\label{tab:pst-coil:parameter}\\[-5pt]
-\textrm{name} & \textrm{value} & \textrm{default}\\\hline
-\endfirsthead
-\textrm{name} & \textrm{value} & \textrm{default}\\\hline
-\endhead
+\begin{table}[!htb]
+\caption{Compilation of all parameters for \texttt{pst-coil}}\label{tab:pst-coil:parameter}
+\centering
+\begin{tabular}{@{}>{\ttfamily}l>{\ttfamily}l>{\ttfamily}l@{}}\toprule
+\textrm{name} & \textrm{value} & \textrm{default}\\\midrule
\Lkeyword{coilwidth} & <value[unit]> & 1cm\\
\Lkeyword{coilheight} & <value> & 1\\
\Lkeyword{coilarm} & <value[unit]> & 0.5cm\\
@@ -72,7 +71,9 @@ valid for \LPack{pst-coil}.
\Lkeyword{amplitude} & <value> & 1\\
\Lkeyword{function} & <PS code> & sin\\
\Lkeyword{ppoints} & <dots per periods> & 360\\
-\end{longtable}
+\Lkeyword{bow} & <value[unit]> & 0cm\\\bottomrule
+\end{tabular}
+\end{table}
% ---------------------------------------------------------------------------------------
\subsection{\texttt{coilwidth}}\label{subsec:pstcoil:coilwidth}
@@ -83,7 +84,7 @@ diameter corresponds to the height with a perpendicular parallel projection
transverse to the length.
\medskip\noindent
-\begin{minipage}{5cm}
+\begin{minipage}[t]{5cm}\vspace{0pt}
\begin{pspicture}(0,-5)(5,5)
\pscoil(0,4)(3.5,4)
{
@@ -120,7 +121,7 @@ transverse to the length.
\uput*[0](3.5,-0.5){0.50cm}
\end{pspicture}
\end{minipage}\hfill%
-\begin{minipage}{\linewidth-5cm-1em}
+\begin{minipage}[t]{\linewidth-5cm-1em}\vspace{0pt}
\begin{lstlisting}
\begin{pspicture}(0,-5)(5,5)
\pscoil(0,4)(3.5,4)
@@ -152,16 +153,12 @@ transverse to the length.
\Lkeyword{coilheight} is in contrast to \Lkeyword{coilwidth} no
length but only a factor, whereat the distance between two
windings\index{winding} resp. jags is composed as follows:
-\begin{equation}dx = coilheight\cdot coilwidth \end{equation}
+$dx = coilheight\cdot coilwidth$
-As can be seen in the following example, not the same physical distance is
-yielded. This is caused by the internal three dimensional
-representation\index{three dimensional representation} of the coil; it is not
-seen under an angle of $90^\circ$ but $45^\circ$. (Section~\ref{subsec:pstcoil:coilaspect})
\medskip\noindent
\begin{LTXexample}[width=5cm]
-\begin{pspicture}(0,-4)(5,5)
+\begin{pspicture}(0,-3)(5,4)
\pscoil(0,4)(3.5,4)
{\psset{linewidth=0.2pt}
\psline[arrowscale=2,tbarsize=3mm]{|<->|}(4.5,3.5)(4.5,4.5)
@@ -181,10 +178,9 @@ seen under an angle of $90^\circ$ but $45^\circ$. (Section~\ref{subsec:pstcoil:c
\end{pspicture}
\end{LTXexample}
-
-\medskip\noindent
+\vspace{0pt}\noindent
\begin{LTXexample}[width=5cm]
-\begin{pspicture}(0,-4)(5,5)
+\begin{pspicture}[shift=2cm](0,-3)(5,4)
\pszigzag(0,4)(3.5,4)
{ \psset{linewidth=0.2pt}
\psline[arrowscale=2,tbarsize=3mm]{|<->|}(4.5,3.5)(4.5,4.5)
@@ -204,6 +200,11 @@ seen under an angle of $90^\circ$ but $45^\circ$. (Section~\ref{subsec:pstcoil:c
\end{pspicture}
\end{LTXexample}
+\bigskip
+As can be seen in the above example, not the same physical distance is
+yielded. This is caused by the internal three dimensional
+representation\index{three dimensional representation} of the coil; it is not
+seen under an angle of $90^\circ$ but $45^\circ$. (Section~\ref{subsec:pstcoil:coilaspect})
% ---------------------------------------------------------------------------------------
@@ -291,6 +292,29 @@ effort.
% ---------------------------------------------------------------------------------------
+\subsection{\texttt{bow}}\label{subsec:pstcoil:bow}
+% ---------------------------------------------------------------------------------------
+The default value for \Lkeyword{bow} is 0pt which leads to the shown direct connections
+between the two given point. With a positive or negative value circular zigzags are
+possible. This option is not available for coils.
+
+\medskip\noindent
+\begin{LTXexample}[width=6cm]
+\psset{unit=0.6}
+\begin{pspicture}[showgrid,shift=2cm](-1,-1)(9,9)
+\pszigzag[bow=-0.4cm,coilheight=.3,
+ coilwidth=.75cm]{*->}(0,0)(4,4)
+\pczigzag[linecolor=red,bow=2.5cm,
+ coilheight=0.3,
+ coilwidth=.75cm]{*->}(0,2)(6,6)
+\pnode(3,5){A}\pnode(5,0){B}
+\nczigzag[bow=2cm,
+ coilheight=0.3,]{A}{B}
+\end{pspicture}
+\end{LTXexample}
+
+\vspace{2\normalbaselineskip}
+% ---------------------------------------------------------------------------------------
\subsection{\nxLkeyword{ppoints}}
% ---------------------------------------------------------------------------------------
By default a line or node connection divides the total length into 360 segments.
@@ -334,7 +358,7 @@ be an absolute value.
\end{pspicture}
\end{LTXexample}
-With a star as prefix the absolute value will be rounded to get an
+With a star as prefix the absolute real value will be truncated to get an
integer number of periods.
\medskip\noindent
@@ -351,6 +375,23 @@ integer number of periods.
\end{pspicture}
\end{LTXexample}
+With a double star as prefix the absolute real value will be rounded instead of truncated to get an
+integer number of periods.
+
+\medskip\noindent
+\begin{LTXexample}[width=5.5cm]
+\begin{pspicture}(5,2)
+\psset{coilarm=5mm}
+\psaxes(5mm,0)(4.5,2)
+\pssin[periods=1.1cm,linestyle=dotted,
+ linecolor=red](0,1)(5,1)
+\pssin[periods=**1.1cm,linecolor=red](0,1)(5,1)
+\pssin[periods=2.2cm,linestyle=dotted,
+ linecolor=blue](0,1)(5,1)
+\pssin[periods=**2.2cm,linecolor=blue](0,1)(5,1)
+\end{pspicture}
+\end{LTXexample}
+
% ---------------------------------------------------------------------------------------
\subsection{\nxLkeyword{amplitude}}
@@ -460,11 +501,25 @@ then led to the specified arm length.
\begin{pspicture}(4,4)
\pszigzag[coilarm=.5cm,linewidth=1.5pt,coilwidth=.5cm]{|->}(4,3)
\pszigzag[linecolor=red,coilheight=0.2](3,4)(3,1)
-\pszigzag[doubleline=true,linecolor=cyan,coilheight=0.75](0,4)(3,0)
+\pszigzag[doubleline,linecolor=cyan,coilheight=0.75](0,4)(3,0)
\end{pspicture}
\end{LTXexample}
+\medskip\noindent
+\begin{LTXexample}[width=4cm]
+\begin{pspicture}(4,4)
+\pszigzag[coilarm=.5cm,
+ linewidth=1.5pt,bow=5mm,
+ coilwidth=.5cm]{|->}(4,3)
+\pszigzag[linecolor=red,bow=-1cm,
+ coilheight=0.2](3,4)(3,1)
+\pszigzag[doubleline,
+ linecolor=cyan,bow=1cm,
+ coilheight=0.75](0,4)(3,0)
+\end{pspicture}
+\end{LTXexample}
+
% ---------------------------------------------------------------------------------------
\section{Node connections}\label{sec:pstcoil:knotenverbindungen}
% ---------------------------------------------------------------------------------------