From 9671ec383c800ba72eb1962aab94b639d3c2d83b Mon Sep 17 00:00:00 2001
From: "Joachim Wuttke (l)" <j.wuttke@fz-juelich.de>
Date: Mon, 23 May 2016 23:09:20 +0200
Subject: [PATCH] Halfway complete Graphic postprocessing manual => Version
 beta1.

---
 doc/ps/FridaGraphicPostprocessing.tex |   2 +-
 doc/ps/GraphicPostprocessing.tex      |  86 +++++++++++++++++++-------
 doc/ps/Legend.ps                      |   7 ++-
 doc/ps/legend.pdf                     | Bin 4691 -> 0 bytes
 4 files changed, 72 insertions(+), 23 deletions(-)
 delete mode 100644 doc/ps/legend.pdf

diff --git a/doc/ps/FridaGraphicPostprocessing.tex b/doc/ps/FridaGraphicPostprocessing.tex
index 23f222e6..709f5398 100644
--- a/doc/ps/FridaGraphicPostprocessing.tex
+++ b/doc/ps/FridaGraphicPostprocessing.tex
@@ -12,7 +12,7 @@
 \def\T#1{\texttt{#1}}
 
 \def\FridaVersionNumber{2.3.3c}
-\def\UserManualVersionNumber{$\gamma$2}
+\def\UserManualVersionNumber{$\beta1$}
 
 \begin{document}
 \flushbottom
diff --git a/doc/ps/GraphicPostprocessing.tex b/doc/ps/GraphicPostprocessing.tex
index 90c50594..54c83047 100644
--- a/doc/ps/GraphicPostprocessing.tex
+++ b/doc/ps/GraphicPostprocessing.tex
@@ -1234,45 +1234,89 @@ or
 \subsection {Text placement commands}\label{SfpsTextPlacement}
 %==============================================================================
 
-For a legend,
+\begin{figure}[tp]
+\centering{\includegraphics[width=.2\textwidth]{Legend.ps}}
+\caption{A plot legend, created by the code shown in \cref{SfpsTextPlacement}.}
+\label{Flegend}
+\index{Legend!Frida graphic}%
+\index{Frida graphic!legend}%
+\iFM{lset}%
+\end{figure}
+
+A legend, inserted into a plot, is often formatted as a list.
 \index{Legend!Frida graphic}%
 \index{Frida!graphic file!legend}%
-insert a list in the figure:
-\begin{minipage}[b]{.58\textwidth}
+\index{List!Frida graphic}%
+\index{Frida!graphic file!list}%
+To start a list, Frida's dictionary provides the command \T{NewList},
+which takes four arguments:
+$x$ and $y$ coordinates of the top left,
+font size, and line spacing.
+\iFM{NewList}%
+Once a list is started,
+different commands can be used to insert text and symbols.
+The most important one is \T{PtTxLine},
+\iFM{TxLine}%
+which takes two arguments: a plot style (as with the command \T{pstyle}),
+and an extended string.
+The command \T{TxLine}
+\iFM{PtTxLine}%
+only takes an extended string argument,
+and can be used for a comment line.
+\Cref{Flegend} shows an example legend, created by the code
 \begin{lstlisting}
 2 8 21 1.8 NewList
-% arguments: x y fontsize linespacing
 {(q = 1.2 )Angr()} TxLine
 1 {(    4 K)} PtTxLine
 2 {(200 K)} PtTxLine
 3 {(240 K)} PtTxLine
 4 {(280 K)} PtTxLine
 \end{lstlisting}
-\end{minipage}
-\hfill
-\begin{minipage}[b]{.26\textwidth}
-\includegraphics[width=1\textwidth]{legend.pdf}
-\end{minipage}
-\iFM{NewList}%
-\iFM{TxLine}%
-\iFM{PtTxLine}%
-
+Furthermore, the figure shows a frame with rounded edges.
+It has been created by the command
+\begin{lstlisting}
+.5 [] lset
+1.8 4.4 4.4 8.6 .1 { stroke } execOval2
+\end{lstlisting}
+\iFM{execOval2}%
+\index{Frame!Frida graphic}%
+\index{Frida!graphic file!frame (user drawn)}%
+Arguments of \T{execOval2} are bottom and top $x$ coordinate,
+left and right $y$ coordinate, radius for the rounded edges,
+and a plot procedure.
+As an alternative, the command \T{execRectangle2}
+\iFM{execRectangle2}%
+draws a plain rectangle.
+
+Finally, the Frida dictionary provides several commands
+for drawing single lines of text.
 \index{Text!Frida graphic}%
 \index{Frida!graphic file!text}%
 Any other text can be pasted at arbitrary positions in the figure:
 \begin{lstlisting}
-21 setown % set font size
-
-5 5 {(centered text)} textCM
-1 1 {(bottom left aligned)} textLB
-9 9 {(top right aligned)} textRT
-
-5 5 60 {(rotated by 60)(\260)g()} rtextCM
+21 setown
+x y {(centered text)} textCM
+x y 60 {(rotated by 60)(\260)g()} rtextCM
 \end{lstlisting}
+The command \T{setown} sets the font size.
+\iFM{setown}
+The command \T{textCM} draws an extended string,
+centered at a given position $x,y$.
 \iFM{textCM}%
+The command \T{rtextCM} rotates the text by a given angle.
+\iFM{rtextCM}%
+To change the alignement, replace the letter \T{C} in these commands
+by \T{L} or \T{R} for left, right.
+Similarly, replace \T{M} by \T{B} or \T{T} for
+vertical alignement at bottom or top.
 \iFM{textLB}%
+\iFM{textLM}%
+\iFM{textLT}%
+\iFM{textCB}%
+\iFM{textCT}%
+\iFM{textRB}%
+\iFM{textRM}%
 \iFM{textRT}%
-\iFM{rtextCM}%
 
 %==============================================================================
 \subsection{Concatenation, insets}\label{Sconcat}
diff --git a/doc/ps/Legend.ps b/doc/ps/Legend.ps
index fda2190d..cec3d2a8 100644
--- a/doc/ps/Legend.ps
+++ b/doc/ps/Legend.ps
@@ -1,4 +1,7 @@
-%!PS-Adobe-2.0
+%!PS-Adobe-1.0 EPSF-1.0
+%%BoundingBox:   127   659   202   752
+%%Comment: Bounding box extracted by bboxx
+%%+:       A program by Dov Grobgeld 2003
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%  FRIDA: fast reliable interactive data analysis                           %%
@@ -1700,4 +1703,6 @@ BoxBackground
 3 {(240 K)} PtTxLine
 4 {(280 K)} PtTxLine
 
+.5 [] lset
+1.8 4.4 4.4 8.6 .1 { stroke } execOval2 %  xl xh yl yh dr { proc } | -
 showpage
diff --git a/doc/ps/legend.pdf b/doc/ps/legend.pdf
deleted file mode 100644
index 8db8dcba6c62fb020f01565774b2aa45de535041..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4691
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

-- 
GitLab