Jp2a
Description:	Converts JPEG images to Ascii Art
Download:	jp2a.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	582kb
Version:	0.9.22
Date:	10 Aug 2006
Author:	Christian Stigen Larsen, AmigaOS 4.0 compile by Spot / Up Rough
Submitter:	Spot / Up Rough
Email:	spot/triad se
Homepage:	http://jp2a.sourceforge.net/
Requirements:	AmigaOS 4.0 and a JPEG image.
Category:	graphics/convert
License:	GPL
Distribute:	yes
Min OS Version:	4.0
FileID:	1990
Snapshots:
Comments:	1
Snapshots:	2
Videos:	0
Downloads:	293  (Current version)
	293  (Accumulated)
Votes:	0 (0/0)  (30 days/7 days)

JP2A AmigaOS 4.0 Read Me
------------------------

jp2a is a small utility that converts JPG images to ASCII. It's written in C
and released under the GPL.

Important Note about the AmigaOS 4.0 port, it was not compiled with libcurl
support, so you can't convert images directly from the net. I'll implement
that in the future if LibCurl gets ported to clib2.



Example Usage:

jp2a --size=60x60 jp2a.jpg --output=jp2a.txt

gives you this;

MMMMWNWMMMMMMMMMMMMMMMMMMMMMMMMMMWNNWMMMMMMMMMMMMMMMMMMMMMMM
MMMMWXNMMMMMMMMMMMMMMMMMMMMMMMMMMNXKNMMMMMMMMMMMMMMMMMMMMMMM
MMMMOclXMMMMMMMMMMMMMMMMMMMMMMMN0oc:lkXMMMMMMMMMMMMMMMMMMMMM
MMMN;  dMMMMMMMMMMMMMMMMMMMMMWOc'    .:KMMMMMMMMMMMMMMMMMMMM
MMMK.  :MMMMMMMMMMMMMMMMMMMMMk.        cWMMMMMMMMMMMMMMMMMMM
MMM0.  :MMMMMMMMMMMMMMMMMMMMW;         .OMMMMMMMMMMMMMMMMMMM
MMMN,  oMMMMMMMMMMMMMMMMMMMMN'          cNMMMMMMMMMMMMMMMMMM
MMMM:  xMMMMMMMMMMMMMMMMMMMMN'          ,KMMMMMMMMMMMMMMMMMM
MMMMk:lKMMMMMMMMMMMMMMMMMMMMN'   ..     .OMMMMMMMMMMMMMMMMMM
MMMXOkOKWMMN0000XW0xxOXMMMMMN' ;okx;    .dMMMMMWXkxxxOXWMMMM
MMWd''':KMMk''''dd'...;OMMMMN:oKMMM0.    dMMMW0o;.....;kWMMM
MMWc   .0MMo    ..     '0MMMNONMMMMW;    dMMMk'        .OWMM
MMWc   .0MMo            ;KMMWWMMMMMM:   .xMMW;          ,0MM
MMWc   .KMMo            .xMMMMMMMMMM:   .xMMN'          .xMM
MMWc   .0MMo             lWMMMMMMMMM:   .OMMN'  .','     dMM
MMWc   .0MMo     .c;     .KMMMMMMMMW,   cNMMN' ,x0K0,    cWM
MMWc   .0MMo    'ONX:     kMMMMMMMMK.   xMMMN:lKMMMMo    :NM
MMWc   .0MMo    lWMMk     xMMMMMMMWd   'XMMMWONMMMWXc    ;NM
MMWc   .0MMo    lMMMK.    oMMMMMMMK,   lMMMMMWMMNkl;.    ;NM
MMWc   .0MMo    lMMMX,    oMMMMMMMk.   dMMMMMMMMK:.      ;NM
MMWc   .0MMo    lMMMN,    oMMMMMMNc   .OMMMMMMW0c.       ;NM
MMWc   .0MMo    lMMMN;    oMMMMMMO.   :NMMMMMXl'   ..    ;NM
MMWc   .0MMo    lMMMK'    dMMMMMW:   ,0MMMMMMd    ,dl    ;NM
MMWc   .0MMo    lMMMO     xMMMMWk.  .xNNNNWMN,   ;KWd    ;NM
MMWc   .0MMo    oMMMx     kMMMMWl   .OXKKKNMK.   dMMd    ;NM
MMWc   .0MMo    ;XMWl     OMMMM0'   .;::::kMO.   xMMd    :NM
MMWc   .0MMo     ;dl.    'KMMMK;          :Mx    xMMo    ,0N
MMWc   .0MMo             lWMMNc           :Mk.   ;xd.     ,k
MMWc   .0MMo            ;KMMMk            :MK.    ..       d
MMWc   .0MMo           '0MMMX,            :MW;      .      x
MMWc   .0MMo           cWMMMO.            :MMl      ,.    .k
MMNc   .0MMo    ,,   .,kMMMMO,''''''''''''oMMO'.  .,x:.  .cX
MMN:   .0MMo    lKdddxKWMMMMX0000000000000XMMW0xddxKWKxddkNM
MMK,   .KMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MNl    .XMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
Mx.    ,WMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
Ml     ;MMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
Md     cMMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MO     xMMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MX,   :XMMMo    lMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MWo..oKMMMMd....oMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMKxOWMMMMMKxxxxKMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM


