[Previous] [Contents] [Index] [Next]

mkfontsys

Font Server system configuration tool

Syntax:

mkfontsys [-FfIilv] [-d font_dir] target_dir [source_dir]

Options:

-d font_dir
Directory containing the font files (default is /usr/photon/font).
-F
Use if target_dir is on a Flash filesystem.
-f
Launch the fontcfg utility to allow font system configuration. Refer to the fontcfg utility documentation for configuring a font system. Photon must be running to invoke this utility.
-I
Display the sample invocation command to start the font server for the configuration in the source directory. The current configuration files are examined to produce the command line; no updating or file manipulation is performed.
-i
Display the sample invocation command to start the font server based on the resulting configuration - this is the final line of the output and may be used in the embedded system Photon startup script.
-l ("el")
Link the font files (.phf, .pfr) to the target directory, and copy the configuration files (fontdir, fontmap, fontext, fontopt) into the target directory. Note that if the target directory is intended as a standalone system, then the font files must also be copied.
-v
Verbose mode - display what action is being performed for each file create/copy/link operation.
source_dir
Name of the directory (default is /usr/photon/font) where the global font configuration files (and possibly the font files) reside.
target_dir
Name of the directory where the customized configuration files will reside.

Description:

The mkfontsys utility is a convenient tool for customizing the font environment of an embedded system. With this utility you can:

If your target directory is empty, the font configuration and font files are copied from the source directory. However, if the -d option is specified, the font files are copied from the directory specified, and the font configuration files are copied from the source directory.

If the target directory already has configuration files, no files are copied, but fontcfg is invoked so that you can edit your configuration files.

Examples:

Consider making a font system for an embedded image based at /usr/EKit/bsp/amd/build/root. Assume that this is the current directory. Make the font subdirectory:

mkdir -p my_directory/font

From the subdirectory, invoke the font configuration tool:

mkfontsys -fi mydirectory/font

This copies the initial configuration from the global directory /usr/photon/font into the target subdirectory. It then launches fontcfg so that you can customize your font configuration. After editing, save the configuration. This writes the changed configuration files and returns to mkfontsys.

Next, the fontdir file is examined. Any font files (.phf, .pfr) referenced are copied into the target subdirectory (and any files in that directory no longer used are removed).

Finally, it determines and displays the most efficient font server for your needs based on the bitmap or scalable fonts you chose. For example:

phfontpfr -b150k -A &

For more information about font servers, see phfont as well as the section "Step 4. Start font manager" in the Photon in Embedded Systems chapter.

See also:

fontcfg,
mkffs in QNX 4 to QNX 4/Neutrino Development Utilities Reference,
phfont


[Previous] [Contents] [Index] [Next]