pstricks-add update (29apr09)

git-svn-id: svn://tug.org/texlive/trunk@12873 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 134 insertions, 44 deletions

diff --git a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex
index cd13e8fcf5a..b1408858a32 100644
--- a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex
+++ b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex
@@ -1,4 +1,4 @@
-%% $Id: pstricks-add-doc.tex 112 2009-04-17 19:21:56Z herbert $
+%% $Id: pstricks-add-doc.tex 115 2009-04-29 08:19:40Z herbert $
 \documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
     headexclude,footexclude,oneside]{pst-doc}
 \listfiles
@@ -10,6 +10,7 @@
 \usepackage{pstricks-add}
 \usepackage{pifont}
 \let\pstricksaddFV\fileversion
+\let\belowcaptionskip\abovecaptionskip
 %
 \newcommand{\pstEllipse}[5][]{%
   \psset{#1}
@@ -308,7 +309,6 @@ throughout, e.g. \verb+\let\modulo\pst@mod+.
 %--------------------------------------------------------------------------------------
 \subsection{\nxLcs{pst@absdim}}
 %--------------------------------------------------------------------------------------
-
 \begin{BDef}
 \Lcs{pst@absdim}\Largb{dimension}\Largb{result as a dimension register}
 \end{BDef}
@@ -322,6 +322,35 @@ throughout, e.g. \verb+\let\modulo\pst@mod+.
 \end{LTXexample}
 
 %--------------------------------------------------------------------------------------
+\subsection{\nxLcs{pst@int}}
+%--------------------------------------------------------------------------------------
+\begin{BDef}
+\Lcs{pst@int}\Largb{number}\Largb{result as a truncated integer}
+\end{BDef}
+
+\begin{LTXexample}[width=2cm]
+\makeatletter
+\pst@int{-34.0}\\
+\pst@int{234.123}
+\makeatother
+\end{LTXexample}
+
+%--------------------------------------------------------------------------------------
+\subsection{\nxLcs{pstFPDiv}}
+%--------------------------------------------------------------------------------------
+\begin{BDef}
+\Lcs{pstFPDiv}\Largb{result as a truncated integer}\Largb{number}\Largb{number}
+\end{BDef}
+
+\begin{LTXexample}[width=2cm]
+\makeatletter
+\pstFPDiv\Result{-3.405}{0.02345} \Result\\
+\pstFPDiv\Result{0.02345}{-3.405} \Result\\
+\pstFPDiv\Result{234.123}{33} \Result
+\makeatother
+\end{LTXexample}
+
+%--------------------------------------------------------------------------------------
 \subsection{\nxLcs{psGetSlope}}
 %--------------------------------------------------------------------------------------
 
@@ -336,6 +365,7 @@ throughout, e.g. \verb+\let\modulo\pst@mod+.
 \psGetSlope(-2111,-12)(3,1)\SlopeVal \SlopeVal
 \end{LTXexample}
 
+\clearpage
 %--------------------------------------------------------------------------------------
 \section{Dashed Lines}
 %--------------------------------------------------------------------------------------
@@ -2678,7 +2708,7 @@ additional \PS commands into the code. This makes the use of \Lcs{pstVerb} in mo
 
 
 
-\section{ New options}
+\section{New or extended  options}
 %--------------------------------------------------------------------------------------
 
 The axes macro has now two additional optional arguments for placing labels at
@@ -2696,8 +2726,8 @@ is possible. The following examples show how it can be used.
 The option \Lkeyset{tickstyle=full}|\Lkeyval{top}|\Lkeyval{bottom} no longer works in the
 usual way. Only the additional value \Lkeyval{inner} is valid for
 \LPack{pstricks-add}, because everything can be set by the
-\verb+ticksize+ option. When using the \Lkeyword{comma} or
-\verb+trigLabels+ option, the macros \Lcs{pshlabel} and
+\Lkeyword{ticksize} option. When using the \Lkeyword{comma} or
+\Lkeyword{trigLabels} option, the macros \Lcs{pshlabel} and
 \Lcs{psvlabel} shouldn't be redefined, because the package does
 it itself internally in these cases. However, if you need a
 redefinition, then do it for \Lcs{pst@@hlabel} and
@@ -2720,19 +2750,21 @@ redefinition, then do it for \Lcs{pst@@hlabel} and
 \endfirsthead
 \rowcolor{white}\textrm{\bfseries Name}         & \textrm{\bfseries Type}  & \textrm{\bfseries Default}\\\hline
 \endhead
-\Lkeyword{labels}               & <\Lkeyval{all}|\Lkeyval{x}|\Lkeyval{y}|\Lkeyval{none}>   & all\\%ok
+\Lkeyword{axesstyle}      & <\Lkeyval{none}|\Lkeyval{axes}|\Lkeyval{frame}|\Lkeyval{polar}>   & axes\\
+\Lkeyword{labels}         & <\Lkeyval{all}|\Lkeyval{x}|\Lkeyval{y}|\Lkeyval{none}>   & all\\%ok
 \Lkeyword{xlabelPos}      & <\Lkeyval{bottom},\Lkeyval{axis},\Lkeyval{top}>& \Lkeyval{bottom}\\
 \Lkeyword{ylabelPos}      & <\Lkeyval{left},\Lkeyval{axis},\Lkeyval{right}>& left\\
-\Lkeyword{xlabelFactor}         & <anything> & \{\textbackslash\@ empty\}\\
-\Lkeyword{ylabelFactor}         & <anything> & \{\textbackslash\@ empty\}\\
-\Lkeyword{labelFontSize}       & <fontsize macro>    & \{\} \\
-\Lkeyword{trigLabels}        & false|true    & false\\
-\Lkeyword{trigLabelBase}        & <number>    & 0\\
-\Lkeyword{algebraic}             & false|true & false\\ %ok
-\Lkeyword{comma}                 & false|true & false\\ %ok
-\Lkeyword{xAxis}                 & false|true & true\\%ok
-\Lkeyword{yAxis}                 & false|true & true\\%ok
-\Lkeyword{xyAxes}                & false|true & true\\%ok
+\Lkeyword{xlabelFactor}   & <anything> & \{\textbackslash\@ empty\}\\
+\Lkeyword{ylabelFactor}   & <anything> & \{\textbackslash\@ empty\}\\
+\Lkeyword{labelFontSize}  & <fontsize macro>    & \{\} \\
+\Lkeyword{trigLabels}     & false|true    & false\\
+\Lkeyword{trigLabelBase}  & <number>    & 0\\
+\Lkeyword{algebraic}      & false|true & false\\ %ok
+\Lkeyword{decimalSeparator} & <character> & .\\ %ok
+\Lkeyword{comma}          & false|true & false\\ %ok
+\Lkeyword{xAxis}          & false|true & true\\%ok
+\Lkeyword{yAxis}          & false|true & true\\%ok
+\Lkeyword{xyAxes}         & false|true & true\\%ok
 \Lkeyword{xDecimals}            & <number> or empty  & \{\}\\%ok
 \Lkeyword{yDecimals}            & <number> or empty  & \{\}\\%ok
 \Lkeyword{xyDecimals}            & <number> or empty   & \{\}\\%ok
@@ -2781,7 +2813,7 @@ redefinition, then do it for \Lcs{pst@@hlabel} and
 \Lkeyword{lly}               & <length>  & 0pt\\
 \Lkeyword{urx}               & <length>  & 0pt\\
 \Lkeyword{ury}               & <length>  & 0pt\\
-\Lkeyword{polarplot}      & false|true    & false\\
+\Lkeyword{polarplot}      	& false|true    & false\\
 \Lkeyword{ChangeOrder}        & false|true    & false\\
 \end{longtable}
 }
@@ -2790,6 +2822,48 @@ redefinition, then do it for \Lcs{pst@@hlabel} and
 \clearpage
 
 %--------------------------------------------------------------------------------------
+\subsection{\nxLkeyword{axesstyle}}
+%--------------------------------------------------------------------------------------
+There is a new axes style \Lkeyval{polar} which plots a  polar coordinate system.
+
+Syntax:
+\begin{lstlisting}[style=syntax]
+\psplot[axesstyle=polar](Rx,Ry)
+\psplot[axesstyle=polar](...)(Rx,Ry)
+\psplot[axesstyle=polar](...)(...)(Rx,Ry)
+\end{lstlisting}
+
+Important is the fact, that only one pair of coordinates is taken into account for
+the radius. It is \emph{always} the last pair in a sequence of allowed coordinates
+for the \Lcs{psaxes} macro. The other ones are ignored; they are not valid for the
+polar coordinate system.
+
+\resetOptions%
+\begin{LTXexample}[wide=true,pos=t]
+%\usepackage{pstricks-add}
+
+\begin{pspicture}(-3.5,-3.5)(3.5,3.5)
+\psaxes[axesstyle=polar](3,3)
+\psplot[polarplot,algebraic,linecolor=blue,linewidth=2pt,
+    plotpoints=2000]{0}{TwoPi 4 mul}{2*(sin(x)-x)/(cos(x)+x)}
+\end{pspicture}
+%
+\begin{pspicture}(-3.5,-3.5)(3.5,3.5)
+\psaxes[axesstyle=polar,subticklinestyle=dashed,subticks=2,
+  labelFontSize=\scriptstyle](3,3)
+\psplot[polarplot,algebraic,linecolor=red,linewidth=2pt,
+    plotpoints=2000]{0}{TwoPi}{6*sin(x)*cos(x)}
+\end{pspicture}
+\end{LTXexample}
+
+All valid optional arguments for the axes are also possible for the polar style, if they make sense \ldots\ :-)
+Important are the \Lkeyword{Dy} option, it defines the angle interval and \Lkeyword{subticks}, for
+the intermediate circles and lines. The number can be different for the circles (\Lkeyword{ysubticks}) and the 
+lines (\Lkeyword{xsubticks}).
+
+\clearpage
+
+%--------------------------------------------------------------------------------------
 \subsection{\texttt{xyAxes}, \texttt{xAxis} and \texttt{yAxis}}
 %--------------------------------------------------------------------------------------
 Syntax:
