FAMILY

FAMILY [ “family-name” ] {
aspect-ratio = “description”, screen-font-file
“font-description” = orient, [ download-file ] [, PFM-file ]
.
.
.
}

The FAMILY statement defines the screen-font files associated with one or more downloadable files. The statement names a font family and provides one or more sets of aspect-ratio and font-description parameters defining these associations.

Parameters

family-name

Specifies a general description of the font family. If this parameter is given, it must be enclosed in double quotation marks.

aspect-ratio

Specifies the width and height of the screen font in lines-per-inch. This parameter has the following form:

width:height

More than one aspect ratio may be listed by separating each with a comma.

description

Specifies a string identifying the font and other information, such as the device for which the font was designed. This string should be identical to the text that immediately follows the colon (:) in the DESCRIPTION statement of the font-resource file. Note that Control Panel also uses the DESCRIPTION statement to create an entry for the font under the [Fonts] section in the WIN.INI file. The parameter must be enclosed in double quotation marks.

screen-font-file

Specifies the name and location of the screen-font file. This parameter should consist of a logical disk identifier (as given in a preceding DRIVE statement) and the filename of the screen-font file. If the file is not in the root directory on the given disk, the full path of the file should be used.

font-description

Specifies the name displayed in the Printer Font Installer's list box. This parameter should have the following form:

face-name point-size [bold] [italic]

The face-name should be the exact name for the font. The point-size should be the font's point size in decimal, immediately followed by the word “points” or the abbreviation “pt”. The words bold and italic should be used only if the font has those attributes.

The parameter must be enclosed in double quotation marks.

orient

Specifies the font's orientation (portrait or landscape). This parameter is either P (or p) for portrait orientation or L (or l) for landscape orientation. PL or LP may be used to indicate either orientation.

download-file

Specifies the name and location of the downloadable font file. This parameter should consist of a logical disk identifier (as given in a preceding DRIVE statement) and the filename of the downloadable font file. If the file is not in the root directory on the given disk, the full path of the file should be used.

Although the download-file parameter is optional, the commas preceding and following it are not. If this parameter is omitted, the PFM-file parameter must be present.

PFM-file

Specifies the name and location of the printer font metrics file. This parameter should consist of a logical disk identifier (as given in a preceding DRIVE statement) and the filename of the downloadable font file. If the file is not in the root directory on the given disk, the full path of the file should be used.

The PFM-file parameter is optional. Although the Printer Font Installer will generate a PFM file if the parameter is omitted, this approach is discouraged because PFM files generated this way may be less accurate than PFM files created by the font manufacturer.

Comments

If the installer fails to find a font having the same resolution as the display device but finds fonts with matching aspect ratios, the installer installs the font whose resolution is less than or equal to the desired resolution. (If there is no resolution less than or equal to the desired resolution, then it chooses the lowest resolution.) If there is no screen font with a matching aspect ratio, the installer installs no screen fonts.

Examples

FAMILY [ "" ] {

96:96 = "Courier 8,10,12", disk1:cour03.fon

"Courier 8pt bold italic"=LP,disk1:cour08bi.usp,disk1:cour08bi.pfm

}