\section{Available Image Editors}

\subsection{xpaint, CorelDRAW and CorelPAINT}

\begin{wrapfigure}{r}{4cm}
\includegraphics[scale=0.7]{graphics/xpaintdemo.eps}
\caption{An \tt{xpaint} doodle.} 
\end{wrapfigure}
These programs need little in the way of introduction.
They have roughly the same sets of tools with which to 
create or modify an image file. You have ellipses, 
squares, lines, curves, speckling, painting, et cetera.
But you should know one thing: these programs do 
not keep track of the different steps you make, so
if you take that JPEG of your family and add a text 
to make a card for grandma, you should save it under a different
filename, since you cannot undo the text overlay when
it's time to send a different card to your great
aunt Thelma. (The Corel programs, by the way,
live in the {\tt corel} locker, as {\tt coreldraw}
and {\tt corelpaint}.)

\subsection{xfig}

Xfig lives in the SIPB locker
together with its detailed manpage. To start it 
up, type {\tt add sipb; xfig \&}. The window that 
pops up will look quite Spartan, but don't let 
that intimidate you. To have a better look at what 
you're doing, click on ``Grid Mode'' and select a 
comfortable grid setting. Now you're ready to start 
laying down elements. 

Xfig's user interface comes a from different religious 
tradition compared to other graphics programs, 
as you'll soon see. Click on the rectangle button
in the Drawing Modes section and put your mouse in the 
main area.
On the top right corner is an area marked 
``mouse buttons.'' The left mouse button is 
marked ``corner point.'' When you click on the
first corner point, the button is changed to mark
``final point,'' and the right button is marked as 
``cancel.'' That is what it means. Xfig does not
use mouse dragging for input. 
\begin{figure}
\includegraphics[scale=0.3,angle=270]{graphics/xfig-mouse-buttons.ps}
\caption{Detail from the Xfig interface - the mouse button descriptor}
\end{figure}

