home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / ft-beta.zip / freetype / tools / ttf2bdf / README < prev    next >
Text File  |  1997-10-06  |  5KB  |  147 lines
  1. #
  2. # $Id: README,v 1.2 1997/10/01 18:24:55 mleisher Exp $
  3. #
  4.  
  5. #
  6. # Copyright 1996, 1997 Computing Research Labs, New Mexico State University
  7. #
  8. # Permission is hereby granted, free of charge, to any person obtaining a
  9. # copy of this software and associated documentation files (the "Software"),
  10. # to deal in the Software without restriction, including without limitation
  11. # the rights to use, copy, modify, merge, publish, distribute, sublicense,
  12. # and/or sell copies of the Software, and to permit persons to whom the
  13. # Software is furnished to do so, subject to the following conditions:
  14. #
  15. # The above copyright notice and this permission notice shall be included in
  16. # all copies or substantial portions of the Software.
  17. #
  18. # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  21. # THE COMPUTING RESEARCH LAB OR NEW MEXICO STATE UNIVERSITY BE LIABLE FOR ANY
  22. # CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
  23. # OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
  24. # THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25. #
  26.  
  27. This is version 1.4 of a program to convert TrueType fonts to BDF fonts using
  28. the FreeType renderer.
  29.  
  30. There are still some problems with metrics calculations, but the incorrect
  31. values can be fixed by loading the BDF font into the XmBDFEditor and saving it
  32. again.
  33.  
  34. The XmBDFEditor is available from (replace the <version> with the most current
  35. version number):
  36.  
  37.   [Sources]
  38.   ftp://crl.nmsu.edu/CLR/multiling/General/xmbdfed.tar.gz
  39.  
  40.   [Binaries: Linux/Pentium, Solaris, SunOS]
  41.   ftp://crl.nmsu.edu/CLR/multiling/General/xmbdfed-<version>-ELF.tar.gz
  42.   ftp://crl.nmsu.edu/CLR/multiling/General/xmbdfed-<version>-SOLARIS.tar.gz
  43.   ftp://crl.nmsu.edu/CLR/multiling/General/xmbdfed-<version>-SUNOS.tar.gz
  44.  
  45. COMPILING ttf2bdf
  46. -----------------
  47.  
  48. 1. Pick up the latest FreeType distribution from:
  49.  
  50.    ftp://ftp.physiol.med.tu-muenchen.de/pub/freetype/devel/freetype-beta.tar.gz
  51.  
  52. 2. Unpack FreeType and build it.
  53.  
  54. 3. Go into the "tools/ttf2bdf/" directory and type "make" to build "ttf2bdf".
  55.  
  56. RUNNING ttf2bdf
  57. ---------------
  58.  
  59. Type the following to get a list of command line options:
  60.  
  61.   % ttf2bdf -h
  62.  
  63. ACKNOWLEDGEMENTS
  64. ----------------
  65.  
  66. Thanks go to the following people:
  67.  
  68.   Robert Wilhelm <robert@physiol.med.tu-muenchen.de> for pointing out a
  69.   crucial problem with the pre-1.0 code.
  70.  
  71.   Lho Li-Da <ollie@ms1.hinet.net> for pointing out a problem with Big5 and
  72.   GB2312 encoding ids being documented incorrectly in the TT docs and a
  73.   problem with glyphs that are height 1 or width 1, and a font name problem.
  74.  
  75.   Adrian Havill <havill@threeweb.ad.jp> for unintentionally pointing out a
  76.   missing feature.
  77.  
  78.   Richard Verhoeven <rcb5@win.tue.nl> for pointing out a font names problem,
  79.   problem with bitmaps missing their last byte in each row, and an invalid
  80.   FONT_DESCENT property value.
  81.  
  82.   Choi Jun Ho <junker@jazz.snu.ac.kr> for his inspiration from his
  83.   implementation that changed some character set names, and added a
  84.   number of new command line parameters.
  85.  
  86. CHANGES
  87. -------
  88.  
  89. Version 1.4
  90. ===========
  91.   1. Changed the names of two MS encodings (Wansung and Johab) to
  92.      KSC5601.1987 and KSC5601.1992.
  93.  
  94.   2. Added the '-n' command line flag to turn hinting off.
  95.  
  96.   3. Added the '-c' command line flag to set the font spacing.
  97.  
  98.   4. Added the '-t', '-w', and '-s' command line options to override the
  99.      default typeface, weight and slant names.
  100.  
  101. Version 1.3
  102. ===========
  103.   1. Converted to use the new FreeType API.
  104.  
  105.   2. Added the '-rh' and '-rv' command line parameters to allow both the
  106.      horizontal and vertical resolutions to be set individually.
  107.  
  108.   3. Fixed a problem with ignoring undefined glyphs.  All undefined were
  109.      being rendered which caused missing glyphs on the end.
  110.  
  111.   4. Fixed a problem with offset calculations needed to render glyph
  112.      bitmaps.
  113.  
  114. Version 1.2
  115. ===========
  116.   1. Fixed a problem with dashes that appear in the font family name causing
  117.      parse problems with the XLFD font names.
  118.  
  119.   2. Fixed a problem with certain bitmaps missing their final byte on each
  120.      row.
  121.  
  122.   3. Fixed an incorrect FONT_DESCENT value.
  123.  
  124.   4. Changed things around so names can be retrieved in a more general way.
  125.  
  126.   5. Fixed a problem with bitmaps not being generated after a certain point.
  127.  
  128. Version 1.1
  129. ===========
  130.   1. Fixed the actual glyph count for the CHARS line.
  131.  
  132.   2. Swapped the Big5 and GB2312 XLFD encoding strings because of incorrect TT
  133.      specifications.
  134.  
  135.   3. Fixed a problem with bitmap generation for glyphs that are width 1 or
  136.      height 1.
  137.  
  138.   4. Added command line parameters to set the font and render pool memory
  139.      sizes in Kilobytes from the command line.
  140.  
  141. Version 1.0
  142. ===========
  143.   1. Initial release.
  144.  
  145. mleisher@crl.nmsu.edu (Mark Leisher)
  146. 01 October 1997
  147.