home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / readmes / iff2asci.rea < prev    next >
Text File  |  1993-03-03  |  5KB  |  123 lines
  1. Short: Converts grey IFF pix to ASCII pix
  2.  
  3. IFFtoASCII
  4. (C) June 1992 Paul Huxham
  5. Organization: WaveFrame, Perth, Western Australia
  6.  
  7. Written in AMOS V1.34
  8.  
  9. This program is freely redistributable.
  10. Any copyright however remains with the author.
  11.  
  12.  
  13. WHAT IT DOES
  14. ============
  15.  
  16.   IFFtoASCII is designed to convert 16 Grey Level IFF pictures into lines
  17. of ASCII characters that when viewed from a distance look like the original
  18. picture.
  19.  
  20.  
  21. HOW TO DO IT
  22. ============
  23.  
  24.   When loaded, click to enter the conversion routines. Select the image to
  25. convert (right mouse button shows devices and assignments). Images that are
  26. colour, HAM or brushes (images not full screen height and width in their
  27. respective resolutions) should not be loaded. They will give unpredictable
  28. results.
  29.  
  30.   IFFtoASCII shows you the screen width, height and number of colours of
  31. the loaded image.
  32.  
  33.   Select whether you would like the image converted in PORTRAIT or
  34. LANDSCAPE mode.
  35.  
  36.   Next select FULL SCREEN or DRAW RECTANGLE. DRAW RECTANGLE allows you to
  37. define an area of the image to convert. Click the LEFT mouse button to
  38. start drawing a box, and press the LEFT mouse button again to finish
  39. drawing. You may now either click the LEFT mouse button to start drawing
  40. another rectangle (losing the first), or the RIGHT mouse button to accept
  41. the currently drawn rectangle and continue.
  42.  
  43.   Now enter the HORIZONTAL PIXEL TO TEXT RATIO and the VERTICAL PIXEL TO
  44. TEXT RATIO. These can be a little confusing at first. Pressing return at
  45. each prompt will load the default for an 80x24 text screen. Basically the
  46. value entered is how many pixels represent 1 ASCII character. Be careful
  47. when converting LORES INTERLACED pictures because the aspect ratio
  48. vertically is twice the ratio horizontally (For 80x25 text output). It is a
  49. good idea to experiment a lot with these settings to obtain the best
  50. results. For example:
  51.  
  52.    Source Picture    Horizontal    Vertical   ASCII (Correct aspect)
  53.       320x200            2            4       160x64
  54.       320x400            2            8       160x64
  55.       640x200            4            4       160x64
  56.       640x400            4            8       160x64
  57.  
  58.   Next enter the number of grey levels to be represented in ASCII. Possible
  59. values are 1, 2, 3, 4, 5, 6, 7, 8, 16. For example:
  60.  
  61.     1  is Black or White  (2 different ASCII characters)
  62.     16 is Grey            (16 different ASCII characters)
  63.  
  64.   Select an output file. A default name is given containing the horizontal
  65. aspect, vertical aspect and number of grey levels. Useful for default names
  66. to see which one looks the best. Files ARE NOT OVERWRITTEN. You will be
  67. asked to confirm the overwrite if the output file already exists.
  68.  
  69.   The image will be converted. Click on CANCEL to abort the conversion.
  70.  
  71.   You will then be asked if you wish to convert more images or to quit.
  72.  
  73.   When you print your pictures, try setting condensed mode on your printer
  74. (dont forget you then have to chnage the aspect ratio to get twice as many
  75. characters horizontally than normal!). Or even condensed and half height
  76. (no aspect changes required). The pictures look suprisingly good. (Well
  77. what can you expect from ASCII characters :-)
  78.  
  79.   Seven example files of various sizes (you might have to load an editor
  80. that supports files wider than 80 columns to see some of them) are included
  81. so you can see what to expect (dont get your hopes up to high though :-).
  82. All but one are included twice, once in 8 grey levels and once in 16 grey
  83. levels and in portrait mode. The remaining picture is in landscape mode.
  84.  
  85.  
  86. WHAT WILL HAPPEN NEXT
  87. =====================
  88.  
  89. Not in any order:
  90.  
  91. i)    Yeah I know the interface is the pits, but its how it is.
  92. ii)   Need to able to enter a figure for the number of columns and rows
  93.       versus the current aspect ratio system.
  94. iii)  Support for colour and HAM pictures.
  95. iv)   Support for pictures larger than the screen.
  96. v)    Presets for aspect ratios and grey levels. eg Lores-Interlaced.
  97. vi)   Be able to move the rectangle in DRAW RECTANGLE once drawn to the
  98.       right size.
  99. vii)  Rewrite in C. Yeah I know its slow, especially on 68000.
  100. viii) User defined ASCII characters for grey levels.
  101. ix)   Preferences file.
  102. x)    Moveable information screen using RIGHT mouse button.
  103.  
  104.  
  105. IF YOU'RE NOT HAPPY
  106. ===================
  107.  
  108. In BLACK or WHITE:
  109.  
  110. i)    Don't use it and write your own.
  111. ii)   Suggest changes to IFFtoASCII.
  112.  
  113.  
  114. FOR MORE INFORMATION
  115. ====================
  116.  
  117.     Paul Huxham
  118.     PO BOX 875
  119.     Morley, Perth
  120.     Western Australia 6062
  121.  
  122.     or via email:   paulh@wavefrm.DIALix.oz.au
  123.