xgridfit (1) - Linux Man Pages

xgridfit: a program for gridfitting, or "hinting," TrueType fonts

NAME

xgridfit - a program for gridfitting, or "hinting," TrueType fonts

SYNOPSIS

xgridfit [options] file.{xgf or xml}...

DESCRIPTION

Xgridfit is a simple program that implements an XML-based language for gridfitting, or "hinting," TrueType fonts. It compiles an XML source file into tables and instructions that relate to the gridfitting of glyphs. Xgridfit does not insert these elements into a font itself, but rather relies on FontForge, the Open Source font editor, to do this.

For each input file specified on the command line, the xgridfit command generates a script named file.pe. You may run this script in FontForge thus:

 $ fontforge -script file.pe

Alternatively, you can skip generation of a script file and pipe Xgridfit's output directly to FontForge:

 $ xgridfit -f file.xgf

For more information about Xgridfit, point your browser to file:///usr/share/doc/xgridfit/html/index.html or http://xgridfit.sourceforge.net

OPTIONS

Note that options that set TrueType values can also be specified by "default" elements in the program file. However, command-line options always override these defaults.

-a value

Size of TrueType stack (default is 128)

-b value

Delta Break value: formerly the maximum number of delta pairs that could be placed on the stack with a single push instruction. As of version 1.11 it approximates that behavior by setting -p option to twice the specified value. This option has no effect in Python mode (option -l py).

-c yes|no

Compile functions, control values, pre-program and maxp entries (default is "yes")

-C gray|black|white

Use this color for rounded distances except where specified otherwise (default is "gray").

-d

Run in debug mode. Output is file.debug rather than file.pe

-f

Pipe generated script to FontForge. Do not save it in a file. This option overrides -O, and it is incompatible with -d, -S and -z.

-g glyph

Compile only the specified glyphs, ignoring all others. The argument is a list of one or more glyph names, delimited by plus signs ("+"). The list must contain no spaces.

-G yes|no

Include or omit at the beginning of each glyph program a function call that initializes variables used to track the graphics state. The default is "yes." This option can be overridden with the init-graphics attribute on any glyph element.

-h

Display a help message and exit.

-i file

File to be input by generated script. Must have extension .sfd or .ttf

-l py|ff

Whether the output of Xgridfit should be a Python script or one in the native FontForge scripting language. The default is ff

-o file

File to be output by generated script. Must have extension .sfd or .ttf

-O file

Name of script file to be output by Xgridfit, rather than the default, which replaces .xgf in the input file with .pe

-p value

The number of values that can be pushed with a single PUSHB or PUSHW instruction. The default is 20, except in Python mode, where the default is 255.

-q

Run in quiet mode. Routine messages are suppressed

-s value

Maximum places in TrueType storage area. This area is used to store variables, and also Xgridfit's own run-time data. The number must always be 24 or greater

-S name

Save script for each glyph in a separate file named name_glyph-name.pe or name_glyph-name.debug

-t value

Maximum number of points in Twilight zone. The default is 25, but few fonts require so many

-T file

Name of a temporary file in which to store result of XInclude processing: the compiler and/or validator is run against this file. If this option is used, the file is not deleted after processing; if it is not used, the file (named by Xgridfit) is deleted. This option is ignored when the selected processor or validator has XInclude capabilities or when XInclude is not used. If a file by this name already exists, it is renamed as file.bak before processing.

-v

Print version number and exit

-V

Validate the Xgridfit program against a schema before compiling. Compilation is performed only if validation suceeds. By default xmllint is used for validation; run xgfconfig to choose another validator.

-x

Do not compile. Validation is performed if requested via the -V option.

-z file

When the -S option is present and the -o option or the <outfile> element has been used to make the output script save a font or FontForge source file, the output of the <outfile> script is saved in a separate script file. Xgridfit will supply a default name for this file, but this option lets you supply your own name.

FILES

/usr/share/xgridfit/lib/*.xsl

All XSLT scripts of the Xgridfit program.

AUTHOR

xgridfit was written by Peter Baker <psb6m [at] virginia.edu>.

This manual page was written by Kestutis Biliunas <kebil [at] kaunas.init.lt>, for the Debian project (but may be used by others). Revised and OPTIONS section added by P. Baker.