\marginlabel{\bf Purpose}
%
The program \RUMgraph\ converts monochrome grafic files to a \TeX\ \PXL\ file.
Each \PCX\ file is mapped to a character of the font.
\marginlabel{\bf Input}
%
To work properly \RUMgraph\ must be supplied with one or more \PCX\ files and
metric data for the characters of the font.
\marginlabel{\bf Output}
%
\RUMgraph\ will create several files as output:
%
\begin{itemize}
\item a \PXL\ file (containing the character maps),
\item a \TFM\ file (containing the metric data),
\item a \TeX\ file (containing \TeX\ commands related to the characters of the
font) and
\item a logfile (containing information about the program run).
\end{itemize}
\marginlabel{\bf Supported Grafic Formats}
%
\RUMgraph\ supports two grafic formats:
%
\begin{itemize}
\item \ADI\ printer file from AutoDesk and
\item the monochrome \PCX\ file from ZSoft.
\end{itemize}
\marginlabel{\bf Operating Systems}
%
\RUMgraph\ can run under MS-DOS Version 3.00 (or later) or OS/2 Version 1.00 (or
later).
\section*{\Large \bf Options}
\RUMgraph\ is called in the normal way:
{\sf \hspace*{.5in} RUMgraf\ \ option\ \ \ldots}
The term {\em option} starts with one of the characters {\tt /} or {\tt
-}, immediately followed by an alphabetic character -- the {\em option
name\/}. In most cases the option name is succeded by a string -- the
{\em option value\/}. Option name and value can be delimited by one of
the characters {\tt :} or {\tt =}; a blank however is not allowed. An
option value, which contains a blank (or other special characters), must
be surrounded by a pair of {\tt "} characters. Each option term which
does not start with a {\tt /} or {\tt -} is treated as a comment.
The option names are devided into three groups.
\begin{itemize}
\item The first group contains all parameters belonging to the entire font (e.g.
resolution).
\item The options of the second group describe a single character (e.g. metric
data). A set of options can be specified for each character of the font . Such a
set starts with a c option, which determines a specific character. All following
options of the second group up to the next c options will be related to this
character.
\item The third group consist of just one option -- the m option. This option
points to a so called {\em makefile} which contains additional option terms.
\end{itemize}
\subsection*{Group 1: Font Options}
\marginlabel{\bf /P} {\sf /P:}{\em ident\/}
The p option specifies an identification for several picture related files:
\begin{itemize}
\item the name of the \PXL\ file ({\sf ident.PXL}),
\item the name of the \TFM\ file ({\sf ident.TFM}),
\item the name of the \TeX\ files ({\sf ident.TEX}) and
\item the name of the logfile ({\sf ident.RGL}).
\end{itemize}
The value of {\sf ident} must consist of one to eight alphabetic
characters.
Example: {\sf /P:GLYPH}
\vspace*{.1in}
\marginlabel{\bf /R} {\sf /R:}{\em resolution\/}
The r option specifies the resolution of the bitmap.
Unit: dpi (= dots per inch)
Example: {\sf /R:300}
\subsection*{Group 2: Character Options}
\marginlabel{\bf /C} {\sf /C:}{\em character\/}
The c option starts a set of options for a specified character. All following
options of group 2 up to the next c option will be related to this character.
The option value can be an alphabetic character or a number from 0 to 127.
Examples: {\sf /C:A} or {\sf /C:65}
\vspace*{.1in}
\marginlabel{\bf /N} {\sf /N:}{\em name\/}
The n option can be used to generate a \TeX\ command for the created \TeX\ file.
In a \TeX\ document this command will insert the related character -- i.e. the
picture -- in the output. The name can consist of an arbitrary number of
alphabetic characters.
The metric data for the \TFM\ file will be determined by the d option ({\em
depth\/}), the h option ({\em height\/}) and the w option ({\em width\/}).
For each missing option a default value is defined. The width is set to the
x size of the input bitmap, the height is set to the y size of the bitmap and
the depth is assumed as zero.
The x and y options determine the reference point of the character bitmap in
the \PXL\ file. By default the x offset is assumed as zero and the y offset ist
set to the vertical size of the input bitmap. The horizontal and vertical size
are extracted directly from the input bitmap.
Unit: pixel
Example: {\sf /X:--5 /Y:22}
\vspace*{.1in}
\marginlabel{\bf /S} {\sf /S:}{\em count\/}
\RUMgraph\ can distribute large pictures to several characters of the font. The
s option sets the number of pieces, the picture is to be split.
Example: {\sf /S:10}
\vspace*{.1in}
\marginlabel{\bf /I} {\sf /I}
Specifying the i option will reverse the input bitmap.
Example: {\sf /I}
\vspace*{.1in}
\subsection*{Group 3: Makefile}
\marginlabel{\bf /M} {\sf /M:}{\em makefile\/}
The m option specifies a makefile which contains additional option terms.
