xglyph
commandline is
xglyph [options] [fontfile1 [fontfile2 [...]]]If no options and no font files are specified on the commandline
xglyph
reads the fonts from the font database file. The details depend on which
configuration file is found and on this file's contents. If at least one font
file is specified on the commandline, the font database--being existent and
accessible or not--is ignored and the database is built using the fonts from
the commandline. fontfile1
is assigned the font ID 0, fontfile2
is assigned the ID 1 and so forth. Files that cannot be opened for some reason
are simply skipped.
xglyph
also recognizes a few options. Notice that these options are not
intended for an average user. Rather, they provide a means of (a) controlling
debugging output from the rasterizer, (b) controlling generation and verbosity
of the t1lib-logfile, (c) disabling certain features of the rasterizer and
(d) checking some t1lib functions which otherwise would not be required
because of the limited functionality of xglyph
.
All commandline arguments that start with ``--
'' are considered to be
options to xglyph
. The following is a complete list of valid options
and a brief description of their effect:
--help
: Display the commandline syntax of xglyph
as well as
a brief list of the available options for an average user and exit.
--Help
: Display the commandline syntax of xglyph
as well as
a brief list of all available options.
--noGrid
: The cross-hairs marking start and end position of a
glyph in the output of one of the X11 rastering functions will be
suppressed. This might be useful at small sizes because the grid overwrites
the glyphs' pixels.
--setPad
: The padding value xglyph
should use can be
specified here. This has to be followed by either ``8'', ``16'' or ``32'',
separated by a space. Notice that the value ``32'' might be rejected as
described in --logError
:
--logWarning
:
--logStatistic
:
--logDebug
: These options firstly instruct xglyph
to create
a t1lib logfile and secondly set the loglevel to the respective value
(see --ignoreForceBold
: Instructs the rasterizer to ignore a ForceBold hint in the Type 1 font file.
--ignoreFamilyAlignment
: Instructs the rasterizer always to
compute font level alignment according to BlueValues
and
OtherBlues
, even if FamilyBlues
and
FamilyOtherBlues
exist and all conditions for substitution are fulfilled for that combination
of font and size.
--ignoreHinting
: Instructs the rasterizer to omit hinting completely.
--ignoreAFM
: The use of AFM information is ignored, no matter
whether it could be accessed via an appropriate AFM file or
self-generated. When using this option the string functions would not
work. It may, however, be useful because self-generation of AFM data fails
as soon as at least one character of all defined characters can not be
processed and thus, the font will refuse to load. Using this option,
consequently, one has access to all character that are processible, e.g.,
for generating a font table.
characters that can be rasterized
--debugLine
:
--debugRegion
:
--debugPath
:
--debugFont
:
--debugHint
: All these instruct the rasterizer to write particular
debug messages from intermediate steps of rasterization to the terminal. In
order to understand and interprete them, a thorough understanding of the
Type 1 font format specification and this special rasterizer implementation
is crucial.
--checkPerformance
: This option affects the X11 string rastering
functions. An additional output window is created and the output of
before-mentioned functions is directly written into this window. Note that
this window is not managed as might be expected. Text is only drawn at the
visible parts and after partially or completely hiding and again
raising the respective areas are lost. This mechanism should simply give an
idea of how fast the X11 rastering function work, admittedly a critical
topic in t1lib.
--checkCopyFont
: This option is used to check the proper
functioning of the T1_CopyFont()
function. It copies all fonts from
the database to new logical fonts and slants these fonts by 0.3. Finally an
additional fontfile is added to the database. For each step the new font ID
is printed to the terminal and the initial and final number of fonts are
printed.
--checkConcatGlyphs
: This option affects the buttons
and
. The requested string glyph is generated
twice, first time using the current value of font ID and second time using
this
values plus 1. Both resulting glyphs are concatenated and the result is
shown in the output window.
--checkConcatOutlines
: This option, too, affects the standard
string rastering functions. The current test string will be fetched as an
outline using the current font ID. The result is then concatenated with a
horizontal movement of 1000 charspace unit which is followed by the
identical string using a font ID advanced by 1. The result of the
concatenated outlines is then filled and converted to a t1lib-glyph.
For details on outline handling and what it is meant for see
When --checkConcatGlyphs
and --checkConcatOutlines
both are
specified on commandline, the --checkConcatGlyphs
is respected.
--checkBadCharHandling
: This option provides a means of
examining the effects of problematic/bad characters on string handling in
t1libwith xglyph
. It affects only the
button.
The character to be specified in the test character field is inserted in
the middle of the test string. This enables the user to insert arbitrary
character codes in the middle of a test string and to watch the effect in
T1_SetString()
. For example, starting xglyph
with this
option exclusively and immediately clicking
will show
the string TeAt in the output window because the character `s' has
been overwritten by character (`A'), the default test character.
--checkDefaultEncoding
: This option proves that the default
encoding feature works correct. If set, all fonts should be encoded in
IsoLatin1 encoding immediately after startup and without any slow down at
startup.
--checkSmartAntialiasing
: Enables smart antialiasing as described
in --checkAACaching
: This option enables caching of antialiased
character glyphs. For a discussion of this issue see --checkSetRect
: This option allows to check the rectangle drawing
functions of t1lib. If specified, the character drawing buttons will
produce an em unit square of the current font instead of the expected
character.
--cacheStrokedGlyphs
: If this option is specified, xglyph
will cache stroked glyphs whereas filled ones are not cached.
-display
'',
xglyph
does not support these. The widgets are built straight ahead and
the layout is fixed. xglyph
is meant to be a tool for testing some of
the functionalities of t1lib and nothing more. Of course, a display other
than localhost:0.0
may be specified by environment variable
DISPLAY
.