X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=Readme;h=7ce6e70badfe2a479c7b87b2b84d548b8aa9b659;hb=f80db26b7c5db7c120f5b38defa15fed232f6e96;hp=111f53cadd2f63d418386aeedf350d4e8d3f7f89;hpb=6def1722d1157378ddd6c6ef53673865510e3ed0;p=ttf2png.git diff --git a/Readme b/Readme index 111f53c..7ce6e70 100644 --- a/Readme +++ b/Readme @@ -1,25 +1,27 @@ ttf2png - True Type Font to PNG converter -Copyright (c) 2004-2008 Mikko Rasa, Mikkosoft Productions +Copyright (c) 2004-2018 Mikko Rasa, Mikkosoft Productions Software requirements FreeType 2 -libpng 1.2 +libpng 1.6 C compiler (preferably GCC) Command-line options -r , - Range of characters to convert, specified as unicode code points. The - default is 0,255, matching the ISO-8859-1 (Latin-1) character set. + Range of code points to convert, specified as unicode code points. The + default is 0,255, matching the ISO-8859-1 (Latin-1) character set. Code + points can be specified as plain numbers, unicode code points (U+xxxx) or + UTF-8 characters. -s Font size to use. The default is 10 pixels. -l - Number of characters to put in one line. Defaults to autodetect. Ignored + Number of glyphs to put in one line. Defaults to autodetect. Ignored if -p is used. -c [x] @@ -42,7 +44,8 @@ Command-line options -i Invert colors of the glyphs. When rendering to alpha channel, only the - alpha channel is inverted. + alpha channel is inverted. The default is to render black glyphs on a + white background. -v Increase the level of verbosity. @@ -52,10 +55,18 @@ Command-line options each glyph is determined by its code point. Ignored if -p is used. -p - Pack the glyphs tightly in the image. One-pixel gaps are left between - glyphs. By default glyphs are rendered in a regular grid. Creating a - definition file is recommended, as the resulting image can seem rather - messy. + Pack the glyphs tightly in the image. Small gaps are left between glyphs, + controlled by the -n option. By default glyphs are rendered in a regular + grid. Creating a definition file is recommended, as the resulting image + can seem rather messy. + + -m + Leave a margin around the edges of the generated image. By default glyphs + can touch the edges. Only used with -p. + + -n + Control the amount of padding between glyphs. The default is 1 pixel. + Only used with -p. -d File name to write glyph definitions. See the section below for details. @@ -125,6 +136,13 @@ some fonts, not all of the glyphs fit completely inside the character box. Changelog next +- Alternate ways of specifying code point ranges + +1.1 +- Controllable margin and padding in packed mode +- Do not generate overly large images in sequential grid mode + +1.0 - Improve the packing algorithm - Non-square cells for grid mode - Option to invert colors