--- a/README.txt	Mon Nov 12 22:04:50 2012 +0200
+++ b/README.txt	Mon Nov 12 22:26:23 2012 +0200
@@ -229,6 +229,31 @@
 
 gfxconv
 -------
+
+Image input to C64 char font conversion:
+
+$ gfxconv font16x16.pcx -f chr -o font16x16.chr
+
+ - Input file "font16x16.pcx" is a paletted PCX image (preferably 2-colors),
+   containing a 16x16 pixel font.
+ - "-f chr" specifies conversion to c64 char memory format, gfxconv
+   splits the input image to 8x8 blocks, outputting them in sequence.
+
+
+Convert input image to IFFMaster ARAW + assembler include file,
+while remapping some palette entries:
+
+$ gfxconv -R "#000000:0" -f araw -i image -B 3 input.png -o output.raw
+
+ - "-R #000000:0" remaps all input image palette colors matching RGB
+   hex triplet #000000 to palette index 0.
+ - "-f araw" specifies output format to be IFFMaster ARAW.
+ - "-B 3" _clamps_ output to be 3 bitplanes. Any bits above those are
+   simply discarded.
+
+
+C64 char font to PNG imge conversion:
+
 $ gfxconv chars1.fnt -i char -s 2 -S 10 -c 255:1 -f png -o chars1.png
 
  - Input file "chars1.fnt" is interpreted as character data (-i char)
@@ -239,6 +264,8 @@
  - "-f png" sets output format to PNG
 
 
+Extract sprites from a C64 memory dump, convert to PNG:
+
 $ gfxconv bub_dump.raw -i s -s 0x5800 -n 20 -f png -o bub \
   -q -S 3 -m -c 255:2:5:1
 
@@ -254,6 +281,7 @@
   - "-c 255:2:5:1" sets the multicolor color mappings
     (255 is the transparency color again)
 
+
 $ gfxconv chars3.fnt -i c -s 2 -n 3
 
   Dump as character data into stdout, skipping 2 bytes at start, and