Font Server system configuration tool
mkfontsys [-FfIilv] [-d font_dir] target_dir [source_dir]
- -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.
The mkfontsys utility is a convenient tool for customizing the font environment
of an embedded system. With this utility you can:
- create an initial set of configuration files in the appropriate target directory. Typically the global
font configuration files (fontdir, fontmap,
fontext, fontopt) and any font files (.phf, .pfr)
referenced by them are copied to your target directory.
- launch fontcfg so that you can customize your font configuration (-f).
You can install/uninstall font files as required, set memory cache options, add font mapping/aliases
to cover any common fonts you're not installing, etc.
- link any referenced .phf/.pfr files into the target directory (-l).
- determine the most efficient font server command for your system based on the font types you choose (-i) or (-I).
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.
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.
fontcfg,
mkffs in QNX 4 to QNX 4/Neutrino Development Utilities Reference,
phfont