Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

mkfontdir

Create font server index files

Syntax:

mkfontdir [options]

Runs on:

Neutrino

Options:

-b
Backup the old fontdir file before overwriting.
-d dir
Directory containing font files (the default is ${PHOTON_PATH}/font_repository/).
-f pattern
Construct details for this font pattern only (the default is to scan the directory).
-i file
The name of the font index file (the default is fontdir in the font file directory).
-m file
The name of the font name mapping file (the default is mappings in the font file directory).
-s
Sort the resultant index file.

Description:

The mkfontdir utility builds an index file for the fonts in a directory. This index contains information such as the name and type of each font, its size and style, a textual description of the font family, and the range of characters defined within the font. To be available to an application, at least one font must be defined in this configuration file.


Note: If you are using mkfontdir under Linux or Solaris, you should make sure that your LD_LIBRARY_PATH environment variable includes the correct library paths. As well, because these operating systems have with their own version of mkfontdir, you need to start the utility with the full path to start the QNX version.

The paths for these operating systems are:

  • Solaris:
    • LD_LIBRARY should include /opt/qnx630/host/solaris/sparc/usr/lib
    • Run using /opt/qnx630/host/solaris/sparc/usr/bin/mkfontdir
  • Linux:
    • LD_LIBRARY should include /opt/qnx630/host/linux/x86/usr/lib
    • Run using /opt/qnx630/host/linux/x86/usr/bin/mkfontdir

Examples:

Create an index file called my_fontdir in the current working directory:

mkfontdir -i ./my_fontdir -d ${PHOTON_PATH}/font_repository

Create an index file called my_fontdir in the ${PHOTON_PATH}/font_repository directory:

mkfontdir -i my_fontdir -d ${PHOTON_PATH}/font_repository

Files:

${PHOTON_PATH}/font_repository/fontdir
The index files for the fonts.

Environment variables:

PHOTON_PATH
The name of the root directory containing Photon files.

Exit status:

0
Success.
-1
An error occurred; an error message is displayed.