summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pstricks-add
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-12-19 00:31:06 +0000
committerKarl Berry <karl@freefriends.org>2010-12-19 00:31:06 +0000
commit4836b219399bf031cee7c22265f48c76db68facc (patch)
treea69dd2c79c78e01de4b07f46d0b9808336c8e7d6 /Master/texmf-dist/doc/generic/pstricks-add
parenta3486a2d404fca82e9fc0db0a72c7d61efe4824b (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/Changes5
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/README58
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.pdfbin1769130 -> 1787845 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pstricks-add/pstricks-add-doc.tex128
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
index 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
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 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}
%--------------------------------------------------------------------------------------