�graph — Quick Reference

H.-W. Kisker

Westfälische Wilhelms-Universität

Universitätsrechenzentrum Einsteinstr. 60 D-4400 Münster

Germany February 1991

Purpose The program �graph converts monochrome grafic files to a TEX PXL file. Each PCX file is mapped to a character of the font.

Input To work properly �graph must be supplied with one or more PCX files and metric data for the characters of the font.

Output �graph will create several files as output:

• a PXL file (containing the character maps),

• a TFM file (containing the metric data),

• a TEX file (containing TEX commands related to the characters of the font) and

• a logfile (containing information about the program run).

�graph supports two grafic formats:

Supported Grafic Formats

• ADI printer file from AutoDesk and

• the monochrome PCX file from ZSoft.

�graph can run under MS-DOS Version 3.00 (or later) or OS/2 Version 1.00 (or Operating Systems

later).

Options

�graph is called in the normal way:

RUMgraf option …

The term option starts with one of the characters / or -, immediately followed by an alphabetic character – the option name. In most cases the option name is succeded by a string – the option value. Option name and value can be delimited by one of the characters : or =; a blank however is not allowed. An option value, which contains a blank (or other special characters), must be surrounded by a pair of " characters. Each option term which does not start with a / or - is treated as a comment.

The option names are devided into three groups.

\underline{2 �graph}

• The first group contains all parameters belonging to the entire font (e.g. resolution).

• 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.

• The third group consist of just one option – the m option. This option points to a so called makefile which contains additional option terms.

Group 1: Font Options

/P /P:ident

The p option specifies an identification for several picture related files:

• the name of the PXL file (ident.PXL),

• the name of the TFM file (ident.TFM),

• the name of the TEX files (ident.TEX) and

• the name of the logfile (ident.RGL). The value of ident must consist of one to eight alphabetic characters. Example: /P:GLYPH

/R /R:resolution The r option specifies the resolution of the bitmap. Unit: dpi (= dots per inch) Example: /R:300

Group 2: Character Options

/C /C: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: /C:A or /C:65

/N /N: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. Example: /N:Aleph \underline{�graph 3}

/T /T:type The t option specifies the grafic format of the input file for the character (PCX or ADI. Example: /T:PCX

/F /F:filename The f option determines the pathname of the file, which will be used for the creation of the character. Example: /F:aleph.pcx

/D /H /W /D:depth /H:height /W:width The metric data for the TFM file will be determined by the d option (depth), the h option (height) and the w option (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. Unit: pt (1 inch = 72.72 pt) Example: /W:20 /H:24 /D:8

/X /Y /X:Xoffset /Y:Yoffset 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: /X:–5 /Y:22

/S /S:count �graph 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: /S:10

/I /I Specifying the i option will reverse the input bitmap. Example: /I

Group 3: Makefile

/M /M:makefile The m option specifies a makefile which contains additional option terms. Example: /M:Glyph.m