,,  µµµµµµ, µµµµµµ,                                   
    7#  ØÑÑÑÑÑ1 ØÑÑÑÑÑ1                                   
    7#  ØL      ØL       _ææmµ_                           
    7#  ØL      ØL      µØØØØØ#,                          
    7#  ØLµµµµ  ØLµµµµ gØØM¯¬¶Ø#                          
    7#  ØÑÑÑÑÑ  ØÑÑÑÑÑ ÆØF    ¶ØL                         
    7#  ØL      ØL     ØØ     JØ1                         
    7#  ØL      ØL     @@     JØF                         
    7#  ØL      ØL            ÆØÞ                         
    7#  ØL      ØL     ,_   _ÆK®µµ_     _µµ_    _  ,,     
                       ØØ _æØFÆØ@ÑØK   ÆØ@ÑØ&  J#  ØF     
                       ضLØØ#J#   ¬Ø  á#   ¬0K J#  ØF     
                      J#J#¶° 7#    ¶  ØÞ    `¶ J#  ØF     
                      ØÑKØ   ¬Øæµ__   Ø        J#  ØF     
                     JØ¢#¶K   ¬¶ÑØ#m JØ        J#  ØF     
                     Æ#ÑÑÆ#qø_mæç °ØL¬Ø     ,a J#  ØF     
                     ØMZZ°ØWQ#LØ1  ØF #L    Æ# J#  ØF     
                    JØ ¯¯¯¶Q¯¶#_¯ _ØÞ ¶#_  µØ  J#  ØF     
                    Æ#    J#  ¶ØØØØF   ¶ØØØØ"  J#  ØF     
                               ¯""       ""               
                                                                                                          
This is Skandalfo's IFF2ASCII converter. It takes an 1-plane iff file and
converts it to characters. There are two programs, iff2ascii, which accurately
converts borders, and iff2grayascii, that puts the main focus on converting
greyscales (for dithered 2 colors images). The usage is in this way:

    iff2ascii iff-file-name font-name.font {7|8} >output-file

    iff2grayascii iff-file-name font-name.font {7|8} >output-file

The first parameter gives the iff file to be converted.

The second parameter is the name (ending in ".font") of the font used for the
conversion. This font should be a monospaced 8x8 font. If it isn't the results
will be unpredictable.

The third parameter is either an "8" or a "7". This controls which characters
will be used for the conversion. If "8" is given, characters 32-127 and
160-255 will be used. If "7", only characters 32-127.

The output is written to the standard output, so you'll have to redirect it if
you want to save the output to a file (if you don't it will be a preview in
the shell).

Some examples are included.
        
                                                                   
              _                    _        __   __            
             Æ#         gÑ#       J@       a@F  æ@F            
       ææw  #           ¶ØØ      J´       JF   æ               
      /  P JÞ           JÑ@      Ø        ÆÞ   #               
     JL    Æ  aw  ___     _    _J#   ___  Ø   JF    __         
     ¶&    Ø J°´ a°°Ø ,ØÞæ#Þ  aP#F  a°°Ø  # __ÆL, ,°°#         
      0&_  #/   JF  #  ØM Ø  JÞ Æ  JF  # JF ¯¯Ø¯ _F  Ø         
       ¶Q JMQ   Æ  7F  #  #  Ø  Ø  Æ  7F áÞ   #  Æ   #   #_    
        # Æ 0   Ø  ÆÞ¸JF JF _# _# ,Ø  ÆÞ¸Ø   JF  Ø  JF   ¬&    
   L    ´ Ø JQ  Øw°Øw´jÞ J&×J#wMQæ"Øw°Øw´Øw' áÞ  Ø__P     ¬K   
  J#___'  °  0_ ¶´ P  °  `´  P ¬°  ¶´ P  ¶   Ø   °@"       0   
   "¶°       ¬Q  j                           F             ]L  
              ¬¤¢"            _µµµµ__       J  __µµ         1  
                             J#°"°°¶ÑÑm_  æ#  æÑP"3Þ        1  
                             ¶Þ       "Ñm_   ÍF  µP        JF  
                                        ¬Æm__J&µÆP        _#   
                                          ¬¶@@@ÑÑw_     _æ#    
                                                ¬°Ñ#ÑæÑØ@°     
                                                     ¯         
                              OF
                          
                          
     ___              _______,        ___               ____           
   g#####x            ########        ##F             _g####m_         
  0########           ########        ##F            J########_        
 d##"   X##K  ww  ww,   J##      _awwJ##F   _www_    ##@   "###  aww__ 
 ##F     0##  ##  ##F   J##     g#######F  d#####_  0##      ##L 0####L
J##      J##  ##  ##F   J##    J##@""###F J##@@###  ###      ##Q 0####F
J##L     j##  ##  ##F   J##    d##    ##F 0#F   ##L ##Q      ### 0##F" 
 ##&     0##  ##  ##F   J##    0##    ##F ##F   ##F 0##_    J##F 0##   
 9###__a0##F  ##KJ##F   J##    ]##K__d##F 0##__g##   ###w__w###  0##   
  ########F   ######F   J##     ########F  ######F   `########   0##   
   "####@"    *##@##F   J##      ####M##F   *###"      #####P    0##   

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1107    2143  51.7% -lh5- 7503 Aug 21  1996 iff2ascii.info
[generic]                  153     304  50.3% -lh5- 6b93 Aug 21  1996 iff2ascii/count.s
[generic]                 8536   13700  62.3% -lh5- e930 Aug 21  1996 iff2ascii/iff2ascii
[generic]                 2241    9684  23.1% -lh5- 9ca9 Aug 21  1996 iff2ascii/iff2ascii.c
[generic]                 8642   13852  62.4% -lh5- e767 Aug 21  1996 iff2ascii/iff2grayascii
[generic]                 2230    9538  23.4% -lh5- d88d Aug 21  1996 iff2ascii/iff2grayascii.c
[generic]                 1600    4803  33.3% -lh5- ffac Aug 21  1996 iff2ascii/SkIff2Ascii.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         7 files   24509   54024  45.4%            Aug 23  1996