summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex
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/generic/pst-coil/pst-coil-doc.tex
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/generic/pst-coil/pst-coil-doc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pst-coil/pst-coil-doc.tex99
1 files changed, 77 insertions, 22 deletions
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}
% ---------------------------------------------------------------------------------------