diff options
author | Karl Berry <karl@freefriends.org> | 2010-12-19 00:31:06 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-12-19 00:31:06 +0000 |
commit | 4836b219399bf031cee7c22265f48c76db68facc (patch) | |
tree | a69dd2c79c78e01de4b07f46d0b9808336c8e7d6 /Master/texmf-dist/doc/generic/pstricks-add | |
parent | a3486a2d404fca82e9fc0db0a72c7d61efe4824b (diff) |
pstricks-add (18dec10)
git-svn-id: svn://tug.org/texlive/trunk@20794 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pstricks-add')
-rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/Changes | 5 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/README | 58 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdf | bin | 1769130 -> 1787845 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex | 128 |
4 files changed, 189 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/generic/pstricks-add/Changes b/Master/texmf-dist/doc/generic/pstricks-add/Changes index 94ef0f29fc2..ea4a67a0325 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 431 2010-12-13 10:53:46Z herbert $ +%% $Id: Changes 439 2010-12-18 18:45:23Z herbert $ %% pstricks-add.pro ----------- 0.23 2009-12-20 - add RGBtoGRAY and WavelengthToGRAY @@ -39,6 +39,9 @@ pstricks-add.sty ----------- (hv) pstricks-add.tex ----------- (Dominik Rodriguez/hv) + v 3.48 2010-12-18 - add macro \psCircleTangents for drawing tangent + lines of a point and a circle or two circles. + v 3.47 2010-12-14 - save the absolute coordinates of \psVector in node names v 3.46 2010-12-13 - added new macro \psVector for drawing vectors with relative coordinates (hv) v 3.45 2010-11-01 - modified \Put for checking coor type (hv) diff --git a/Master/texmf-dist/doc/generic/pstricks-add/README b/Master/texmf-dist/doc/generic/pstricks-add/README new file mode 100644 index 00000000000..852dd71f408 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pstricks-add/README @@ -0,0 +1,58 @@ +pstricks-add redefines a lot of the pstricks macros and uses the extended +version of the keyval package. So be sure that you +- pstricks-add depends on the pstricks.pro Version 1.05, 2008/06/25 + you can get it from http://perce.de/LaTeX/pstricks/ or CTAN +- load pstricks-add as last pstricks related package +- have installed xkeyval with the special pst-xkey + (CTAN: tex-archive/macros/latex/contrib/xkeyval/) +- do not load another package after pstricks-add, which loads + the old keyval.sty or pst-key.tex + +pstricks-add collects a lot of the code which was posted +to the pstricks mailing list and has some more new features: + +- pstricks + o random dots + O braces + o define and calculate colors on PS side + o Gouraud shading + o braces as node connection/linestyle + o line style bar + o lines, drawn "by hand" + o arrows, arrows, arrows, ... + +- pst-plot + o new syntax for \psplot and \psparametricplot + o new environment psgraph + o new macro pstScalePoints + o new option for logarithmic axes + o new macro and options for ticklines + o new plot option bar and option barwidth + o new options step, start end for plotting data files + o new options xLabel, yLabel + o new option plotNo for multiple data files x y1 y2 y3 ... + o new macro psplotTangent + o new macro psplotDiffEqn + o new option algebraic for infix notation + o new option changeOrder + +- pst-node + o new macro nclineII for a two-colored line + o new option lineAngle for ncdiag + o new macros for interpolation nodes + and linear combination of two vectors + o new macro ncbarr (line with 5 segments) + + +pstricks-add.pro : the prolog file for pstricks-add +pstricks-add-doc.tex: the included doc file +pst-fp.tex : for floating point multiplication and division + +Save the files pstricks-add.sty|pro|tex and pst-fp.tex in a directory, +which is part of your local TeX tree. The pro file should go +into $TEXMF/dvips/pstricks/ +Then do not forget to run texhash to update this tree. +For more information see the documentation of your LATEX distribution +on installing packages into your local TeX system or read the +TeX Frequently Asked Questions: +(http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages). 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 768d62de8f4..b2947990e5a 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 e186bbc1525..8cdd5d020d9 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 431 2010-12-13 10:53:46Z herbert $ +%% $Id: pstricks-add-doc.tex 439 2010-12-18 18:45:23Z herbert $ \documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings headexclude,footexclude,oneside]{pst-doc} \listfiles @@ -254,9 +254,135 @@ for the horizontal line in \Lkeyval{psMarkAngleLineStyle} and preset to \end{pspicture} \end{lstlisting} +All end points of the vectors are saved in node names with the preset name \verb=Vector#=, +where \# is the consecutive number of the nodes. \verb=Vector0= ist the starting point of +the first \Lcs{psVector}. With the macro \Lcs{psStartPoint} one can set the starting point and +with optional argument the name of the nodes. \verb=Vector3= is the default node name of +the endpoint of the third vector or the name of the starting point of the forth vector. + +\begin{BDef} +\Lcs{psStartPoint}\OptArg{node basename}\Largr{$x$,$y$} +\end{BDef} + +\begin{pspicture}[showgrid,linewidth=1pt](10,10.4) + \psStartPoint[A](1,1)% nodes have the base name A + \psVector(3;30)\psVector(4;60)\psVector[linecolor=red](3;10) + \psVector[linestyle=dashed](4;110) + \psline{->}(A0)(A4) + \psStartPoint[B](1,1)\psset{markAngle}% nodes have the base name B + \psVector[linestyle=dashed](4;110) + \psVector[linecolor=red](3;10) + \psVector(4;60)\psVector(3;30) + \psline[arrows=-D>,arrowscale=2,linewidth=1.5pt,linecolor=red](B2)(A2) + \psline[arrows=-D>,arrowscale=2,linewidth=1.5pt,linecolor=blue](A3)(B3) + \multido{\iA=0+1}{5}{\uput[0](A\iA){A\iA}\uput[180](B\iA){B\iA}} +\end{pspicture} + +\begin{lstlisting} +\begin{pspicture}[showgrid,linewidth=1pt](10,10.4) + \psStartPoint[A](1,1)% nodes have the base name A + \psVector(3;30)\psVector(4;60)\psVector[linecolor=red](3;10) + \psVector[linestyle=dashed](4;110) + \psline{->}(A0)(A4) + \psStartPoint[B](1,1)\psset{markAngle}% nodes have the base name B + \psVector[linestyle=dashed](4;110) + \psVector[linecolor=red](3;10) + \psVector(4;60)\psVector(3;30) + \psline[arrows=-D>,arrowscale=2,linewidth=1.5pt,linecolor=red](B2)(A2) + \psline[arrows=-D>,arrowscale=2,linewidth=1.5pt,linecolor=blue](A3)(B3) + \multido{\iA=0+1}{5}{\uput[0](A\iA){A\iA}\uput[180](B\iA){B\iA} + \end{pspicture} +\end{lstlisting} \clearpage + +%-------------------------------------------------------------------------------------- +\section{\nxLcs{psCircleTangents}: Calculating tangent lines of circles} +%-------------------------------------------------------------------------------------- + +The macro calculates the points on a circle where tangent lines from another +point or another circle are drawn. + +\begin{BDef} +\Lcs{psCircleTangents}\Largr{$x1,y1$}\Largr{$x2,y2$}\Largb{Radius}\\ +\Lcs{psCircleTangents}\Largr{$x1,y1$}\Largb{Radius}\Largr{$x2,y2$}\Largb{Radius} +\end{BDef} + +In the first case the coordinates of a point and the center and the radius +of a circle must be given. The names of the calculates node names are \verb=CircleT1= +and \verb=CircleT2=. + +\bigskip +\begin{pspicture}[showgrid](0,3)(10,10) +\psdot(2,4)\pscircle(7,7){2} +\psCircleTangents(2,4)(7,7){2} +\pcline[nodesep=-1cm,linecolor=blue](2,4)(CircleT1) +\pcline[nodesep=-1cm,linecolor=blue](2,4)(CircleT2) +\psdots(CircleT1)(CircleT2) +\uput[-80](CircleT1){T1}\uput[115](CircleT2){T2} +\end{pspicture} + + +\begin{lstlisting} +\begin{pspicture}[showgrid](0,3)(10,10) +\psdot(2,4)\pscircle(7,7){2} +\psCircleTangents(2,4)(7,7){2} +\pcline[nodesep=-1cm,linecolor=blue](2,4)(CircleT1) +\pcline[nodesep=-1cm,linecolor=blue](2,4)(CircleT2) +\psdots(CircleT1)(CircleT2) +\uput[-80](CircleT1){T1}\uput[115](CircleT2){T2} +\end{pspicture} +\end{lstlisting} + +\bigskip +When using the other variant of the macro two circles must be given. THe macro then defines +ten nodes, named \verb=CircleTC1= and \verb=CircleTC2= for the two intersection points, + \verb=CircleTO1=, \verb=CircleTO2=, \verb=CircleTO3=, and \verb=CircleTO4= for the four + nodes of the outer tangent lines and + \verb=CircleTI1=, \verb=CircleTI2=, \verb=CircleTI3=, and \verb=CircleTI4= for the + four nodes of the inenr tangent lines. + +\bigskip +\begin{pspicture}[showgrid](-2,-2)(10,10) +\pscircle(1,1){1}\pscircle(7,7){3} +\psCircleTangents(1,1){1}(7,7){3} +\pcline[nodesep=-1cm,linecolor=blue](CircleTO1)(CircleTO2) +\pcline[nodesep=-1cm,linecolor=blue](CircleTO3)(CircleTO4) +\pcline[nodesep=-1cm,linecolor=red](CircleTI1)(CircleTI2) +\pcline[nodesep=-1cm,linecolor=red](CircleTI3)(CircleTI4) +\psdots(CircleTC1)(CircleTC2)% + (CircleTO1)(CircleTO2)(CircleTO3)(CircleTO4)% + (CircleTI1)(CircleTI2)(CircleTI3)(CircleTI4)% +\uput[0](CircleTC1){TC1}\uput[0](CircleTC2){TC2} +\uput[-80](CircleTI1){TI1}\uput[115](CircleTI2){TI2} +\uput[150](CircleTI3){TI3}\uput[-45](CircleTI4){TI4} +\uput[-80](CircleTO1){TO1}\uput[150](CircleTO2){TO2} +\uput[150](CircleTO3){TO3}\uput[-45](CircleTO4){TO4} +\end{pspicture} + +\bigskip +\begin{lstlisting} +\begin{pspicture}[showgrid](-2,-2)(10,10) +\pscircle(1,1){1}\pscircle(7,7){3} +\psCircleTangents(1,1){1}(7,7){3} +\pcline[nodesep=-1cm,linecolor=blue](CircleTO1)(CircleTO2) +\pcline[nodesep=-1cm,linecolor=blue](CircleTO3)(CircleTO4) +\pcline[nodesep=-1cm,linecolor=red](CircleTI1)(CircleTI2) +\pcline[nodesep=-1cm,linecolor=red](CircleTI3)(CircleTI4) +\psdots(CircleTC1)\psdots(CircleTC2)% + (CircleTO1)(CircleTO2)(CircleTO3)(CircleTO4)% + (CircleTI1)(CircleTI2)(CircleTI3)(CircleTI4)% +\uput[0](CircleTC1){TC1}\uput[0](CircleTC2){TC2} +\uput[-80](CircleTI1){TI1}\uput[115](CircleTI2){TI2} +\uput[150](CircleTI3){TI3}\uput[-45](CircleTI4){TI4} +\uput[-80](CircleTO1){TO1}\uput[150](CircleTO2){TO2} +\uput[150](CircleTO3){TO3}\uput[-45](CircleTO4){TO4} +\end{pspicture} +\end{lstlisting} + + +\clearpage %-------------------------------------------------------------------------------------- \section{\nxLcs{psrotate}: Rotating objects} %-------------------------------------------------------------------------------------- |