summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-04-30 00:42:38 +0000
committerKarl Berry <karl@freefriends.org>2009-04-30 00:42:38 +0000
commitf45d184aee6deefd464c66bfc98b59ac92c0da16 (patch)
treee6c16764f420807b7e610a08a42d0139a7aabc0c /Master/texmf-dist/doc/generic
parentfbb9340f54cd0f028e4c18f444b9b4075d18e00e (diff)
pstricks-add update (29apr09)
git-svn-id: svn://tug.org/texlive/trunk@12873 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/Changes7
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdfbin2044104 -> 2127836 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex178
3 files changed, 140 insertions, 45 deletions
diff --git a/Master/texmf-dist/doc/generic/pstricks-add/Changes b/Master/texmf-dist/doc/generic/pstricks-add/Changes
index d39f665c68b..9b52ca56881 100644
--- a/Master/texmf-dist/doc/generic/pstricks-add/Changes
+++ b/Master/texmf-dist/doc/generic/pstricks-add/Changes
@@ -1,4 +1,4 @@
-%% $Id: Changes 112 2009-04-17 19:21:56Z herbert $
+%% $Id: Changes 114 2009-04-24 19:25:37Z herbert $
%%
pstricks-add.pro -----------
v 0.22 2009-03-17 - add LineByHand stuff
@@ -36,6 +36,11 @@ pstricks-add.sty ----------- (hv)
pstricks-add.tex ----------- (Dominik Rodriguez/hv)
+ v 3.31 2009-04-24 - added \pstFPDiv for division int(#1=#2/#3)
+ - added axes style "polar" \psaxes[axesstyle=polar](5,5)
+ - fix trailing space with yAxisLabel
+ - added option decimalSeparator to allow special symbols
+ for persian language
v 3.30 2009-04-17 - rewrote unit calculation for \psgraph. It uses now the
package pst-fp, which has the division macro (stolen
from the fp package)
diff --git a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf
index 8689eb79e57..954c14cf845 100644
--- a/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf
+++ b/Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf
Binary files differ
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}