ILBM2ASCII                                                 @@@@@@@@@@@@@[
----------                                                 ~~~~~~~~~~~~~`

by Tobias Ferber                                           mmmmmmmmmmmmmi
based on iff2ascii.amos by Matthew Stratfold               @A***********!
                                                           @[
                                                           @[
What's it do?                                              @[
-------------                                              @[
It converts IFF pictures into an ASCII representation.
The program will antialiase the text by selecting the      mmmmmmmmmmmmmi
best characters to make the edge.  Characters are also     @A****M@****@[
selected for their density when shading.                   @[    ]@    @[
                                                           @[    ]@    @[
How to use it:                                             @[    ]@    @[
-------------                                              Y@_  _@@W__W@`
The program can be invoked from the shell in the normal    'M@@@@A~*@@A`
way or by running the arexx script use either:               '~~`

ilbm2ascii [ilbm-file] > [ascii file]
rx ILBM2ASCII.rexx FROM [ilbm file] TO [ascii file]
                                                           @@@@@@@@@@@@@[
If you have ARexx running you can double click the icon    ~~~~~~~~~XX@@[
and start it from the Workbench and select the picture         __mW@A*~`
and destination file using file requesters.                _mW@A*~`
                                                           @@b_.
How it works:                                               ~V*@@ms_.
------------                                                    '~V*@@ms.
The program looks at pixel blocks of 2x3 pixels and        mmmmmmmmmmW@@[
selects a character that best matches that block.          *************!
Consequently the ASCII picture will be much bigger and
and a differnt aspect ratio than the original IFF.         @@m_    ims.
You may want to adjust your IFF before conversion to       @PV@W.  !*M@b
compensate for this.  If you want to know more then have   @[ '@W.    V@[
a look at the source that's included.                      @[  '@W.    @[
                                                           @[   !@@s__W@`
Preparation of the pictures:                               @[    '*@@@*`
---------------------------                                s_
The program assumes that any non background colour is      M@@Ws_
a colour.  For this reason you should use 2 colour           ~V@@@Wm_
images.  If you want to convert images with more colours       @['~*@@Wm.
then load them in to your favourite imgage processor           @[   _d@@[
and dither a 2 colour image from that.  ILBM2ASCII will        @bmW@@*f~
select a character whose density best matches the dither.   ,_m@@@*f~
                                                           @@*f`
                                                           `
Distribution etc:                                           gW@[  ,gmms.
----------------                                           d@*~` ,@@**@@.
The Conversion Table is inspired by Jorn Barger's         i@!    d@!   MW
alt.ascii art FAQ which had the table by Rob Harley in    ]@     @@    ]@
it.                                                       !@.   ]@[   ,WP
                                                           MWs_g@A  im@A`
The program is freely distributable, though keep the        VM@@*`  !*~
archive together and give credit where it's due.
                                                             _mm@@@Wms.
Feel free to include this any archives and libraries       ,W@**~~~V*@@s
do not charge any money other than an amount to cover      @A`        V@i
media, duplication and distribution.                      ]@`          Y@
                                                          ]@           ]@
All programming by Tobias Ferber.                         '@b         ,@P
(ukjg@rz.uni-karlsruhe.de)                                 !@Wm_    ,g@A`
                                                            'VM@    ]Af
ILBM2ASCII is a C coded FAST program based on IFF2ASCII
which was an AMOS program by Matthew Stratfold. Who also   mmmmmmmmmmmmmi
helped out on this doc, examples and the-rat icon.         *************!

                                                           _____________.
                                                           @@@@@@@@@@@@@[

This program is BeerWare - if you like it go and buy yourself a beer :-)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  249     469  53.1% -lh5- 1265 Jun 15  1994 ilbm2ascii-1.4/Distfile
[generic]                  357     952  37.5% -lh5- fe3e Jun 15  1994 ilbm2ascii-1.4/DMakefile
[generic]                  497     948  52.4% -lh5- 5729 Jun 15  1994 ilbm2ascii-1.4/examples.info
[generic]                 3896   13141  29.6% -lh5- 9a31 Jun 20  1994 ilbm2ascii-1.4/examples/fen.ascii
[generic]                 5159    7246  71.2% -lh5- ac04 Jun 16  1994 ilbm2ascii-1.4/examples/fen.iff
[generic]                 4072   12865  31.7% -lh5- 7325 Apr 26  1994 ilbm2ascii-1.4/examples/lady2.ascii
[generic]                 5776    8748  66.0% -lh5- 3be1 Feb 20  1994 ilbm2ascii-1.4/examples/lady2.iff
[generic]                 1885    7069  26.7% -lh5- 4017 Jun  6  1994 ilbm2ascii-1.4/examples/tf.ascii
[generic]                 2851    4766  59.8% -lh5- c39f May 11  1994 ilbm2ascii-1.4/examples/tf.iff
[generic]                12479   22452  55.6% -lh5- ac97 Jun 22  1994 ilbm2ascii-1.4/ilbm2ascii
[generic]                 1699    3949  43.0% -lh5- 8050 Jun 22  1994 ilbm2ascii-1.4/ilbm2ascii.c
[generic]                 1298    2316  56.0% -lh5- bccf Jun 15  1994 ilbm2ascii-1.4/ilbm2ascii.o
[generic]                   66      67  98.5% -lh5- 79b2 Sep  2  1992 file_id.diz
[generic]                  492     948  51.9% -lh5- b101 Sep  2  1992 ilbm2ascii-1.4.info
[generic]                 1517    4608  32.9% -lh5- e7b7 Jun 21  1994 ilbm2ascii-1.4/ilbm2ascii.readme
[generic]                 1624    5031  32.3% -lh5- 505a Jun 15  1994 ilbm2ascii-1.4/ilbm2ascii.rexx
[generic]                  648    1610  40.2% -lh5- 096f Jun 15  1994 ilbm2ascii-1.4/ilbm2ascii.rexx.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        17 files   44565   97185  45.9%            Jun 27  1994