diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/Changes | 7 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf | bin | 2044104 -> 2127836 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex | 178 |
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 Binary files differindex 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 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} |