home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / may94 / gfx / conv / charmap.lha / CharMap / CharMap.doc < prev    next >
Text File  |  1994-01-15  |  6KB  |  87 lines
  1. ›27m   _›7m"¯__¯"›27m_   ›7m¯›27m      ›7m¯›27mL     ›7m¯¯›27m     ›7mF¯____¯"¶›27m  ›7mF¯¯›27m     ›7mK¯¯›27m     ›7mK¯¬›27m     ›7m¯¯___¯"¶›27m  
  2. ›27m  ›7m" ›27m"    ¬›7m_›27mÞ  ›7m ›27mÞ     ›7m ›27mF    ›7m ›27mK›7m¸¬›27m    ›7mF ›27m     ¬›7m ›27m  ›7mF ,¬›27m    ›7m , ›27m     ›7m ›27m~›7m ¶›27m    ›7mÞ ›27m    ¬›7m ›27mÞ
  3. ›27m  ›7m ›27mÞ          ›7m °°°°°° ›27mF   ›7m´ ›27m ¬›7m ¶›27m   ›7mF ›27m____›7mM"_›27m  ›7mF ›27m ›7m ›27m,  ›7m~›27mP›7mF ›27m    ›7m ›27mF ¬›7m ›27m¸   ›7mÞ ›27m____›7m° ›27m~
  4. ›27m  ›7m ›27mÞ      _,  ›7m ›27m¯¯¯¯¯¯›7m ›27mF  ›7mF °°°  ›27m¸  ›7mF ›27m°°°°°›7m_¬›27m  ›7mF ›27m ›7mK¬›27m ›7mF ›27m ›7mF ›27m   ›7mF °°° ¬›27m   ›7mÞ ›27m¶¶¶¶°  
  5. ›27m  ›7mw ›27m_   _›7m" ›27m   ›7m ›27mÞ     ›7m ›27mF  ›7m ›27mF¯¯¯¯›7m_¬›27m  ›7mF ›27m      ›7m ›27mÞ ›7mF ›27m  ›7m¸? ›27m´ ›7mF ›27m  ›7mF ›27mF¯¯¯¯›7m ¬›27m  ›7mÞ ›27m       
  6. ›27m   ¬›7m_____›27m°    ›7m_›27m      ›7m_›27m¹ *›7m_›27m     ¬›7m_›27mK J›7m_›27m      ›7m_›27mK J›7m_›27m  ¬›7m_›27mF  J›7m_›27m  ›7m__›27m     ?›7m_›27m  ¶#   V1.0
  7.  
  8. CharMap is a program that converts any 2-colors IFF-picture into an ASCII-text.
  9. You need at least OS2.04!
  10.                                                                                
  11.  Table of contents                                                             
  12.  
  13.                          Copyright note............17
  14.                          Using the program.........42
  15.                          Contacting the author.....78
  16.                                                                                
  17.  Copyright note                                                             17 
  18.  
  19. CharMap,  its sourcecode  and the doc-files  are (C)opyrighted  by the  author,
  20. Hanns  Holger  Rutz.  CharMap  ist  freeware,  these  are  the  conditions  for
  21. (re-)distribution:
  22.  
  23. - the commercial distribution  of CharMap is prohibited.  You may not raise any
  24.   fee for it.  The exception is the distribution of CharMap on a freely distri-
  25.   butable series.
  26. - to distribute CharMap on a fd-series, you have to get a personal licence from
  27.   the author. If you have one, CharMap is to be distributed under the Copyright
  28.   conditions of the certain series.
  29. - CharMap may only be distributed with all the neccessary files, which are:
  30.  
  31.     CharMap      the executable;
  32.     CharMap.doc  the English doc-file;
  33.   and/or
  34.     CharMap.dok  the German doc-file;
  35.  
  36.   The  distribution  of the  sourcecode  is optional.  Yet,  it has  to be kept
  37.   together with the files mentioned above.
  38.                                                                                
  39.     THE AUTHOR, HANNS HOLGER RUTZ, IS NOT RESPONSIBLE AT ALL FOR ANY DAMAGE    
  40.        CAUSED BY THIS PROGRAM, THE USER TAKES THE RISC HIM- OR HERSELF!        
  41.                                                                                
  42.  Using the program                                                          42 
  43.  
  44. CharMap has to be started from the Shell. This is the usage:
  46.   CharMap <ILBM> <Target> [<Font> SIZE <Height>] [ANSI]
  47.  
  48.   <ILBM>                Name of the IFF-picture  to be converted.  It must have
  49.                         2 colors.  The size is not limited,  though,  note that
  50.                         the right and bottom  margin may  not be converted com-
  51.                         pletely,  if the  width  is no multiple  of the  font's
  52.                         width  or the  height  is no  multiple  of  the  font's
  53.                         height.  You should design  your picture  to fit  these
  54.                         values or have  enough space  at the right  and bottom.
  55.                         Otherwise  you might get angry  when you find out  that
  56.                         CharMap didn't convert the whole picture.
  57.   <Target>              Name of the file CharMap writes the ASCII-text to.
  58.   <Font> SIZE <Height>  Font  that should  be used.  Proportional  fonts aren't
  59.                         allowed  (that is,  fonts whose chars differ in width).
  60.                         Defaults to the ROM-font "topaz.font" (height 8).
  61.   ANSI                  This switch allows CharMap to use the ANSI command that
  62.                         swaps the foreground- and backgroundcolor  (<CSI>7m and
  63.                         <CSI>27m).  On  the  one  hand  you  often  get  better
  64.                         results, on the other hand your text becomes longer. In
  65.                         order to make  future changes  of the text  more  easy,
  66.                         each line  begins  and ends  with an  ANSI command  for
  67.                         reverse-text  on  or off.  The created text may be dis-
  68.                         played in your Shell or using MuchMore etc.
  69.  
  70. The calculation can be aborted by clicking on the right mousebutton or pressing
  71. CTRL+C if the  Shell-window is active.  When the calculation  is finished,  the
  72. program waits for mouseclick or CTRL+C in the Shell. The returncodes are:
  73.  
  74.  0  Conversion done without errors;
  75.  5  User-break;
  76. 20  Error occured;
  77.                                                                                
  78.  Contacting the author                                                      78 
  79.  
  80. If you have found bugs  or if you have essential :-) improvement-suggestions or
  81. just questions, please write to:
  82.  
  83.                                Hanns Holger Rutz
  84.                          Auf dem Godenstedter Berg 17
  85.                                  D-27404 Zeven
  86.                                     GERMANY
  87.