summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-07-11 23:23:58 +0000
committerKarl Berry <karl@freefriends.org>2013-07-11 23:23:58 +0000
commitcd19244f37a468b37244a760a0025106e326c9d3 (patch)
tree73d5dbc2d7cc2dd6c4eac68b21c643213287ea20 /Master/texmf-dist/doc
parent9dde62046b0ab9a4b0574e39659fe45110daeb49 (diff)
pst-node (11jul13)
git-svn-id: svn://tug.org/texlive/trunk@31163 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/pst-node/Changes1
-rw-r--r--Master/texmf-dist/doc/generic/pst-node/pst-node-doc.pdfbin550870 -> 545669 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-node/pst-node-doc.tex72
3 files changed, 66 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-node/Changes b/Master/texmf-dist/doc/generic/pst-node/Changes
index 68f5aa8e2a5..a591474db02 100644
--- a/Master/texmf-dist/doc/generic/pst-node/Changes
+++ b/Master/texmf-dist/doc/generic/pst-node/Changes
@@ -1,4 +1,5 @@
----- pst-node.tex
+1.28 2013-07-10 - added \pnodes (plural) for multiple node definition
1.27 2013-04-12 - added macro \Cnodeput which takes radius=...
into account
1.26 2013-04-09 - added macros \psncurve and \psnccurve
diff --git a/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.pdf b/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.pdf
index e7a18003617..226cba9ab34 100644
--- a/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.pdf
+++ b/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.tex b/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.tex
index d990afaa9a3..8c8d864c7f2 100644
--- a/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.tex
+++ b/Master/texmf-dist/doc/generic/pst-node/pst-node-doc.tex
@@ -1,4 +1,4 @@
-%% $Id: pst-node-doc.tex 765 2013-04-09 15:32:28Z herbert $
+%% $Id: pst-node-doc.tex 766 2013-04-12 14:21:05Z herbert $
\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
headexclude,footexclude,oneside]{pst-doc}
\listfiles
@@ -125,6 +125,8 @@ But don't restrict yourself to these more obvious uses. For example:
\ncarc[nodesep=8pt]{->}{A}{file}
\end{lstlisting}
+
+
\section{Nodes}\label{S-nodes}
Nodes have a name. a boundary and a center.
@@ -341,7 +343,7 @@ syntax:\footnote{%
The node connections can be used with \Lcs{pscustom}. The beginning of the node
connection is attached to the current point by a straight line, as with
\Lcs{psarc}.}$^,$\footnote{%
-See page \protect\pageref{S-SpecialCoor} if you want to use the nodes as
+See page \pageref{S-SpecialCoor} if you want to use the nodes as
coordinates in other PSTricks macros.}
\begin{BDef}
@@ -542,6 +544,8 @@ Now watch what happens when we change \Lkeyword{angleA}:
\end{pspicture}
\end{LTXexample}
+
+
\Lcs{ncangle} is also a good way to join nodes by a right angle, with just two
line segments, as in this example:
@@ -985,6 +989,8 @@ Here are the details for each node connection:
\end{center}
+
+
Here is an example:
\begin{LTXexample}[width=5cm]
@@ -1181,6 +1187,9 @@ Here is how I used \Lcs{nput} to mark an angle in a previous example:
\section{Mathematical diagrams and graphs}\label{S-psmatrix}
+
+
+
For some applications, such as mathematical diagrams and graphs, it is useful
to arrange nodes on a grid. You can do this with alignment environments, such
as \TeX's \Lcs{halign} primitive, \LaTeX's \Lenv{tabular} environment, and \AmS-\TeX's
@@ -1284,6 +1293,8 @@ a node for the empty entries by setting the
\LKeyword{emnode=type}
parameter.
+
+
You can change parameters for a single entry by starting this entry with the
parameter changes, enclosed in square brackets. Note that the changes affect
the way the node is made, but not contents of the entry (use \Lcs{psset} for
@@ -1435,6 +1446,8 @@ label. E.\,g.,
\end{pspicture}
\end{LTXexample}
+
+
puts the label upright on the page, with right side located .4 centimeters
``above'' the position 0.5 of the node connection (above if the node
connection points to the right). However, the \Lcs{aput} and \Lcs{bput} commands
@@ -1514,6 +1527,31 @@ Here is another:
\clearpage
\part{New commands}
+\section{Nodes}
+
+\begin{BDef}
+\Lcs{pnodes}\OptArg\Largr{coors}\Largb{name}\Largr{coors}\Largb{name}\ldots\\
+\Lcs{pnodes}\Largb{name}\Largr{coors}\Largr{coors}\ldots
+\end{BDef}
+
+This command is identical to \Lcs{pnode} if it doesn't start with a node name. In this
+case it works in another way. See page~\pageref{pnodes} for more information. Instead of
+writing
+
+\begin{verbatim}
+\pnode(3,1){A}
+\pnode(2,4){B}
+\end{verbatim}
+
+one can also define the nodes in a short way:
+\begin{verbatim}
+\pnodes(3,1){A}(2,4){B}
+\end{verbatim}
+
+If an optional argument for the offset is used, then it is passes to all nodes.
+
+
+
\section{Setting bounding box nodes with \nxLcs{psDefBoxNodes}}
\begin{BDef}
@@ -1982,6 +2020,9 @@ followed by an index---eg, P0 P1 P2 ... P5 is a node sequence with root name P.
easy to define such node sequences using the \Lcs{multido} macro, or using one of a
number of macros in this section.
+
+
+
\subsection{Node expressions}
A number of macros in the package (eg, \Lcs{psxline}) permit the use of node expressions,
by which is meant an expression like
@@ -2089,6 +2130,9 @@ For example,
\begin{BDef}
\Lcs{curvepnodes}\Largb{tmin}\Largb{tmax}\Largb{expr. in t}\Largb{nodeRoot}
\end{BDef}
+
+
+
Uses current setting of plotpoints (default 50) to define a node sequence of points along the curve. Eg,
\begin{verbatim}
\curvepnodes[plotpoints=100]{0}{1}{t+t^2 | Ex(-t)}{P}
@@ -2169,7 +2213,7 @@ get a PostScript error if the node you specify is undefined.
\end{BDef}
is useful in writing pstricks macros, where there is a list of parenthesized coordinates
to be read and turned into a node sequence, following which \verb|<next command>| is followed.
-
+\label{pnodes}
\begin{BDef}
\Lcs{pnodes}\Largb{P}\Largr{1,2}\Largr{2;3}\ldots
\end{BDef}
@@ -2184,6 +2228,8 @@ turn a list of coordinates into a node sequence P0 P1 ...
\psline[linewidth=1pt]{->}(P3)(P4)(P5)(P6)(P7)(P8)
\end{verbatim}
+
+
\begin{LTXexample}[width=.35\textwidth]
\begin{pspicture}[showgrid=true,algebraic](-.5,-.5)(2.5,2)
\pnodes{P}(.1,.1)(1;10)(*2 {x^2/4})(0,1.4)
@@ -2324,6 +2370,9 @@ line from \verb|<basept>+<nodexpr1>| to \verb|<basept>+<nodexpr2>|.
is the most complicated macro in the collection. It has two forms.
+
+
+
\begin{verbatim}
\polyIntersections{<Name1>}{<Name2>}(A)(B)(1,2)(3;30)(6,5)...
\end{verbatim}
@@ -2426,12 +2475,13 @@ assuming \verb|P0...Pn| to be previously defined nodes.
\end{LTXexample}
\vspace{1pc}
+\iffalse
\begin{LTXexample}[width=.375\textwidth]
\begin{pspicture}[showgrid=true](-.5,-.5)(3.5,3)
-\def\fn{x+sin(2*x)}
-\psplot[algebraic]{0}{3.14}{\fn}
-\fnpnodes[algebraic]{0}{3.14}{\fn}{P}
-\pnode(.6,.8){A}\pnode(1.5,1.1){B}
+\def\func{x+sin(2*x)}
+\psplot[algebraic]{0}{3.14}{\func}
+\fnpnodes[algebraic]{0}{3.14}{\func}{P}
+\pnode(.6,.8){A} \pnode(1.5,1.1){B}
\polyIntersections{N1}{N2}(A)(B){P}{49}
\psdots(A)(B)
\uput[-90](A){A}\uput[-90](B){B}
@@ -2442,11 +2492,14 @@ assuming \verb|P0...Pn| to be previously defined nodes.
\uput[70](N1){N1}\uput[170](N2){N2}
\end{pspicture}
\end{LTXexample}
+\fi
+
\vspace{1pc}
\begin{BDef}
\Lcs{ArrowNotch}\Largb{<NodeName>}\Largb{<nodeindex>}\Largb{<direction>}\Largb{<Notch>}
\end{BDef}
+
takes as inputs the root name of the node sequence, the index at which the arrow
tip is to be drawn, and the direction (one of \verb+>,<+) of the arrow. It then
constructs the notch as a node with name \verb|<Notch>|. The arrowhead may then be
@@ -2477,8 +2530,11 @@ with only two particular arrow shapes---those arrows specified with either
\psparametricplot[algebraic,arrows=<->]{PiDiv2 neg}{Pi}{\fn}
\end{pspicture}
\end{LTXexample}
+
\vspace{1pc}
+
+
\begin{LTXexample}[width=.375\textwidth]
\def\fn{1.5+1.5*cos(t) | 1+sin(t)}
\psset{linewidth=2pt,arrowscale=3}
@@ -2494,6 +2550,8 @@ with only two particular arrow shapes---those arrows specified with either
\end{pspicture}
\end{LTXexample}
+
+
\clearpage
\section{List of all optional arguments for \texttt{pst-node}}