]> git.tdb.fi Git - ttf2png.git/blobdiff - Readme
Fix a memory leak
[ttf2png.git] / Readme
diff --git a/Readme b/Readme
index f9effa651f3e30c00b0c70076a1f22c061b6c446..946c9b72f9ff8d93168995f3607e520f409db44a 100644 (file)
--- a/Readme
+++ b/Readme
@@ -1,25 +1,28 @@
 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 <low>,<high>
-    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.  This option can be specified multiple times to add
+    more ranges to be converted.
 
   -s <pixels>
     Font size to use.  The default is 10 pixels.
 
   -l <num>
-    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 <pixels>[x<pixels>]
@@ -42,7 +45,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 +56,10 @@ 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 <pixels>
     Leave a margin around the edges of the generated image.  By default glyphs
@@ -65,6 +69,10 @@ Command-line options
     Control the amount of padding between glyphs.  The default is 1 pixel.
     Only used with -p.
 
+  -f
+    Allow the resulting image to have a non-power-of-two size.  By default the
+    image size is rounded up to a power of two for maximum compatibility.
+
   -d
     File name to write glyph definitions.  See the section below for details.
 
@@ -133,6 +141,11 @@ some fonts, not all of the glyphs fit completely inside the character box.
 Changelog
 
 next
+- Alternate ways of specifying code point ranges
+- Multiple code point ranges can be specified
+- Option to generate non-power-of-two images
+
+1.1
 - Controllable margin and padding in packed mode
 - Do not generate overly large images in sequential grid mode