Debian Codegraph @

README

raw
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