Detailed Example with Marked Points

The best way to explain how the WARMreader macros work is with an example. The figure below shows an Encapsulated POSTSCRIPT image prepared for a mathematics text [2]. Numbered $\times$s are not part of the image but indicate ``marked points'', which serve as anchors for placement of labels.

Figure 1: Imported image with ``marked points'' indicated explicitly.

Figure 2: Contents of the file Fig5.4.1.bb, containing the ``marked point'' information for figure 1.

%%Creator: PICT Displayer, by David Rand, Version 1.0, March 1999
%%Title: (Fig5.4.1.eps)
%%Date: 3/13/99¥8h49 PM
%%IMPORTANT: The following BoundingBox indicates only the size of the box, not its position!
%%BoundingBox: 0 0 224 134
%%Coordinates: LL
%%StartMarkedPoints
%%MarkedPoint: ( 38,118)  1 %F_{\lambda}^*t(m_{\lambda})
%%MarkedPoint: ( 77,115)  2 %t(m)
%%MarkedPoint: ( 62, 72)  3 %m
%%MarkedPoint: (130,123)  4 %integral curve of $X$
%%MarkedPoint: (155,107)  5 %t(m_{\lambda})
%%MarkedPoint: (113, 46)  6 %m_{\lambda}=F_{\lambda}(m)
%%MarkedPoint: (174, 38)  7 %X(m_{\lambda})
%%EndMarkedPoints

Information for the ``marked points'' in the figure above is contained in a file named Fig5.4.1.bb, with the graphic itself being named Fig5.4.1.eps. The .bb file gives the natural size (in points) of the imported graphic, as well as coordinates for marked points.

As well as being numbered in sequence, a text string is provided with each marked point. This can be used to help identify why the point has been marked. It may even provide the TEX code intended to be used to specify the label, though it is not at all necessary to use it for this purpose. For example, the code used to produce the above example was as follows.

\begin{xy}
 \xyShowAllMarkedPoints{}{Fig541}{eps}
\end{xy}

Techniques to create a file such as Fig5.4.1.bb are discussed towards the end of this article.

A side-effect of \xyShowAllMarkedPoints is to write the coordinates and text-strings for each of the marked points into the TEX Log.

Figure 3: ``Marked point'' information, as it appears in the Log file.

file: ./Fig5.4.1.bb
Bounding Box is (0,0)->(224,134)
Marked '1' point at ( 38,118) for F_{\lambda }^*t(m_{\lambda }).
Marked '2' point at ( 77,115) for t(m).
Marked '3' point at ( 62, 72) for m.
Marked '4' point at (130,123) for integral curve of $X$.
Marked '5' point at (155,107) for t(m_{\lambda }).
Marked '6' point at (113, 46) for m_{\lambda }=F_{\lambda }(m).
Marked '7' point at (174, 38) for X(m_{\lambda }).
Found 7 data points.

The purpose of this is to facilitate preparation of the required labels over several consecutive processing runs.