| 1 |
gbdfed 1.6 |
| 2 |
|
| 3 |
INTRO |
| 4 |
----- |
| 5 |
|
| 6 |
gbdfed is a GTK-based BDF font editor with the following features: |
| 7 |
|
| 8 |
o Multiple fonts can be loaded from the command line. |
| 9 |
o Multiple fonts can be open at the same time. |
| 10 |
o Cutting and pasting glyphs between fonts. |
| 11 |
o Multiple glyph bitmap editors can be open at the same time. |
| 12 |
o Cutting and pasting between glyph bitmap editors. |
| 13 |
o Export of XBM files from glyph bitmap editors. |
| 14 |
o Automatic correction of certain metrics when a font is loaded. |
| 15 |
o Generation of XLFD font names for fonts without XLFD names. |
| 16 |
o Update an XLFD font name from the font properties. |
| 17 |
o Update the font properties from an XLFD font name. |
| 18 |
o Font property editor. |
| 19 |
o Font comment editor. |
| 20 |
o Supports unencoded glyphs (ENCODING of -1). |
| 21 |
o Display of glyph encodings in octal, decimal, or hex. |
| 22 |
o Builtin on-line help. |
| 23 |
o Imports PK/GF fonts. |
| 24 |
o Imports HBF (Han Bitmap Font) fonts. |
| 25 |
o Imports Linux console fonts (PSF, CP, and FNT). |
| 26 |
o Imports Sun console fonts (vfont format). |
| 27 |
o Imports fonts from the X server. |
| 28 |
o Imports Windows FON/FNT fonts. |
| 29 |
o Imports OpenType/TrueType fonts and collections. |
| 30 |
o Exports PSF fonts. |
| 31 |
o Exports HEX fonts. |
| 32 |
|
| 33 |
A few things missing from this font editor: |
| 34 |
|
| 35 |
o No way to create space glyphs in monowidth or character cell fonts. |
| 36 |
o No support for scaling fonts. |
| 37 |
o Fonts with right-to-left direction (negative widths) not supported. |
| 38 |
o No way to edit comments appearing in the properties list. |
| 39 |
|
| 40 |
Known problems: |
| 41 |
|
| 42 |
o Selecting the original font editor from the "Windows" menu does not |
| 43 |
deiconify, set focus, and place it on top like it should. |
| 44 |
o Deleting glyphs from or inserting glyphs into a font grid do not update |
| 45 |
the glyph editors if they happen to be editing a deleted glyph or a glyph |
| 46 |
that moved due to an insertion. |
| 47 |
|
| 48 |
COMMAND LINE OPTIONS |
| 49 |
-------------------- |
| 50 |
gbdfed [options] [font1 font2 ...] |
| 51 |
|
| 52 |
-nc - do not preserve comments |
| 53 |
-nu - do not preserve unencoded glyphs |
| 54 |
-nm - do not make metrics corrections |
| 55 |
-np - do not pad character-cell bitmaps |
| 56 |
-bp - allow blank pages |
| 57 |
-ed - do not present the "Really Exit?" dialog |
| 58 |
-ps n - set default point size |
| 59 |
-hres n - set default horizontal resolution |
| 60 |
-vres n - set default vertical resolution |
| 61 |
-res n - set both default resolutions |
| 62 |
-sp s - set font spacing ("p" for proportional, "m" for monospace, |
| 63 |
or "c" for charcell). |
| 64 |
-eol e - set the default end-of-line char(s) ("u" for Unix, "d" for DOS, |
| 65 |
or "m" for Mac). |
| 66 |
-g code - set the initial glyph code (in decimal, hex or octal). |
| 67 |
-cb base - set the code base for display of glyph codes, can be "octal," |
| 68 |
"decimal," or "hexadecimal." The first letter of these names |
| 69 |
work as well. |
| 70 |
|
| 71 |
By default, gbdfed will set its point size to 12, the horizontal and |
| 72 |
vertical resolution to that of the display (e.g. 90x90 dpi for Sun's), and |
| 73 |
the font spacing to proportional. Also by default, gbdfed will preserve |
| 74 |
comments, preserve unencoded glyphs, and make metrics corrections when |
| 75 |
loading fonts. |
| 76 |
|
| 77 |
COMPILING |
| 78 |
--------- |
| 79 |
|
| 80 |
To build gbdfed, GTK 2.6 or greater is required. It may be that versions as |
| 81 |
early as 2.3 will work, but only various versions of 2.7 through 2.20 have been |
| 82 |
tested. |
| 83 |
|
| 84 |
Optional: |
| 85 |
|
| 86 |
Freetype2 support is optional and can be found at: |
| 87 |
|
| 88 |
http://www.freetype.org |
| 89 |
|
| 90 |
Step 1. |
| 91 |
|
| 92 |
Run the "configure" script to generate the Makefile. By default, the program |
| 93 |
installs in /usr/local. You can change that by using the --prefix option of |
| 94 |
the "configure" script. |
| 95 |
|
| 96 |
To disable the File->Import->X Server Font feature, use the --without-x |
| 97 |
command line option to the "configure" script. |
| 98 |
|
| 99 |
Step 2. |
| 100 |
|
| 101 |
Compile the program |
| 102 |
|
| 103 |
WARNINGS |
| 104 |
-------- |
| 105 |
|
| 106 |
1. When compiling on HP/UX, the htext.h file has long concatenated strings that |
| 107 |
require the -H option (noted by W. Chao). |
| 108 |
|
| 109 |
2. Compiling with the gcc -pedantic option complains about strings being too |
| 110 |
long in the help text file. The help system will be changed in later |
| 111 |
versions. |
| 112 |
|
| 113 |
ACKNOWLEDGEMENTS |
| 114 |
---------------- |
| 115 |
|
| 116 |
Thanks go to the following people: |
| 117 |
|
| 118 |
Ross Patterson for his HBF code. |
| 119 |
|
| 120 |
der Mouse for his "getbdf" code. |
| 121 |
|
| 122 |
K. Carothers and A. Korobka for their "fnt2bdf" code in Wine. |
| 123 |
|
| 124 |
Mike Stroyan <[email protected]> for patches. |
| 125 |
|
| 126 |
Primoz Peterlin <[email protected]> for the man page and |
| 127 |
some changes for building on HP/UX. |
| 128 |
|
| 129 |
Danny Backx <[email protected]> for the LessTif Imakefile. |
| 130 |
|
| 131 |
Donald Page <[email protected]> for patches. |
| 132 |
|
| 133 |
Michal Szymanski <[email protected]> for problem reports. |
| 134 |
|
| 135 |
Werner Lemberg <[email protected]> for pointing out a problem |
| 136 |
with the HBF code and other problem reports. |
| 137 |
|
| 138 |
William F. Maton <[email protected]> for pointing out a |
| 139 |
problem with padding character cell fonts. |
| 140 |
|
| 141 |
Ivan Nejgebauer <[email protected]> for reporting a problem with glyph |
| 142 |
names on imported console fonts. |
| 143 |
|
| 144 |
Solofo <[email protected]> for reporting a problem when creating an |
| 145 |
XLFD name. The old name was saved in the FONT property and some |
| 146 |
versions of "mkfontdir" use that instead of the first FONT field. Also |
| 147 |
for recommending that the Ctrl+F4 accelerator be configurable if |
| 148 |
it does not suit the user. |
| 149 |
|
| 150 |
Dave Bodenstab <[email protected]> for providing a patch for a problem |
| 151 |
with the HBF code that was not allowing gzipped HBF files to be |
| 152 |
loaded, and a patch to get rid of some extraneous code. Also a patch to fix |
| 153 |
some size problems with GlyphEditors. |
| 154 |
|
| 155 |
W. Chao <[email protected]> for providing the Makefile changes |
| 156 |
needed to compile on HP/UX and pointing out a problem with the builtin |
| 157 |
documentation. |
| 158 |
|
| 159 |
Andreas Reuter <[email protected]> for pointing out a problem |
| 160 |
with importing TrueType fonts. |
| 161 |
|
| 162 |
Leonard Dickens <[email protected]> for providing the Makefile |
| 163 |
changes needed for IRIX 6.3. |
| 164 |
|
| 165 |
Markus Kuhn <[email protected]> for a handful of good suggestions. |
| 166 |
|
| 167 |
Jim Knoble <[email protected]> for some geometry improvements in some |
| 168 |
dialogs. |
| 169 |
|
| 170 |
Darren Stuart Embry <[email protected]> for the donation of |
| 171 |
another HP/UX 10.20 X11R6 compilation setup. |
| 172 |
|
| 173 |
Vladimir Volovich <[email protected]> for pointing out something I forgot to |
| 174 |
test. |
| 175 |
|
| 176 |
Ben Fry <[email protected]> for IRIX 6.5.2 variables for the Makefile. |
| 177 |
|
| 178 |
J.H.M. Dassen (Ray) <[email protected]> for fixing bugs with the PK/GF |
| 179 |
import feature. |
| 180 |
|
| 181 |
Robert Brady <[email protected]> for pointing out a problem with the |
| 182 |
length of _XFREE86_GLYPH_RANGES properties and an Exceed font compiler. |
| 183 |
|
| 184 |
Stefan Monnier <[email protected]> for a bug report on highlight thickness |
| 185 |
of 0. |
| 186 |
|
| 187 |
Humphrey Clerx <[email protected]> for pointing out some |
| 188 |
compilation problem on Digit Unix 4.0 and some compilation problems with |
| 189 |
Traditional C compilers. |
| 190 |
|
| 191 |
Rudolf Cejka <[email protected]> for providing patches to fix |
| 192 |
problems with grabbing fonts from the X server and alerting me to |
| 193 |
uninitialized variable warnings. |
| 194 |
|
| 195 |
Baruch Even <[email protected]> for providing a fix for a bug that should |
| 196 |
have shown up long ago dealing with font properties. |
| 197 |
|
| 198 |
Sergey Vlasov <[email protected]> for pointing out a serious problem with |
| 199 |
naming glyphs from the Unicode Character Database and for providing a fix |
| 200 |
for a potential buffer overflow problem. |
| 201 |
|
| 202 |
Daniel Neuburger <[email protected]> for providing a patch that |
| 203 |
fixes a display problem in the Font Grid. |
| 204 |
|
| 205 |
Pierre HANSER <[email protected]> for a patch to fix a |
| 206 |
problem loading font names that are not NULL terminated from the end of |
| 207 |
FON/FNT files. |
| 208 |
|
| 209 |
Patrick Hagglund <[email protected]> for providing the patches to |
| 210 |
use FreeType 2. |
| 211 |
|
| 212 |
James Cloos <[email protected]> for finding problems with gbdfed. |
| 213 |
|
| 214 |
Ming Hua <[email protected]> for locating a problem with editing glyphs. |
| 215 |
|
| 216 |
Sergio Martins <[email protected]> for finding a typo and several |
| 217 |
dialog related bugs. |
| 218 |
|
| 219 |
Viktor Urban <[email protected]> for locating a problem when |
| 220 |
saving and moving to the next or previous glyph. |
| 221 |
|
| 222 |
Jiri "BlueBear" Dluhos <[email protected]> for producing crash fixes on |
| 223 |
64-bit machines. |
| 224 |
|
| 225 |
Jan Engelhardt <[email protected]> for providing an improvement on the |
| 226 |
help text, a missing prototype, and an improvement in Makefile.in. |
| 227 |
|
| 228 |
Daniel Richard G. <[email protected]> for diagnosing problems on 64-bit |
| 229 |
architectures. |
| 230 |
|
| 231 |
Baruch Even <[email protected]> for diagnosing problems on 64-bit |
| 232 |
architectures. |
| 233 |
|
| 234 |
Ming Hua <[email protected]> for pointing out a warning about testing |
| 235 |
a NULL region. |
| 236 |
|
| 237 |
Ryan Hill <[email protected]> for pointing out a crashing problem with |
| 238 |
filename filters when the import dialog was popped up multiple times. |
| 239 |
|
| 240 |
Don Knuth for reporting problems with the documentation and a highlighting |
| 241 |
problem (https://bugs.launchpad.net/ubuntu/+source/gbdfed/+bug/172836). |
| 242 |
|
| 243 |
Tim Allen <[email protected]> for reporting an obscure bug with glyph |
| 244 |
spacing which led to fixing another spacing related bug. Also for the idea |
| 245 |
of preserving device width offsets. |
| 246 |
|
| 247 |
Daniel Quarras <[email protected]> for discovering that deleting PSF |
| 248 |
unicode map entries was being ignored. |
| 249 |
|
| 250 |
Bertrand Janin <[email protected]> for adding glyph navigation buttons |
| 251 |
to the GlyphEditors. |
| 252 |
|
| 253 |
Peter Volkov <[email protected]> for fixing a name collision with Glib 2.10. |
| 254 |
|
| 255 |
Tom "spot" Callaway <[email protected]> for the configuration addition |
| 256 |
that fixes a problem with implicit dynamic linking that showed up with newer |
| 257 |
versions of gcc. |
| 258 |
|
| 259 |
AUTHOR |
| 260 |
------ |
| 261 |
Mark Leisher <[email protected]> |
| 262 |
15 April 2010 |