/src/freetype/src/tools/ftrandom/README

https://bitbucket.org/cabalistic/ogredeps/ · #! · 48 lines · 42 code · 6 blank · 0 comment · 0 complexity · 807bdcadbabda4419aea8784ce277717 MD5 · raw file

  1. ftrandom
  2. --------
  3. This program expects a set of directories containing good fonts, and a set
  4. of extensions of fonts to be tested. It will randomly pick a font, copy it,
  5. introduce and error and then test it.
  6. The FreeType tests are quite basic:
  7. For each erroneous font it
  8. forks off a new tester;
  9. initializes the library;
  10. opens each font in the file;
  11. loads each glyph;
  12. (optionally reviewing the contours of the glyph)
  13. (optionally rasterizing)
  14. closes the face.
  15. If the tester exits with a signal, or takes longer than 20 seconds then
  16. ftrandom saves the erroneous font and continues. If the tester exits
  17. normally or with an error, then the superstructure removes the test font and
  18. continues.
  19. Arguments are:
  20. --all Test every font in the directory(ies) no matter
  21. what its extension (some CID-keyed fonts have no
  22. extension).
  23. --check-outlines Call FT_Outline_Decompose on each glyph.
  24. --dir <dir> Append <dir> to the list of directories to search
  25. for good fonts.
  26. --error-count <cnt> Introduce <cnt> single-byte errors into the
  27. erroneous fonts.
  28. --error-fraction <frac> Multiply the file size of the font by <frac> and
  29. introduce that many errors into the erroneous
  30. font file.
  31. --ext <ext> Add <ext> to the set of font types tested. Known
  32. extensions are `ttf', `otf', `ttc', `cid', `pfb',
  33. `pfa', `bdf', `pcf', `pfr', `fon', `otb', and
  34. `cff'.
  35. --help Print out this list of options.
  36. --nohints Specify FT_LOAD_NO_HINTING when loading glyphs.
  37. --rasterize Call FT_Render_Glyph as well as loading it.
  38. --result <dir> This is the directory in which test files are
  39. placed.
  40. --test <file> Run a single test on a pre-generated testcase.
  41. Done in the current process so it can be debugged
  42. more easily.