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         __mWA*~`
and destination file using file requesters.                _mWA*~`
                                                           @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       @PVW.  !*Mb
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_gA  imA`
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`        Vi
media, duplication and distribution.                      ]`          Y
                                                          ]           ]
All programming by Tobias Ferber.                         'b         ,P
(ukjgrz.uni-karlsruhe.de)                                 !Wm_    ,gA`
                                                            '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