xgridfit (1) - Linux Man Pages
xgridfit: a program for gridfitting, or "hinting," TrueType fonts
- a program for gridfitting, or "hinting," TrueType fonts
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.
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
command generates a script named
You may run this script in
$ 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
point your browser to
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").
Run in debug mode. Output is
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.
Display a help message and exit.
- -i file
File to be input by generated script. Must have extension
- -l py|ff
Whether the output of Xgridfit should be a Python script or
one in the native
FontForge scripting language. The default is
- -o file
File to be output by generated script. Must have extension
- -O file
Name of script file to be output by Xgridfit, rather than the
default, which replaces
in the input file with
- -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.
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
- -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
Print version number and exit
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.
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.
All XSLT scripts of the
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.