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
| |
