Customized Font Management

For PCL printers, Unidrv supports downloading soft fonts as bitmaps or TrueType outlines. For device fonts, Unidrv supports PCL, CAPSL, and PPDS printer command formats. For other formats, customized font management code must be provided in a rendering plug-in. The following set of IPrintOemUni methods can be implemented:

IPrintOemUni::DownloadFontHeader

Used to obtain a soft font's header information from Unidrv and then download the information to the printer.

IPrintOemUni::DownloadCharGlyph

Used to download a soft font's character glyphs to the printer.

IPrintOemUni::OutputCharStr

Used to control the printing of characters.

IPrintOemUni::SendFontCmd

Used to modify a printer's device font selection command, and if necessary, send it to the printer.

IPrintOemUni::TextOutAsBitmap

Used to create a bitmap image of a text string.

IPrintOemUni::TTDownloadMethod

Used to specify the glyph format that the Unidrv should use when it sends a specified soft font to the printer.

Unidrv provides a callback function, UNIFONTOBJ_GetInfo, that rendering plug-ins can call to obtain font or glyph information.

For device fonts, font descriptions must be provided as explained in the Unidrv font metrics files section and the Glyph translation table files section.

For cartridge fonts, font descriptions can be provided in resource DLLs and specified using font cartridges entries in a GPD file. Font descriptions can also be provided in the form of Unidrv font format files.

For downloadable PCL soft fonts, font descriptions must be provided as explained in the Unidrv font format files section.

Unidrv Font Metrics Files

Each device font that a printer supports must be represented by a Unidrv Font Metrics (.ufm) file. A .ufm file is a binary file that is constructed using the structures described in Unidrv Font Metrics Structures. The first structure in a .ufm file is UNIFM_HDR, which contains offsets to the file's other structures. The following figure shows the layout of a Unidrv Font Metrics file.

Diagram illustrating the layout of a Unidrv Font Metrics file

Unidrv also supports .ifi files, the font metrics files created for Windows NT 4.0.

Glyph Translation Table Files

Each device font that a printer supports must be represented by a Glyph Translation Table (.gtt) file. A .gtt file is a binary file that is constructed using the structures described in Unidrv Glyph Translation Table Structures. The first structure in a .gtt file is a UNI_GLYPHSETDATA structure, which contains offsets to the file's other structures.

The following figure shows the layout of a glyph translation table file.

Diagram illustrating the layout of a glyph translation table file

In the preceding figure, the UNI_GLYPHSETDATA structure contains the offsets from the beginning of the file to the first GLYPHRUN structure, to the first UNI_CODEPAGEINFO structure, and to the MAPTABLE structure.

Unidrv also supports glyph translation files created for Windows NT 4.0, which use run-length encoding (RLE) compression and have an .rle extension.

Unidrv Font Format Files

For cartridge fonts that are not specified using font cartridges entries in a GPD file, the fonts must be described in a Unidrv Font Format (.uff) file. Additionally, downloadable PCL soft fonts must be specified using .uff files.

A .uff file is a binary file that is constructed using the following sets of structures:

The following figure shows the layout of a Unidrv Font Format file.

Diagram illustrating the layout of a Unidrv Font Format file

A Unidrv Font Format file consists of a UFF_FILEHEADER structure, and one or more UFF_FONTDIRECTORY and DATA_HEADER structure pairs. Each DATA_HEADER structure is associated with a block of font data. The UFF_FILEHEADER structure contains the offset from the beginning of the file to the first UFF_FONTDIRECTORY structure. Each UFF_FONTDRECTORY structure contains the offset from the beginning of the file to a DATA_HEADER structure that contains font data.

Additionally, for downloadable PCL soft fonts, the binary data to be downloaded is stored in a .uff file.

.uff files creation is the responsibility of vendor-supplied font installation software. Unidrv reads a printer's .uff files to obtain font and glyph information. The font installer should modify .uff file contents when fonts are added or deleted. For more information about creating a font installer, see Customized Font Installers for Unidrv.

All .uff files must be stored in the %SystemRoot%\System32\Spool\Drivers\Unifont directory. To associate individual .uff files with specific printers, installation software must call the SetPrinterData function (described in the Windows SDK documentation) to create registry values under each printer's registry key. The following table lists the registry value names that must be used, and indicates the maintainer of each value.

Registry Value Name and TypeValue DefinitionMaintainer

"ExternalFontFile"

REG_SZ

Filename of a .uff file that specifies the current installed fonts. Fonts can be downloadable or contained in a cartridge.

Font Installer

"ExtFontCartFile"

REG_SZ

Filename of a .uff file that specifies all the fonts contained in all the font cartridges listed for "ExtFontCartNames".

Font Installer

"ExtFontCartNames"

REG_MULTI_SZ

Names of all the font cartridges that could possibly be installed on the printer.

Font Installer

"FontCart"

REG_MULTI_SZ

Names of all the font cartridges currently installed for the printer.

Unidrv user interface

 

After you add a font cartridge to a printer, the system administrator must run the font installer, which is responsible to copy font descriptions from the .uff file specified by "ExtFontCartFile" into the .uff file specified by "ExternalFontFile". Likewise, the font installer must remove font descriptions from the .uff file specified by "ExtFontCartFile" when a cartridge is removed.

 

 

Send comments about this topic to Microsoft

Anzeigen:
© 2014 Microsoft