xgfmerge(1) [debian man page]
XGFMERGE(1) General Commands Manual XGFMERGE(1) NAME
xgfmerge - merges two Xgridfit program files SYNOPSIS
xgfmerge [options] file-a file-b [...] DESCRIPTION
Xgfmerge merges two or more Xgridfit program files, where file-a is a program generated automatically from an existing font using TTX and ttx2xgf, and file-b and any other files in the list contain other programming for the font. Xgfmerge outputs the merged programming to stdout. To capture the output in a file, use this syntax: $xgfmerge -o merged-file.xgf file-a.xgf file-b.xgf Note: To merge Xgridfit instructions with those already in a font, the best method is now to run Xgridfit in merge-mode (option -m). OPTIONS
-c Look for a <default type="compile-globals"/> element in each file after the first in the list. If value="no" then ignore all <default>, <control-value>, <function>, <macro> and <pre-program> elements in the file. -h Display a help message. -n Merge <no-compile> elements from all files. <glyph> elements with duplicate "ps-name" attributes are ignored. -o file The file to write the output to. If this option is not used, output is written to stdout. -p When a <pre-program> element in a file other than file-a is available, use it instead of the one from file-a. If this option is not present, xgfmerge merges the programming in the <pre-program> of file-a with that in the <pre-program> of whichever file is being merged at the moment. The result is unlikely to be good if a single run of xgfmerge merges the contents of more than two <pre- program> elements. -s Sort <glyph> elements in the output file into alphabetical order. -v Verbose output: xgfmerge tells you what it is doing at each step. -x Resolve XIncludes before merging all files in the list except for file-a. Any XIncludes from file-a.xgf are stripped out of the files before this operation is performed. If XInclude is used to bring global elements (<control-value>, <function>, etc.) into these files, it is probably a good idea to use the -c option as well. FILES
/usr/share/xml/xgridfit/util/merge.xsl An XSLT script that performs the merge. /usr/share/xml/xgridfit/util/xinclude.xsl An XSLT script that strips out unwanted XIncludes. /usr/share/xml/xgridfit/util/sort-glyphs.xsl An XSLT script that sorts glyph elements in a file. /usr/share/xml/xgridfit/utils/add-blanks.sed Does some formatting of the output. SEE ALSO
xgridfit(1), ttx(1), ttx2xgf(1). AUTHOR
Xgfmerge was written by Peter Baker <psb6m@virginia.edu>. This manual page was written by Peter Baker 2009-12-18 XGFMERGE(1)
Check Out this Related Man Page
TTX(1) BSD General Commands Manual TTX(1) NAME
ttx -- tool for manipulating TrueType and OpenType fonts SYNOPSIS
ttx [option ...] file ... DESCRIPTION
ttx is a tool for manipulating TrueType and OpenType fonts. It can convert TrueType and OpenType fonts to and from an XML-based format called TTX. TTX files have a '.ttx' extension. For each file argument it is given, ttx detects whether it is a '.ttf', '.otf' or '.ttx' file and acts accordingly: if it is a '.ttf' or '.otf' file, it generates a '.ttx' file; if it is a '.ttx' file, it generates a '.ttf' or '.otf' file. By default, every output file is created in the same directory as the corresponding input file and with the same name except for the exten- sion, which is substituted appropriately. ttx never overwrites existing files; if neccesary, it appends a suffix to the output file name before the extension, as in Arial#1.ttf. General options -h Display usage information. -d dir Write the output files to directory dir instead of writing every output file to the same directory as the corresponding input file. -v Be verbose. Write more messages to the standard output describing what is being done. -a Allow virtual glyphs ID's on compile or decompile. Dump options The following options control the process of dumping font files (TrueType or OpenType) to TTX files. -l List table information. Instead of dumping the font to a TTX file, display minimal information about each table. -t table Dump table table. This option may be given multiple times to dump several tables at once. When not specified, all tables are dumped. -x table Exclude table table from the list of tables to dump. This option may be given multiple times to exclude several tables from the dump. The -t and -x options are mutually exclusive. -s Split tables. Dump each table to a separate TTX file and write (under the name that would have been used for the output file if the -s option had not been given) one small TTX file containing references to the individual table dump files. This file can be used as input to ttx as long as the referenced files can be found in the same directory. -i Don't disassemble TrueType instructions. When this option is specified, all TrueType programs (glyph programs, the font program and the pre-program) are written to the TTX file as hexadecimal data instead of assembly. This saves some time and results in smaller TTX files. -y n When decompiling a TrueType Collection (TTC) file, decompile font number n, starting from 0. Compilation options The following options control the process of compiling TTX files into font files (TrueType or OpenType): -m fontfile Merge the input TTX file file with fontfile. No more than one file argument can be specified when this option is used. -b Don't recalculate glyph bounding boxes. Use the values in the TTX file as is. THE TTX FILE FORMAT
You can find some information about the TTX file format in documentation.html. In particular, you will find in that file the list of tables understood by ttx and the relations between TrueType GlyphIDs and the glyph names used in TTX files. EXAMPLES
In the following examples, all files are read from and written to the current directory. Additionally, the name given for the output file assumes in every case that it did not exist before ttx was invoked. Dump the TrueType font contained in FreeSans.ttf to FreeSans.ttx: ttx FreeSans.ttf Compile MyFont.ttx into a TrueType or OpenType font file: ttx MyFont.ttx List the tables in FreeSans.ttf along with some information: ttx -l FreeSans.ttf Dump the 'cmap' table from FreeSans.ttf to FreeSans.ttx: ttx -t cmap FreeSans.ttf NOTES
On MS-Windows and MacOS, ttx is available as a graphical application to which files can be dropped. SEE ALSO
documentation.html fontforge(1), ftinfo(1), gfontview(1), xmbdfed(1), Font::TTF(3pm) AUTHORS
ttx was written by Just van Rossum <just@letterror.com>. This manual page was written by Florent Rougon <f.rougon@free.fr> for the Debian GNU/Linux system based on the existing FontTools documenta- tion. It may be freely used, modified and distributed without restrictions. May 18, 2004