@@ -2981,14 +3055,18 @@ it must be set in math mode when using math operators!
 
 
 %--------------------------------------------------------------------------------------
-\subsection{\texttt{comma}}
+\subsection{\nxLkeyword{decimalSeparator} and \nxLkeyword{comma}}
 %--------------------------------------------------------------------------------------
 Syntax:
 \begin{lstlisting}[style=syntax]
 comma=false|true
+decimalSeparator=<charactor>
 \end{lstlisting}
-Setting this option to true gives labels with a comma as a decimal separator instead
-of the dot. \Lkeyword{comma} and \verb|comma=true| is the same.
+Setting the option \Lkeyword{comma} to true gives labels with a comma as a decimal separator instead
+of the dot. \Lkeyword{comma} and \verb|comma=true| is the same. The optional argument
+\Lkeyword{decimalSeparator} allows an individual setting for languages with a different
+character than a dot or a comma. The character has to set into braces, if it is an
+active, e.\,g. \Lkeyword{decimalSeparator}=\Largb{,}.
 
 \resetOptions
 \medskip
@@ -4807,7 +4885,8 @@ in polar mode:
 \end{BDef}
 
 The equation in PostScript code is interpreted as a function $r=f(\alpha)$, e.g. for the
-circle with radius 1 as $r=\sqrt{\sin^2x+\cos^2x}$:
+circle with radius 1 as $r=\sqrt{\sin^2x+\cos^2x}$, or $r=a*\dfrac{sin(x)*cos(x)}{(sin(x)^3+cos(x)^3)}$
+for the following examples:
 
 \begin{lstlisting}[style=syntax]
 x sin dup mul x cos dup mul add sqrt