jp2a --size=60x60 --invert jp2a.jpg --output=test.txt

gives you this;

                                                            
     .                            ..                        
    'ol.                        .codl,.                     
    xMW:                      'oONMMWKd.                    
   .KMMd                     ,0WMMMMMMWo                    
   .KMMd                     xMMMMMMMMMX'                   
    kMWc                     OMMMMMMMMMWo                   
    dMN;                     OMMMMMMMMMMk.                  
    ,dl.                     OMMNKXWMMMM0'                  
   .','.    ..... .;;'.      ONxc,;xWMMMX:      .,;;;'.     
   :OOOd.  ,OOOO::OXX0x'     dc.   .0MMMN:    .cxKXXX0x,    
   oMMMK.  cMMMMKXMMMMMO.    '      xMMMN:   ,ONMMMMMMM0'   
   oMMMK.  cMMMMMMMMMMMWx.          dMMMX;   xMMMMMMMMMMk.  
   oMMMK.  cMMMMMMMMMMMMX;          dMMMX;   OMMMMMMMMMMX;  
   oMMMK.  cMMMMMMMMMMMMNl          dMMM0'   OMMXOkONMMMN:  
   oMMMK.  cMMMMW0oxNMMMM0.         kMMMo    ONk;...kMMMMo  
   oMMMK.  cMMMMO' .dMMMMN,        .0MMN;    dl.    cMMMMd  
   oMMMK.  cMMMWl   ,NMMMM;        :NMMO.    '     .oMMMMx  
   oMMMK.  cMMMWl   .0MMMMc       .kMMMl         ,lxXMMMMx  
   oMMMK.  cMMMWl   .kMMMMc       ,KMMM:        .dXMMMMMMx  
   oMMMK.  cMMMWl    kMMMMc       oNMMX'       .oKWMMMMMMx  
   oMMMK.  cMMMWl    xMMMMc      'XMMWd      .lOWMMXKMMMMx  
   oMMMK.  cMMMWl   .OMMMM:      dMMWk.      :NMMNk:lMMMMx  
   oMMMK.  cMMMWl   'NMMMW;     ,XMMX;       kMMWx. :MMMMx  
   oMMMK.  cMMMWc   ;WMMMW,     lWMM0'....  .0MMW:  :MMMMx  
   oMMMK.  cMMMMx.  lMMMMN'    .OMMMXxdddd, 'KMMN;  :MMMMd  
   oMMMK.  cMMMMNx:lKMMMMO.   .xWMMMMMMMMMd ;NMMN;  cMMMMk. 
   oMMMK.  cMMMMMWNWMMMMNl    oNMMMMMMMMMMd ,XMMWx;:0MMMMNk,
   oMMMK.  cMMMMMMMMMMMWx.   ,NMMMMMMMMMMMd .0MMMWXXMMMMMMN:
   oMMMK.  cMMMMWWMMMMMO.   .kMMMMMMMMMMMMd  xMMMMMMXNMMMMN;
   oMMMK.  cMMMMNWMMMMMo    'KMMMMMMMMMMMMd  lMMMMMMkKMMMMX,
   oMMMK.  cMMMWkkNNNXk,    'kOOOOOOOOOOOOc  'OXNNXk;dXNNKo.
   dMMMK.  cMMMWl.:::;.     ...............   .;::;. .;::,  
  .kMMMK.  cMMMWl                                           
  lNMMM0.  cMMMWl                                           
 ;XMMMMk   cMMMWl                                           
 lMMMMMx   cMMMWl                                           
 :MMMMMo   cMMMWl                                           
 'NMMMN;   cMMMWl                                           
 .kMMNd.   cMMMWl                                           
  cX0c.    :XXXXc                                           
  .;'      .;;;;.                                           


COLORED IMAGES

You can also make coloured HTML images. They use CSS however, so currently we
can't display them
correctly with Amiga Browsers.

--html
Make ASCII output in strict XHTML 1.0, suitable for viewing with web browsers.
This is useful with big output dimensions, and you want to check the result with
a browser with small font.

--html-fill
When used with --html and --color, then color each output character's background
color.  For instance,
if you want to use fill-output on a light background, do

jp2a --size=60x60 --color --html --html-fill --background=light somefile.jpg
--output=dark.html

To do the same on a light background:

jp2a --size=60x60 --color --html --html-fill --background=dark somefile.jpg
--output=light.html

The default is to have fill disabled.

--html-fontsize=N
Set fontsize when using --html output.  Default is 4.

--output=...
Write ASCII output to given filename.  To explicitly specify standard output,
use --output=-.

-i --invert
Invert output image.  If you view a picture with white background, but you are
using
a display with light characters on a dark background, you shoudl invert the
image.

--red= ...
--green= ...
--blue= ...
When converting from RGB to grayscale, use the given weights to calculate
luminance.
These three floating point values must add up to exactly 1.0.
The default is red=0.2989, green=0.5866 and blue=0.1145.


SIZE

--size= WIDTHxHEIGHT
Set output dimension.


FINAL WORDS

For a deeper understanding of how this app works look in the source/man/ drawer
for a indepth usage guide
that unfortunately is in the unix man format.
You could also get some info from the official homepage -->
http://jp2a.sourceforge.net/

Have fun! / Spot