Note that for the Polyline drawing tool, the 
left button is labelled ``first point,'' the middle
as ``freehand,'' and the right is ``single point.''
% wrap figure gets the margins mundged. 
%\begin{wrapfigure}{l}{4cm}
\begin{figwindow}[3,l, %
{\setlength{\unitlength}{947sp}%
%
\begingroup\makeatletter\ifx\SetFigFont\undefined%
\gdef\SetFigFont#1#2#3#4#5{%  \reset@font\fontsize{#1}{#2pt}%
  \fontfamily{#3}\fontseries{#4}\fontshape{#5}%
  \selectfont}%
\fi\endgroup%
\begin{picture}(3462,3849)(1276,-3748)
\thinlines
\put(3151,-2386){\oval(1500,1650)}
\put(1651,-3736){\framebox(3075,2700){}}
\put(1651,-1036){\line( 5, 6){952.869}}
\put(876,-1036){\makebox(0,0)[lb]{\smash{\SetFigFont{29}{34.8}{\rmdefault}{\mddefault}{\updefault}P}}}
\end{picture}},{A typical figure from Xfig.}]
%\caption{A typical figure from Xfig.}
%\end{wrapfigure}
That means that to draw your zig zag, you mark the 
points in order with the left button, until the 
last point, which you mark with the middle. The 
third acts as your cancel. Play around with each  
of the drawing modes until you get the hang of it. 
Be sure to play with the Picture button some. 
Then it'll be time to look at the editing modes. 
After you've played around enough, you have several 
objects on the canvas, each of which is a labeled collection
of points. If you click on ``move'', you can move entire
objects. You select one with the left or middle buttons,
and then place it with the middle. (Selecting with the 
middle button means you can only move the object vertically
or horizontally, a useful restriction if your hand isn't steady).
\end{figwindow}


Next to the ``move'' button is its point analogue. It lets
you move a single point of an object, leaving the other points
where they are. Now play some with the editing tools. 
They will come in handy.

Now you're ready to save. To leave Xfig and save a figure for later
editing, you can save it as a .fig file. {\em Warning:}
Xfig's File dialog can mistakenly reload an image you just 
modified if you press ``return'' there thoughtlessly.
There are two buttons in the dialog, marked ``load'' and ``save.''
Click on the one you mean. 
To use the figure for another
context, you will need the Export menu. Your format options are
listed under the ``Language'' item. To make an image \LaTeX{} will 
like, you can make an encapsulated postscript object, or you can 
use the Latex picture settings. These will let you save a 
set of Latex commands that might look foreboding but can 
actually be edited by hand. By saving as \LaTeX{} you can 
do such things as putting Greek lettering or other 
\LaTeX{} oddities in your figure. 

For example, the figure above comes looking like this
when exported to \LaTeX:
\begin{verbatim}
\setlength{\unitlength}{947sp}
\begingroup\makeatletter\ifx\SetFigFont\undefined%
\gdef\SetFigFont#1#2#3#4#5{%
  \reset@font\fontsize{#1}{#2pt}%
  \fontfamily{#3}\fontseries{#4}\fontshape{#5}%
  \selectfont}%
\fi\endgroup%
\begin{picture}(3462,3849)(1276,-3748)
\thinlines
\put(3151,-2386){\oval(1500,1650)}
\put(1651,-3736){\framebox(3075,2700){}}
\put(1651,-1036){\line( 5, 6){952.869}}
\put(876,-1036){\makebox(0,0)[lb]{\smash{\SetFigFont{29}
{34.8}{\rmdefault}{\mddefault}{\updefault}P}}}
\end{picture}}
\end{verbatim}

A look through the code one can easily find the places
where the elements are set and adjust them by hand to make a
diagram look just right, or to add \LaTeX-isms 
like mathematical symbols to the text elements you 
created with Xfig. By looking for the ``updefault'' command
in the code and replacing the text that comes after
%it with a $\tt{\backslash{}phi}$, we can make a drawing looking 
it with a {\verb \phi }, we can make a drawing looking 
like figure \ref{otherxfigdemo}.

\begin{figure}
\label{otherxfigdemo}
\setlength{\unitlength}{947sp}%
%
\begingroup\makeatletter\ifx\SetFigFont\undefined%
\gdef\SetFigFont#1#2#3#4#5{%
  \reset@font\fontsize{#1}{#2pt}%
  \fontfamily{#3}\fontseries{#4}\fontshape{#5}%
  \selectfont}%
\fi\endgroup%
\begin{picture}(3462,3849)(1276,-3748)
\thinlines
\put(3151,-2386){\oval(1500,1650)}
\put(1651,-3736){\framebox(3075,2700){}}
\put(1651,-1036){\line( 5, 6){952.869}}
\put(876,-1036){\makebox(0,0)[lb]{\smash{\SetFigFont{29}{34.8}{\rmdefault}{\mddefault}{\updefault}$\phi$}}}
\end{picture}
\caption{A typical figure from Xfig.}
\end{figure}


\subsection{xv}

{\tt xv} is where you go just to have a brief look at an
image, or to rescale it, crop it or correct  the colors. 
It does not need much of an introduction further
than that given in the previous section. 
I will just point to any beginner that he should at some point
open an image with {\tt xv} and open the color editor window
and play some. {\tt xv} makes for a good poor man's photo color
correction laboratory.

\subsection{The Gimp}

\begin{figure}
\label{conifer}
\includegraphics[scale=0.33]{graphics/conifer.eps}
\caption{A very minor GIMP demo.}
\end{figure}

The GIMP is a full featured image creation and manipulation
program, close to Adobe Photoshop in its capabilities.
 It is also well-documented both in its help 
files and \footref{http://www.gimp.org}{on the Web.} 
There is a book {\it Grokking the GIMP} available 
in stores and \footref{http://gimp-savvy.com/BOOK/index.html}{online,}
as well as 
\footref{http://empyrean.lib.ndsu.nodak.edu/\~{}nem/gimp/tuts/}{many tutorials}
and \footref{http://gug.sunsite.dk/?page=tutorials}{plenty more} 
out there that is only a Google search away. 
Typing {\tt add graphics; gimp \& } is all you have to do to
get started. 

The GIMP's simplest tool is the crop tool, which lets you cut out 
arbitrarily shaped elements of an image and paste or manipulate them.
It is a good starting point for playing with this versatile program. 
The most complicated tool is the embedded scripting langiage, which 
allows you to automate arbitrary image manipulations with relative
ease. 

\subsection{dia}

{\tt dia} lives in the dia locker, and is a very full featured
diagram editor, written and 
\footref{http://www.lysator.liu.se/\~{}alla/dia/}{maintained in Sweden by 
the fellows at the Lysator site.}
 It contains premade symbols for many of the 
contexts in which you might have to make one of these, including
electronic circuits, civil engineering plans, flow charts, UML
plans, and more. Click on ``chronogram'' to see the alternatives
available. It has its own formats for saving work, but also saves in
the Xfig format, (see above) and in a Tex related format.
After you lay some elements on your {\tt dia} canvas, you 
can move the points that define them in order to connect the 
elements together. The program will then let you move elements
around while keeping hold of the topology you connected together. 

\begin{figure}
\includegraphics[scale=0.3]{graphics/sillydiacircuit.eps}
\caption{A small {\tt dia} demo.}
\end{figure}

\subsection{tgif}

{\tt tgif} is another vector drawing utility,
\footref{http://bourbon.usc.edu:8001/tgif/}{maintained at USC} 
 with heterodox ideas on how to write a user interface. 
It is also not actively maintained\footnote{Internal SIPB  note: this needs to change}. Nevertheless, 
you may find it to your liking, partly because it is the 
most convenient tool for combining schematic drawing
with free-hand elements. It lives in the {\tt sipb} locker. 


\subsection{Applix Graphics and Star Office}

Sometime you might find yourself unable to 
use the programs above and need to improvise.
Hence this section.
When you start Applix, from the Athena menu or by 
typing {\tt add applix; applix \&} you can go to the 
graphics tool from the star menu. This program 
is slightly idiosyncratic, and it is meant for 
making slides, mostly, but it will serve in a 
pinch. The stroke button is what you use for freehand
sketching. You can save the image as Jpeg, GIF, or
PNG, among others. 

Star Office, on the other hand, is much nicer 
to draw with, but then doesn't give you an easy 
way to save your work. That is where the PrintScreen
button rushes to the rescue. Again, if no other tools
are available, you can draw a graphic in star office, 
hit PrintScreen, and later crop the screen dump with {\tt xv}.

\subsection{bitmap}

{\tt bitmap} is a utility for editing XBM (X Bit Map) files 
for writers of X Windows applications. You probably won't
need if for anything. 

%\subsection{Utah Raster Toolkit}
%\subsection{autocad}
%\subsection{Pro-Engineer}
%\subsection{Studio}
%\subsection{capture}
%\subsection{geomview}
