Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
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.
 
Parameter         Description
────────────────────────────────────────────────────────────────────────────
 
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.
 
Example
 
FAMILY [ "" ] {
96:96 = "Courier 8,10,12", disk1:cour03.fon
"Courier 8pt bold italic"=LP,disk1:cour08bi.usp,disk1:cour08bi.pfm
}
 
 
                                      ♦