@@ -4815,34 +4894,45 @@ x sin dup mul x cos dup mul add sqrt
 
 
 \medskip
-\begin{LTXexample}[width=6cm]
 \resetOptions
+\begin{LTXexample}[pos=t]
 \psset{plotpoints=200,unit=0.75}
-\begin{pspicture}*(-5,-5)(3,3)
-  \psaxes[arrowlength=1.75,ticksize=2pt,%
-    labelFontSize=\scriptstyle,%
-    linewidth=0.17mm]{->}(0,0)(-4.99,-4.99)(3,3)
-  \rput[Br](3,-.35){$x$}
-  \rput[tr](-.15,3){$y$}
-  \rput[Br](-.15,-.35){$0$}
-  \psset{linewidth=.35mm,polarplot=true}
+\begin{pspicture*}(-5,-5)(5.1,5.1)
+  \psaxes[arrowlength=1.75,ticksize=2pt,labelFontSize=\scriptstyle,
+    linewidth=0.2mm]{->}(0,0)(-4.99,-4.99)(5,5)[x,-90][y,180]
+  \rput[Br](-.15,-.35){$0$} \psset{linewidth=.35mm,polarplot}
   \psplot[linecolor=red]{140}{310}{3 neg x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
-  \psplot[linecolor=cyan]{140}{310}{6 neg x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
-  \psplot[linecolor=blue]{140}{310}{9 neg x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
-\end{pspicture}
+  \psplot[linecolor=cyan]{140}{310}{6 x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
+  \psplot[linecolor=blue,algebraic]{2.44}{5.41}{-8*sin(x)*cos(x)/(sin(x)^3+cos(x)^3)}
+\end{pspicture*}
 \end{LTXexample}
 
 
 
 \medskip
-\begin{LTXexample}[width=5cm]
 \resetOptions
+\begin{LTXexample}[pos=t]
+\psset{unit=0.5cm}
+\begin{pspicture}(-6,-6)(6,6)
+\psaxes[axesstyle=polar,labelFontSize=\scriptstyle,linewidth=0.2mm]{->}(6,6)
+\psset{linewidth=3pt,polarplot,plotpoints=500,plotstyle=curve}
+\psclip{\pscircle[linestyle=none]{6}}
+  \psplot[linecolor=red]{140}{310}{3 neg x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
+  \psplot[linecolor=cyan]{140}{310}{6 x sin mul x cos mul x sin 3 exp x cos 3 exp add div}
+  \psplot[linecolor=blue,algebraic]{2.44}{5.41}{-8*sin(x)*cos(x)/(sin(x)^3+cos(x)^3)}
+\endpsclip
+\end{pspicture}
+\end{LTXexample}
+
+
+\medskip
+\resetOptions
+\begin{LTXexample}[width=5cm]
 \psset{plotpoints=200,unit=1}
 \begin{pspicture}(-2.5,-2.5)(2.5,2.5)% Ulrich Dirr
  \psaxes[arrowlength=1.75,%
-    ticksize=2pt,linewidth=0.17mm]{->}(0,0)(-2.5,-2.5)(2.5,2.5)
-  \rput[Br](2.5,-.35){$x$}
-  \rput[tr](-.15,2.5){$y$}
+    ticksize=2pt,linewidth=0.17mm]{->}%
+      (0,0)(-2.5,-2.5)(2.5,2.5)[$x$,-90][$y$,180]
   \rput[Br](-.15,-.35){$0$}
   \psset{linewidth=.35mm,plotstyle=curve,polarplot=true}
   \psplot[linecolor=red]{0}{360}{x cos 2 mul x sin mul}
@@ -7513,10 +7603,12 @@ This refers to all options of the packages \LPack{pstricks},
 
 \newlength{\Li}\settowidth{\Li}{Function}
 \begin{table}[htbp]
-  \begin{center}{\ttfamily
-    \begin{tabular}{|l|r@{ $\rightarrow$ }l|}\hline
-    \multirow{2}{\Li}{\normalfont Function}&\multicolumn{2}{c|}{\normalfont Meaning}\\
-    &\normalfont on stack before & \normalfont after\\\hline
+\caption{Some primitive PostScript macros}\label{tab:primpost}
+\centering
+\ttfamily
+    \begin{tabular}{@{} l | r@{ $\rightarrow$ } l @{}}\hline
+    \multirow{2}{\Li}{\normalfont\emph{Function}} & \multicolumn{2}{ c }{\normalfont\emph{Meaning}}\\
+    &\normalfont\emph{on stack before} & \normalfont\emph{after}\\\hline
     \Lps{add} & $x\quad y$&$x+y$\\ 
     \Lps{sub} & $x\quad y$&$x-y$\\ 
     \Lps{mul} & $x\quad y$&$x\times y$\\ 
@@ -7536,9 +7628,7 @@ This refers to all options of the packages \LPack{pstricks},
     \Lps{pop} & $x$ & --\\ 
     \Lps{dup} & $x$ & $x\quad x$ \\\hline
 %    \Lps{roll} & $x_1\quad x_2\quad \cdots\quad x_n\quad n p$ &\\\hline
-  \end{tabular}}
-    \caption{Some primitive PostScript macros}\label{tab:primpost}
-  \end{center}
+  \end{tabular}
 \end{table}