type1.config(4)

type1/config -- X scalable font XLFD name configuration file for pointsizes

Synopsis

   /usr/X/lib/fonts/type1/config

Description

The type1/config file specifies a single option used by the Fonts (fontmgr) program of the UnixWare Desktop. This option allows pre-X11R5 applications to make use of Type 1 scalable outline fonts rendered by Adobe Type Manager^® (ATM^®), a standard part of UnixWare (note that the ATM renderer works with X's font server, not the X server itself, in the current UnixWare release).

The format of the single option is a name=value pair, where the value is a list of comma-separated numbers:

   derived-instance-pointsizes=list

The ability for X to use scalable outline fonts was added in the X11R5 release, via a change in the XLFD naming conventions. If the scalable fields of an XLFD name (PIXEL_SIZE, POINT_SIZE, and AVERAGE_WIDTH) are 0, the font is scalable to any pointsize.

However, older pre-X11R5 applications already exist that do not use this new XLFD convention for scalable names; they do not anticipate font names with a 0 pointsize and would not know how to use them. To allow these older applications to use scalable fonts, XLFD names for scalable fonts must exist that contain non-zero point sizes, which is what the applications are expecting.

The derived-instance-pointsizes option in the type1/config file is used to specify the set of point sizes for which these ``derived instance pointsizes'' are desired. The derived-instance XLFD names are created by the mkfontscale utility, according to the value of the DERIVED_INSTANCE_PS environment variable.

The mkfontscale program creates the XLFD names in the file fonts.scale in the directory containing Type 1 outline fonts; one XLFD name is created for each specified size, as well as for size 0, which indicates a scalable name. The mkfontdir program is then used to create the fonts.dir file from the fonts.scale file.

The Fonts application of the UnixWare Desktop runs the mkfontscale program, with the environment variable DERIVED_INSTANCE_PS set to the values defined in this file, when the Actions/Integrity Check menu item is chosen; this creates the XLFD names with the defined values, for the Type 1 fonts directory. Then it runs mkfontdir to copy the new fonts.scale file to fonts.dir, and xset fp rehash to make sure the X server is up-to-date with changes in its font directories. Finally, the Fonts application runs /usr/X/adm/fsfpreset to ensure that the font server updates its font information by re-reading its catalogue file.

Files

   /usr/X/lib/fonts/type1
   /usr/X/lib/fs/config
   /usr/X/defaults/Xwinconfig

Examples

   derived-instance-pointsizes=12,14,18,24

The default setting for this parameter is just the single value 14. This means that when mkfontscale runs via the fontmgr program, an XLFD name for the point size 14 will be generated for each Type 1 font, in addition to an XLFD name with the 0's expected for a scalable name. For example, the Adobe Type 1 font GoudyTextMT-Dfr is available as the file GXDFR___.pfa and contains these descriptive attributes:

   /FullName (Goudy Text MT Dfr) readonly def
   /FamilyName (Goudy Text MT) readonly def
   /Weight (Regular) readonly def
   /isFixedPitch false def
   /ItalicAngle 0 def
   /FontName /GoudyTextMT-Dfr def
   /Encoding StandardEncoding def

When mkfontscale is run on this file, it produces the following entries in a fonts.scale file:

   GXDFR___.pfa -adobe-Goudy Text MT-Regular-r-normal-dfr-0-0-0-0-p-0-iso8859-1
   GXDFR___.pfa -adobe-Goudy Text MT-Regular-r-normal-dfr-0-140-0-0-p-0-iso8859-1
   GXDFR___.pfa -adobe-Goudy Text MT-Regular-r-normal-dfr-0-0-0-0-p-0-iso8859-adobe
   GXDFR___.pfa -adobe-Goudy Text MT-Regular-r-normal-dfr-0-140-0-0-p-0-iso8859-adobe

Note the XLFD names with real point sizes (in decipoints: 140 is 14 points). Also note that mfontscale generates names for each character set encoding available in standard Adobe fonts, both iso8859-1 and an Adobe font-specific one assigned the value iso8859-adobe.

References

X(X1M), xlsfonts(X1), mkfontdir(X1M), xset(X1M)

Notices

Portions of this page are derived from material for which the copyright owner is Network Computing Devices, Inc. and the Massachusetts Institute of Technology. See copyright page for a full statement of rights and permissions.