view color images and 3d scientific visualization inside an ssh terminal (screenshots using putty ssh terminal included)
Project description
################################################################################
this is a moderately complex python3.0 script for performing fast, high quality
graphics -> ascii conversions. it relies on py3to2 in order to use PIL &
numpy extension modules. for performance, portions of it have been inlined w/
direct C code using scipy.weave.
asciiporn can easily render & display megapixel images on a 1ghz 500mb machine.
asciiporn's main purpose is to provide ascii-converted, high-quality,
color-3d plots within an interactive python txt terminal.
however, its fast txt-rendering engine can also b used for viewing image files.
screenshots of both applications r included w/ this distribution.
if something fails, try updating ur install of py3to2 to the latest version @:
http://pypi.python.org/pypi/py3to2
how to enable 256 color in putty: http://www.emacswiki.org/emacs/PuTTY#toc2
how to enable 256 color in xterm: http://www.frexx.de/xterm-256-notes/
asciiporn is hard-coded to use lucida-console font, but courier font will work
as well. the screenshots show putty ssh w/ lucida-console 5pt.
AUTHOR:
kai zhu
kaizhu@ugcs.caltech.edu
REQUIREMENTS:
- posix os
- Python Imaging Library http://www.pythonware.com/products/pil
- numpy http://www.scipy.org/Download
PSEUDOMETHOD:
asciiporn uses ".." syntax notation for pseudomethods
goto: http://pypi.python.org/pypi/pseudomethod
for more details about this feature
API:
asciiporn module:
- img2plaintxt - converts image file to portable plain txt
u can copy & paste in documents
- img2txt - converts image to high-quality colorized txt
for display on terminals supporting 256 color (putty, xterm...)
- plot - plot multiple 2d functions
- plot3d - plots a 3d function that takes in 2 parameters
INSTALL:
python setup.py build
python setup.py install
python setup.py dev --quicktest
################################################################################
PLOT USAGE:
2d plots take 2 main arguments:
y - a list of functions to plot
trange - t domain
>>> import asciiporn, numpy
>>> asciiporn.plot(
... ft = [ # list of single argument functions
numpy.cos,
numpy.sin,
lambda t: numpy.sin(t + 0.25),
],
... tmin = 0.0, tmax = 7.0, # range of t
... )
SIDEVIEW Y: Z 0 to 2 Y -0.99983900113 to 1.0 T 0.0 to 7.0 MIN MAX
l?*~_-----_>cC}lTl{7Tx_--------------------------------------------_+*Tll'*+_---
| T, ,r',*l '_ ), .( `-_
| a_ / )_ \_ ,* ,(
| ,C ~C `. , ) )
| ) > \ \ \ / / (
| / / \ '_ ^ ' _^ '
| ( ' '_ `_ ) ' ' ,'
|r _' `c '_ ,' ,' ,
( ' _ c ` , ,' ,
| ' `c c `_ , , .
|' `c _ ` , ,' +
----------------`---------------L-`-------------- --.--------------,'-+--------
| _ c `_ . ,' +
| _ `C ` . ,' +
| c . . ,
| `C , c , , )
| , . ?c ) ) /
| x t . / < /
| \ \ \ ( / _*
| '_ '_ ;C ,' ,'
| x (%) x x _x
| '< _>' ?x_'C >'_r'
|------------------------------`*<____>r------`*<{jy_yj1+*'---------------------
3d plots have an extra argument:
zrange - z domain
>>> import asciiporn, numpy
>>> asciiporn.plot3d(
... y = lambda t, z: numpy.sin(t + t*z), # y is now a fnc taking 2 args (t, z)
... tmin = 0.0, tmax = 7.0, # range of t
... zmin = 0.0, zmax = 0.25, # range of z
... )
SIDEVIEW Y: Z 0.0 to 0.25 Y -0.999 to 0.9999 T 0.0 to 7.0 MIN MAX
|---------`WDHbPgHHbmW_---------------------------------------------_mH&&EHH&&EH
| q88'' 'b&EHD_ _mdHH&&QmH&&dm
| _M&W` NEHHbW_ s8&mHH8&gHF8&dm
| _HHl #HHb&&p `=bM@mjjD@d@]hIdH
| _HF' ]Hb&&IL j]kM@m&ahMgk]uHB'
| _bg ]b&&IHm` sdkAUh$kkUP$F]l+'
| `8h 3&&IHm#` ?hm]k[hdFElP]F%nl
| HC d&Imm&8` (UhhEk1{jJk[1j]L`
| M' 8dHb&&d_ _dPUR]k{hRF}P[6i'
|j' mHm&&dH` _]ahUg]k[3B}jCf]
_C `Hb&&dHH_ Ak}1U%]6UC&jFh+`
'----------------- ---------'b&&mmm&_------ -------------s$k4hU%]]CnjFjT`-------
| 3&&mmH@@, cI$]kppA}}nhB]J`
| 8&$mH&&8_ -Dhd]dUhA]}{3&J'
| `gmHH8&dH` _aMM$kaUh%]]huj
| `mHH&&dHH_ `jg@Qd&4MKd}aPl`
| 'HH8@HHH&_ _]jgDMdk}UUdk}T`
| 'H&8HHH&&, @mHaDMdkk@@HA*
| '&&dHH&&dL q8mmb&#dkE@@d'
| ?&EDH&&dHH_ `g&Wmmb&8dH$&@'
| ?dHH&&EHH&p``mb&8mmD8&dHbl`
| `WH&&EHH&&8HHb&EHHD&8dF'
|--------------------------------------'NMEHH&&EHHb&EHHbMPl---------------------
TOPVIEW Z: Z 0.0 to 0.25 (top to bottom) Y -0.9999 to 0.9999 T 0.0 to 7.0
DOGKz1(7Lx\:,-'` `._~>r?;tfVne6H MQpZaV}oTY?+(,!'` `'-_>+|/Cc[]KPRg 8REnVSt7
DOGKX3(7/vi:_-` `-_~iv/YcS{aZqm &8qI4yzts7r~i'-` `-'i~r7stjy4Iq8& dqEa{jtYL
DAG5X3cY/vi~_.` `'-,:|xJT=3y4U9 Wm0EXnFTY?\(_!.` `'!,:\l^)Fn3U9mN m%Za{j=Y?x
DAZ5{jcY?r>~_.` `''!(+lsCf}neR8 $gRI4yz=slx*i'.' `'-_(+rYT2[]GO6D D9U5X3=T?r*
DAZa{jt;?r>!'.` `._~i|/YcoV5GOd BH9GXnF)Y?\:_-'` `.!i~vLstj{3PhbN HqE][fCsx*i
DAZa{jt;l|(!'.` `._~irL7=j{4U9 @D6OK][oT7r*>'.' `'-_(\|Y)FnXGqd# bAZa[ft;l+(~
mqEaVoCsl|(,-' '.,: J)2}yeR8 &bhP3{jts?\:,-'` `.'i*r7Jo[VawmW OG5XSc;?r>!_
mqEnVoCs^+:,-' `'-!(+^;tSkuGOd WmAeV[oTYr*>'.` `'!,(vL^)fy4PhQ 8U4z1cY?ri!'.
mqEnkS)Jx*:_-' `'-~>|l7(j{50h gRZK{jtsl\:,!'` '-'>*|YT2k3U9H Hqwy}27/v\:'.'
mqeukS)Lx*~_.` `.'~|r/)F1ywqH $d9U3}2TY|*>'-` `.!,:v7J=zXGO6W dOZu[fCLv\:,.``
mqeu[fTLv\~'.` `._:*xLtfkueOm #%0EVfcslx:,!'` `-_(+|^)S{KZRg 9IKVSt;x*(,-`
mReu[fT/v\!'.` '-_(+^sco{5Gh @DhP5uF(Y?\>'-' `'!,:vLJ=z]eAHB Hqeu1FTL|i~'.`
mRe][27/ri!''` `'-,>|l;=3z4U8 $89e1noC/r*i!.` `._(+|Ytj{5w%D OZaV2)Jxi~_.`
mRP]}27?ri!-'` `''!ir?72}]PRd #H0a]zt^Lv:_-' `'!i~x7J2}Xeh8 8UKXjts^+:_.` `
dRP]}FY?|>,-' `.'! LTSknZA D%I5{ST/|*>!.` `.'(\?;)zyawH# dAPy1FYl|>,-' '
d6Py1F;l|>,-' `._~*xJCjXKI9 $8hGX}oslv:,-' `'!,*r/Cok3IhD 9InkfC/ri~-'` '-
d6wy1=;l+(_.` `-_:+l;c1yw68 #HAKyftY|+>_.` `.'>\L^tjVGOm 86w{oc;x\:_.` `._
d6wz3=s^+(_.` '-,(r?7=[uEA DRZ3kF(7x~i!'` '!,:r/T2n4ZRQ dAEu3=7?+(,-` `'_~
d6wz3(s^*(_.` `''!>vLT2V5G% $8qUV[=J?\(_-` `.'>*?^tjuGAH# p04zSCJxi~'.` '-~i
d6wz3(sx*:'.` `''!ixJ)fXKUh NdAGyft^|*>'.` `-,:v/C2n1ZRQ qe]}(Yl+:_.` `._(+
d04XjcJx\:''` `.'~\^stoywRH W6wKkFTYx:,!' `''>*|^tfya9b& 9GaVST/ri,-' `.'~*x
d04XjcJv\~-'` `._:*lY(3uEAm gpI3[=Jl+(_-` `.,:vlT2n3I6W m6wzj(Jx\:''` `''!>vL
d04XocLv\~-' `-,(+/7F}aG9 @d9GVj);?~i!.` '-i~r/)jyK0d& 8Gakf)?|>!.` '-,(+/T
asciiporn can also plot user-supplied (y,t) datapoint pairs:
>>> import asciiporn, numpy
>>> t = numpy.arange(1000) # create t coord datapoints
>>> y = numpy.sin( 0.01*t ) # create y coord datapoints
>>> yt = list(zip( y, t )) # create (y,t) datapoint pairs
>>> asciiporn.plot( yt = yt )
SIDEVIEW Y: Z 0 to 0 Y -0.99999 to 0.99999 T 0.0 to 999.0 MIN MAX
|--------_<?l'*c-------------------------------------------->*'lt<--------------
| >' \_ ~' '_
| / `c / ,
| ^ ` / >
| / v v
| / ` , c
| , ' `
| Y ^ | ' / ,
|/ - ,
| \ `
'----------- ------------L----------- ------------/------------------------:----
| s
| ^ `
| l ^ | c / >
| ` , c
| ^ `
| \ '
| Y _'
| \ _'
| \_ .'
|---------------------------------`>_,_.*---------------------------------------
################################################################################
IMAGE USAGE:
in this example, u'll b loading the image file included w/ this distribution,
"mario.jpg". its a fairly large image, so u prolly want to scale it down
to 0.5 (or less):
>>> colortxt = asciiporn.img2txt("mario.jpg", scale = 0.5)
>>> print( colortxt )
... beautiful color image appears ^_-
>>> plaintxt = asciiporn.img2plaintxt("mario.jpg", scale = 0.5)
>>> print( plaintxt )
... rather plain b/w img -_-, but u can copy & paste in documents ...
__*^>_` ~+| ~rL!!_ ?*_> r '@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
^M`__| |`ttY>r_t-LLkoi^ ( ' +@@@@@@@@@@@@@@@@M@@$lh@3MM@@@@@@@@@@@@@@@@@@@@@
^g@$@&_`^'t|x!lt'T7`\^]_ gp_ `rwM@MMMMP@M@@@@@R =/n7_`|!I@@@@@@@@@@@@@@@@@@@@
`@@@@@B ' ` !'^'?''^=&g, _@u ^SJE^?{L-|+SF$tJsA#N&@ajqJnr}@@@@@@@@@@@@@@@@@@
`@@@@@B ``` ` | ^ 1@$In TF) .=kL'> '^{?^ Lt'yC d@&M@g@2@@@@@@@@@@@@@@@@@@@
_`MN@Qh- ^ > _ `|`v4$g&gg@J^t[MR~ / Y7EXE,-> Yjggg&m@@@$#&@@@@@@@@@@@@@@@@@@
`' `!'' '` (_&@#@@@@@jMmK4g(^ `r~ {' ^i[g@@@@@@$@@@$99@@@@@@@@@@@@@@@@@
`'~ J\+ >i3@q@N&g@p@&}@VMw?^`>C~J' g@&@W@@@@$&@$@@$6|@M@@@@@@@@@@@@@@
` xT ~ _'^ [^ka#$@@@@$@M#Wa]?Zt{|` ' qMM@@&@@M@@@&&@@M@MS]@@@@@@@@@@@@@@
' ^ r _~^tcy^R{@@@@@MbMwI-]VjL{7+i{_#%$@M@@M@B&&MM###@W''CHP}#@@@@@@@@@
`~ ) ' i `c_CzN]&&&&$qpZT@WW=\L,Li']{N@MMMM#BM#$#M$M#u LL^ `I`j@@@@@@
' '` ` _^*^``' 'fM&8&g_')qk@-i't_rw@$}j&#&#MM@&&@gp=3WWc _= -zLdM@@@
' ` ` `' ` ^M#$&a.]]`~J` ^`jg@@@@W@#M@@@@$$@@\`Vo|L{^'`'`^)@@@
` , ` '_ ``' 5 CtT{'a@5^ ` i ^`T#M@B=WW`il^|~! +L7i$
` ' ^' ` ( j` ` `J!{' ''Y_r q&?+g#BgR ^ >` ^-=#@$$#W `'~_C^{ _ ' ' >^[r` `t]' > _=E 7`q&@@@@@@b ` { _>j,^vg##@$$&$ ```v-^c
'_i Q&A_+_ V}?`s =NNByA-IlElX|lL?_vJv,}$W]{?@$M$@@MP ` |L`so_
` ` ^ `@@kVcV{9=/2MX@$@PGY_`,~L=yv_%#X+\}M]Qm${#A@@W' ` `Y *!'
` t=Ft?W$M8#|\@@9kL' ` &&WkmWjBY)>J{9&R]Aw@W&@@ _ '`
' ` |k~!~=osC^YC^`)[_ ^ `$@@mm^' +Nm+^VA#@$M&M@M@b!__ ^ `
' ` ' ` '|)!`-~x),ti'~-` `=$@h&'q&gp`=[#P@&w&&$M##@@p&gggMMDa> '`
`jh[u_\c]l`!(_, __y$g}j[p@Y@r 04@#WM@MM&W$@@@@@@M@@@&@W ``
`YTM4d)!r ;#}]s#M@A&@MM@$WW! ~VP1EjIEMM$&@M@M9#$@@M@#&k)_
`_p {f)+' i{>3f\^GcLP]Vt^AM@y _ag=-cmA@WM@@M@MyE@Z[#MMMMM$E
Smk' _ +3G@ {F/r, s{[' ^'|j+\_Arxto '8kGXd#@B$mw@$@W@#$yZ@{}9G6(B@@@@
&We ,=#|j=Y`^#m Y-y+?T|''!T|r_r =,[`_ =ltmj&N$MB9NM&MMDuX4?Tr=L(~Yk3Y1A
@@&_ `' sA#W&}@swn=~ ? `'7t r !,|F ^@L`^`{ ^(`4THDK&&&##F`i`x`ym'\[c_`z- > '
@@@@p ]#j@J{}-frL 7 c )`^ -^{'>^`7`1i>>Jcr .^ _[jT_` ^*;r 2V|J_=Lrts l
@@@@&__~FeSe\AY^t+ ^>`_ L~'~ ! v| ~ ;rY~' ` v +^Ji!_\^` ' ^++|{\ z^_l'!|i_^
@@@@#&sJ=^T!^=[_`>_J>/Xr`'|`` i^tr !!c[-Yyz` ^ >x`J` ,- `! ,_`_(r_\-l'(i, i'`
@@@M@@m]~Y{^r_{`=LjWi)^---v `_'_ `^^) J]1L '^ __^ t{_\{L{+ (`^'L)))(FLLtxJ `
@@MM@#^yL>'^J'c+_l/?^|L , , xS!'`Y=`ti!++-S>_` '' {'s`_ ,' Y!o,t|==(rj^`+s^J `
@@@@&R(+{!' _-k(r^{ !^!T-TriL``=~`Vg$K+T|ge`J``i t_i^ ^ t) `+Cr_!ix^{`\{` `
@M@@@`^^`i `_'=}/iY +/r1^) `r->`J`Yy@Alyi-f4L|' + t`_`^) '~ -`+` !xT 'Jo{ '
@@M&A ` ~```, =^ '|+!r>Y1!~^({^`|^Q@ttt^}_ !r `ap ?-_```` _ ^ v '`']!^ '`
M#@W})v t'_#M! c=_-! l`!|\~` ``{tt~YYYY+n'-,` =#4~r-t~>`|`>`~'`'~ t l^({ '
&@#M-'s _(@Ai^ r-i ||ct3J| t~x1rL{\?Jt-'[ wMp 3$M,``?C '+ r_ ` ```| cLi)~
@$@b- v'wE@`` )!`77`'_-7 `_`|r_|tc=i11\XT!?3@pW@# `'-` |'`J>'`7``___ |^`|^~_ `
M@$N!^'}M@$Mg_ `_g1 `!_J ++i_tzj}gggMcn`@Ak@$&` ' ' `' ~` C`-r'_J7JvL
@@$\`>#M]=W$@@R&&&l` ,i! _='i]j'Jw#M@@$&z7|gW&M@@Wa@@w `+ ' (`'> |iJkrY*)
M#$\ &Wq&A&M@$#M@ ypy``i|+Vr+Ly?Yyd@@@@MMK\=@@@&g@$f#M `` _ ,r^]^'t^r?!r`
M@M-Cys&&B@W$&MB ^#&86vc+r^++{L!!C@@M&$@#Y`g&&M@@@@g$! '- i!tS'_k! j^vt`r
&$F=B=]?WM@&@#l``[@8@ki(-'\+V{Jcc=?3$@MP^^_@@MMM@@$@R7- ) > v)f!>~`v3JT_^_`
@MMNa_=x{^JV@@ v`]&kN\|r{-)]ls=wcl/3/?--}\~ W^hN$h7` `'```>, _ jLt(v>r )m}*7^i
f'?=+Sn^Ji!vtz `8]Lr5\^kc3tizz\`Cin>Tb)_{\ (^[Y_[GF^ i` l` n{~ ` ~ xYGL>~>=
*F(-^Y`]G$p~`` {)^\c_+iJJJ=_]_^SL{ti^2_ >LMQM&N` `_ {_)vY+ __{``_-yw+_Cu
` i`rY =Z%k[1-[!l')''`7TTT+^/==|Vc'_oL-~ ^1%WW&Hc ' ````o!r_7?)vT? ^`-3Y}|+>
! i '!''offC`'jJ^` i_?L`_\?}[>v~j/?|+i_ (lv)}=- >~!!> `''`{ >xiT`` v _i[_cg
` (4g]^~ 7 `~ v!+rTx\k?|J`|L`*T)J)-*|^_'' )R->^`R 't_ `! x^` `i^^/{=T*
@&6+=@MWB$y i`' + T_r^jr)rwY?_,^}'~r|r(t_^L ` dR ``'')^J!`{`J-V_ _r 'X[A==
' @WWM@@@@R8^!`L) j==^^?J^r^|_tS>,`l!2r_rL`( ` `_H@={!>-L `J\ ` ~VJs` ~ |{i(Tg
_`]}M&M@WT_ ```rjS`_? >-{^r-7TxY{V|j]^)i `` ^V`^'*{ '>, {{ `iiz,~`' >' ~^^7
` ^^3@@@x ' _{i)'l`^ \LTiC!!kiL1||)[i3T>!' r ` _(! iT '_ \i(_ _ \^`7
' gg&&gMP__|+^ii s`|ir^`'s)_|^,c\J|lij_f ^!_r i` ( rr ~r7 i`_ ',^
`$@W@&$zJ-^(` ```s Xj`_j>^-!Txt7=X!)`k?L+-i >_i ) ` |`_`^ 'i^(x !! ^!
_&##M@&'^i' `'_j')`+tr+|7,yLrbJC{|TL^C^ J ^' `L`^ +?_v_ C cur
3$$MM@->SC x*_>x )|rV^^l!_?kI{{[_y!~ { ` s' '!_^Js> `t{\_``
B `[&&&z\o^Yx?(-{ '{'s*|-cn=7)T&l=s=SrL _!l`+r `_`>l+,`Y `_^`!_
$L @}Wi >7^__iY> +r ?`~ !_=^({nL^j\ T ` ` ^ _` +~ L '! ttt_~i|!X`^i\]
@@ ~&LifL(*'=! \V_{ct7{+c(Jv_'>v'L i _ i c`\{^ v ` \^ ^ s,_`^L
actually, the plaintxt prolly won't look well when pasted,
b/c most document readers invert the color:
>>> plaintxt = asciiporn.img2plaintxt('mario.jpg', scale = 0.5, invert = True)
>>> print( plaintxt )
... b/w img w/ colors inverted. may look funny now :/
but it'll b normal when pasted in document
################################################################################
RECENT CHANGELOG:
20080121: removed py3to2 requirement
20090103
rewrote 3d plotter
fixed more 64bit issues
20081123
fixed bug where 64bit gets truncated to 32 on 32bit machine
256 color support
20081119
fixed bugs in setup.py
this is a moderately complex python3.0 script for performing fast, high quality
graphics -> ascii conversions. it relies on py3to2 in order to use PIL &
numpy extension modules. for performance, portions of it have been inlined w/
direct C code using scipy.weave.
asciiporn can easily render & display megapixel images on a 1ghz 500mb machine.
asciiporn's main purpose is to provide ascii-converted, high-quality,
color-3d plots within an interactive python txt terminal.
however, its fast txt-rendering engine can also b used for viewing image files.
screenshots of both applications r included w/ this distribution.
if something fails, try updating ur install of py3to2 to the latest version @:
http://pypi.python.org/pypi/py3to2
how to enable 256 color in putty: http://www.emacswiki.org/emacs/PuTTY#toc2
how to enable 256 color in xterm: http://www.frexx.de/xterm-256-notes/
asciiporn is hard-coded to use lucida-console font, but courier font will work
as well. the screenshots show putty ssh w/ lucida-console 5pt.
AUTHOR:
kai zhu
kaizhu@ugcs.caltech.edu
REQUIREMENTS:
- posix os
- Python Imaging Library http://www.pythonware.com/products/pil
- numpy http://www.scipy.org/Download
PSEUDOMETHOD:
asciiporn uses ".." syntax notation for pseudomethods
goto: http://pypi.python.org/pypi/pseudomethod
for more details about this feature
API:
asciiporn module:
- img2plaintxt - converts image file to portable plain txt
u can copy & paste in documents
- img2txt - converts image to high-quality colorized txt
for display on terminals supporting 256 color (putty, xterm...)
- plot - plot multiple 2d functions
- plot3d - plots a 3d function that takes in 2 parameters
INSTALL:
python setup.py build
python setup.py install
python setup.py dev --quicktest
################################################################################
PLOT USAGE:
2d plots take 2 main arguments:
y - a list of functions to plot
trange - t domain
>>> import asciiporn, numpy
>>> asciiporn.plot(
... ft = [ # list of single argument functions
numpy.cos,
numpy.sin,
lambda t: numpy.sin(t + 0.25),
],
... tmin = 0.0, tmax = 7.0, # range of t
... )
SIDEVIEW Y: Z 0 to 2 Y -0.99983900113 to 1.0 T 0.0 to 7.0 MIN MAX
l?*~_-----_>cC}lTl{7Tx_--------------------------------------------_+*Tll'*+_---
| T, ,r',*l '_ ), .( `-_
| a_ / )_ \_ ,* ,(
| ,C ~C `. , ) )
| ) > \ \ \ / / (
| / / \ '_ ^ ' _^ '
| ( ' '_ `_ ) ' ' ,'
|r _' `c '_ ,' ,' ,
( ' _ c ` , ,' ,
| ' `c c `_ , , .
|' `c _ ` , ,' +
----------------`---------------L-`-------------- --.--------------,'-+--------
| _ c `_ . ,' +
| _ `C ` . ,' +
| c . . ,
| `C , c , , )
| , . ?c ) ) /
| x t . / < /
| \ \ \ ( / _*
| '_ '_ ;C ,' ,'
| x (%) x x _x
| '< _>' ?x_'C >'_r'
|------------------------------`*<____>r------`*<{jy_yj1+*'---------------------
3d plots have an extra argument:
zrange - z domain
>>> import asciiporn, numpy
>>> asciiporn.plot3d(
... y = lambda t, z: numpy.sin(t + t*z), # y is now a fnc taking 2 args (t, z)
... tmin = 0.0, tmax = 7.0, # range of t
... zmin = 0.0, zmax = 0.25, # range of z
... )
SIDEVIEW Y: Z 0.0 to 0.25 Y -0.999 to 0.9999 T 0.0 to 7.0 MIN MAX
|---------`WDHbPgHHbmW_---------------------------------------------_mH&&EHH&&EH
| q88'' 'b&EHD_ _mdHH&&QmH&&dm
| _M&W` NEHHbW_ s8&mHH8&gHF8&dm
| _HHl #HHb&&p `=bM@mjjD@d@]hIdH
| _HF' ]Hb&&IL j]kM@m&ahMgk]uHB'
| _bg ]b&&IHm` sdkAUh$kkUP$F]l+'
| `8h 3&&IHm#` ?hm]k[hdFElP]F%nl
| HC d&Imm&8` (UhhEk1{jJk[1j]L`
| M' 8dHb&&d_ _dPUR]k{hRF}P[6i'
|j' mHm&&dH` _]ahUg]k[3B}jCf]
_C `Hb&&dHH_ Ak}1U%]6UC&jFh+`
'----------------- ---------'b&&mmm&_------ -------------s$k4hU%]]CnjFjT`-------
| 3&&mmH@@, cI$]kppA}}nhB]J`
| 8&$mH&&8_ -Dhd]dUhA]}{3&J'
| `gmHH8&dH` _aMM$kaUh%]]huj
| `mHH&&dHH_ `jg@Qd&4MKd}aPl`
| 'HH8@HHH&_ _]jgDMdk}UUdk}T`
| 'H&8HHH&&, @mHaDMdkk@@HA*
| '&&dHH&&dL q8mmb&#dkE@@d'
| ?&EDH&&dHH_ `g&Wmmb&8dH$&@'
| ?dHH&&EHH&p``mb&8mmD8&dHbl`
| `WH&&EHH&&8HHb&EHHD&8dF'
|--------------------------------------'NMEHH&&EHHb&EHHbMPl---------------------
TOPVIEW Z: Z 0.0 to 0.25 (top to bottom) Y -0.9999 to 0.9999 T 0.0 to 7.0
DOGKz1(7Lx\:,-'` `._~>r?;tfVne6H MQpZaV}oTY?+(,!'` `'-_>+|/Cc[]KPRg 8REnVSt7
DOGKX3(7/vi:_-` `-_~iv/YcS{aZqm &8qI4yzts7r~i'-` `-'i~r7stjy4Iq8& dqEa{jtYL
DAG5X3cY/vi~_.` `'-,:|xJT=3y4U9 Wm0EXnFTY?\(_!.` `'!,:\l^)Fn3U9mN m%Za{j=Y?x
DAZ5{jcY?r>~_.` `''!(+lsCf}neR8 $gRI4yz=slx*i'.' `'-_(+rYT2[]GO6D D9U5X3=T?r*
DAZa{jt;?r>!'.` `._~i|/YcoV5GOd BH9GXnF)Y?\:_-'` `.!i~vLstj{3PhbN HqE][fCsx*i
DAZa{jt;l|(!'.` `._~irL7=j{4U9 @D6OK][oT7r*>'.' `'-_(\|Y)FnXGqd# bAZa[ft;l+(~
mqEaVoCsl|(,-' '.,: J)2}yeR8 &bhP3{jts?\:,-'` `.'i*r7Jo[VawmW OG5XSc;?r>!_
mqEnVoCs^+:,-' `'-!(+^;tSkuGOd WmAeV[oTYr*>'.` `'!,(vL^)fy4PhQ 8U4z1cY?ri!'.
mqEnkS)Jx*:_-' `'-~>|l7(j{50h gRZK{jtsl\:,!'` '-'>*|YT2k3U9H Hqwy}27/v\:'.'
mqeukS)Lx*~_.` `.'~|r/)F1ywqH $d9U3}2TY|*>'-` `.!,:v7J=zXGO6W dOZu[fCLv\:,.``
mqeu[fTLv\~'.` `._:*xLtfkueOm #%0EVfcslx:,!'` `-_(+|^)S{KZRg 9IKVSt;x*(,-`
mReu[fT/v\!'.` '-_(+^sco{5Gh @DhP5uF(Y?\>'-' `'!,:vLJ=z]eAHB Hqeu1FTL|i~'.`
mRe][27/ri!''` `'-,>|l;=3z4U8 $89e1noC/r*i!.` `._(+|Ytj{5w%D OZaV2)Jxi~_.`
mRP]}27?ri!-'` `''!ir?72}]PRd #H0a]zt^Lv:_-' `'!i~x7J2}Xeh8 8UKXjts^+:_.` `
dRP]}FY?|>,-' `.'! LTSknZA D%I5{ST/|*>!.` `.'(\?;)zyawH# dAPy1FYl|>,-' '
d6Py1F;l|>,-' `._~*xJCjXKI9 $8hGX}oslv:,-' `'!,*r/Cok3IhD 9InkfC/ri~-'` '-
d6wy1=;l+(_.` `-_:+l;c1yw68 #HAKyftY|+>_.` `.'>\L^tjVGOm 86w{oc;x\:_.` `._
d6wz3=s^+(_.` '-,(r?7=[uEA DRZ3kF(7x~i!'` '!,:r/T2n4ZRQ dAEu3=7?+(,-` `'_~
d6wz3(s^*(_.` `''!>vLT2V5G% $8qUV[=J?\(_-` `.'>*?^tjuGAH# p04zSCJxi~'.` '-~i
d6wz3(sx*:'.` `''!ixJ)fXKUh NdAGyft^|*>'.` `-,:v/C2n1ZRQ qe]}(Yl+:_.` `._(+
d04XjcJx\:''` `.'~\^stoywRH W6wKkFTYx:,!' `''>*|^tfya9b& 9GaVST/ri,-' `.'~*x
d04XjcJv\~-'` `._:*lY(3uEAm gpI3[=Jl+(_-` `.,:vlT2n3I6W m6wzj(Jx\:''` `''!>vL
d04XocLv\~-' `-,(+/7F}aG9 @d9GVj);?~i!.` '-i~r/)jyK0d& 8Gakf)?|>!.` '-,(+/T
asciiporn can also plot user-supplied (y,t) datapoint pairs:
>>> import asciiporn, numpy
>>> t = numpy.arange(1000) # create t coord datapoints
>>> y = numpy.sin( 0.01*t ) # create y coord datapoints
>>> yt = list(zip( y, t )) # create (y,t) datapoint pairs
>>> asciiporn.plot( yt = yt )
SIDEVIEW Y: Z 0 to 0 Y -0.99999 to 0.99999 T 0.0 to 999.0 MIN MAX
|--------_<?l'*c-------------------------------------------->*'lt<--------------
| >' \_ ~' '_
| / `c / ,
| ^ ` / >
| / v v
| / ` , c
| , ' `
| Y ^ | ' / ,
|/ - ,
| \ `
'----------- ------------L----------- ------------/------------------------:----
| s
| ^ `
| l ^ | c / >
| ` , c
| ^ `
| \ '
| Y _'
| \ _'
| \_ .'
|---------------------------------`>_,_.*---------------------------------------
################################################################################
IMAGE USAGE:
in this example, u'll b loading the image file included w/ this distribution,
"mario.jpg". its a fairly large image, so u prolly want to scale it down
to 0.5 (or less):
>>> colortxt = asciiporn.img2txt("mario.jpg", scale = 0.5)
>>> print( colortxt )
... beautiful color image appears ^_-
>>> plaintxt = asciiporn.img2plaintxt("mario.jpg", scale = 0.5)
>>> print( plaintxt )
... rather plain b/w img -_-, but u can copy & paste in documents ...
__*^>_` ~+| ~rL!!_ ?*_> r '@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
^M`__| |`ttY>r_t-LLkoi^ ( ' +@@@@@@@@@@@@@@@@M@@$lh@3MM@@@@@@@@@@@@@@@@@@@@@
^g@$@&_`^'t|x!lt'T7`\^]_ gp_ `rwM@MMMMP@M@@@@@R =/n7_`|!I@@@@@@@@@@@@@@@@@@@@
`@@@@@B ' ` !'^'?''^=&g, _@u ^SJE^?{L-|+SF$tJsA#N&@ajqJnr}@@@@@@@@@@@@@@@@@@
`@@@@@B ``` ` | ^ 1@$In TF) .=kL'> '^{?^ Lt'yC d@&M@g@2@@@@@@@@@@@@@@@@@@@
_`MN@Qh- ^ > _ `|`v4$g&gg@J^t[MR~ / Y7EXE,-> Yjggg&m@@@$#&@@@@@@@@@@@@@@@@@@
`' `!'' '` (_&@#@@@@@jMmK4g(^ `r~ {' ^i[g@@@@@@$@@@$99@@@@@@@@@@@@@@@@@
`'~ J\+ >i3@q@N&g@p@&}@VMw?^`>C~J' g@&@W@@@@$&@$@@$6|@M@@@@@@@@@@@@@@
` xT ~ _'^ [^ka#$@@@@$@M#Wa]?Zt{|` ' qMM@@&@@M@@@&&@@M@MS]@@@@@@@@@@@@@@
' ^ r _~^tcy^R{@@@@@MbMwI-]VjL{7+i{_#%$@M@@M@B&&MM###@W''CHP}#@@@@@@@@@
`~ ) ' i `c_CzN]&&&&$qpZT@WW=\L,Li']{N@MMMM#BM#$#M$M#u LL^ `I`j@@@@@@
' '` ` _^*^``' 'fM&8&g_')qk@-i't_rw@$}j&#&#MM@&&@gp=3WWc _= -zLdM@@@
' ` ` `' ` ^M#$&a.]]`~J` ^`jg@@@@W@#M@@@@$$@@\`Vo|L{^'`'`^)@@@
` , ` '_ ``' 5 CtT{'a@5^ ` i ^`T#M@B=WW`il^|~! +L7i$
` ' ^' ` ( j` ` `J!{' ''Y_r q&?+g#BgR ^ >` ^-=#@$$#W `'~_C^{ _ ' ' >^[r` `t]' > _=E 7`q&@@@@@@b ` { _>j,^vg##@$$&$ ```v-^c
'_i Q&A_+_ V}?`s =NNByA-IlElX|lL?_vJv,}$W]{?@$M$@@MP ` |L`so_
` ` ^ `@@kVcV{9=/2MX@$@PGY_`,~L=yv_%#X+\}M]Qm${#A@@W' ` `Y *!'
` t=Ft?W$M8#|\@@9kL' ` &&WkmWjBY)>J{9&R]Aw@W&@@ _ '`
' ` |k~!~=osC^YC^`)[_ ^ `$@@mm^' +Nm+^VA#@$M&M@M@b!__ ^ `
' ` ' ` '|)!`-~x),ti'~-` `=$@h&'q&gp`=[#P@&w&&$M##@@p&gggMMDa> '`
`jh[u_\c]l`!(_, __y$g}j[p@Y@r 04@#WM@MM&W$@@@@@@M@@@&@W ``
`YTM4d)!r ;#}]s#M@A&@MM@$WW! ~VP1EjIEMM$&@M@M9#$@@M@#&k)_
`_p {f)+' i{>3f\^GcLP]Vt^AM@y _ag=-cmA@WM@@M@MyE@Z[#MMMMM$E
Smk' _ +3G@ {F/r, s{[' ^'|j+\_Arxto '8kGXd#@B$mw@$@W@#$yZ@{}9G6(B@@@@
&We ,=#|j=Y`^#m Y-y+?T|''!T|r_r =,[`_ =ltmj&N$MB9NM&MMDuX4?Tr=L(~Yk3Y1A
@@&_ `' sA#W&}@swn=~ ? `'7t r !,|F ^@L`^`{ ^(`4THDK&&&##F`i`x`ym'\[c_`z- > '
@@@@p ]#j@J{}-frL 7 c )`^ -^{'>^`7`1i>>Jcr .^ _[jT_` ^*;r 2V|J_=Lrts l
@@@@&__~FeSe\AY^t+ ^>`_ L~'~ ! v| ~ ;rY~' ` v +^Ji!_\^` ' ^++|{\ z^_l'!|i_^
@@@@#&sJ=^T!^=[_`>_J>/Xr`'|`` i^tr !!c[-Yyz` ^ >x`J` ,- `! ,_`_(r_\-l'(i, i'`
@@@M@@m]~Y{^r_{`=LjWi)^---v `_'_ `^^) J]1L '^ __^ t{_\{L{+ (`^'L)))(FLLtxJ `
@@MM@#^yL>'^J'c+_l/?^|L , , xS!'`Y=`ti!++-S>_` '' {'s`_ ,' Y!o,t|==(rj^`+s^J `
@@@@&R(+{!' _-k(r^{ !^!T-TriL``=~`Vg$K+T|ge`J``i t_i^ ^ t) `+Cr_!ix^{`\{` `
@M@@@`^^`i `_'=}/iY +/r1^) `r->`J`Yy@Alyi-f4L|' + t`_`^) '~ -`+` !xT 'Jo{ '
@@M&A ` ~```, =^ '|+!r>Y1!~^({^`|^Q@ttt^}_ !r `ap ?-_```` _ ^ v '`']!^ '`
M#@W})v t'_#M! c=_-! l`!|\~` ``{tt~YYYY+n'-,` =#4~r-t~>`|`>`~'`'~ t l^({ '
&@#M-'s _(@Ai^ r-i ||ct3J| t~x1rL{\?Jt-'[ wMp 3$M,``?C '+ r_ ` ```| cLi)~
@$@b- v'wE@`` )!`77`'_-7 `_`|r_|tc=i11\XT!?3@pW@# `'-` |'`J>'`7``___ |^`|^~_ `
M@$N!^'}M@$Mg_ `_g1 `!_J ++i_tzj}gggMcn`@Ak@$&` ' ' `' ~` C`-r'_J7JvL
@@$\`>#M]=W$@@R&&&l` ,i! _='i]j'Jw#M@@$&z7|gW&M@@Wa@@w `+ ' (`'> |iJkrY*)
M#$\ &Wq&A&M@$#M@ ypy``i|+Vr+Ly?Yyd@@@@MMK\=@@@&g@$f#M `` _ ,r^]^'t^r?!r`
M@M-Cys&&B@W$&MB ^#&86vc+r^++{L!!C@@M&$@#Y`g&&M@@@@g$! '- i!tS'_k! j^vt`r
&$F=B=]?WM@&@#l``[@8@ki(-'\+V{Jcc=?3$@MP^^_@@MMM@@$@R7- ) > v)f!>~`v3JT_^_`
@MMNa_=x{^JV@@ v`]&kN\|r{-)]ls=wcl/3/?--}\~ W^hN$h7` `'```>, _ jLt(v>r )m}*7^i
f'?=+Sn^Ji!vtz `8]Lr5\^kc3tizz\`Cin>Tb)_{\ (^[Y_[GF^ i` l` n{~ ` ~ xYGL>~>=
*F(-^Y`]G$p~`` {)^\c_+iJJJ=_]_^SL{ti^2_ >LMQM&N` `_ {_)vY+ __{``_-yw+_Cu
` i`rY =Z%k[1-[!l')''`7TTT+^/==|Vc'_oL-~ ^1%WW&Hc ' ````o!r_7?)vT? ^`-3Y}|+>
! i '!''offC`'jJ^` i_?L`_\?}[>v~j/?|+i_ (lv)}=- >~!!> `''`{ >xiT`` v _i[_cg
` (4g]^~ 7 `~ v!+rTx\k?|J`|L`*T)J)-*|^_'' )R->^`R 't_ `! x^` `i^^/{=T*
@&6+=@MWB$y i`' + T_r^jr)rwY?_,^}'~r|r(t_^L ` dR ``'')^J!`{`J-V_ _r 'X[A==
' @WWM@@@@R8^!`L) j==^^?J^r^|_tS>,`l!2r_rL`( ` `_H@={!>-L `J\ ` ~VJs` ~ |{i(Tg
_`]}M&M@WT_ ```rjS`_? >-{^r-7TxY{V|j]^)i `` ^V`^'*{ '>, {{ `iiz,~`' >' ~^^7
` ^^3@@@x ' _{i)'l`^ \LTiC!!kiL1||)[i3T>!' r ` _(! iT '_ \i(_ _ \^`7
' gg&&gMP__|+^ii s`|ir^`'s)_|^,c\J|lij_f ^!_r i` ( rr ~r7 i`_ ',^
`$@W@&$zJ-^(` ```s Xj`_j>^-!Txt7=X!)`k?L+-i >_i ) ` |`_`^ 'i^(x !! ^!
_&##M@&'^i' `'_j')`+tr+|7,yLrbJC{|TL^C^ J ^' `L`^ +?_v_ C cur
3$$MM@->SC x*_>x )|rV^^l!_?kI{{[_y!~ { ` s' '!_^Js> `t{\_``
B `[&&&z\o^Yx?(-{ '{'s*|-cn=7)T&l=s=SrL _!l`+r `_`>l+,`Y `_^`!_
$L @}Wi >7^__iY> +r ?`~ !_=^({nL^j\ T ` ` ^ _` +~ L '! ttt_~i|!X`^i\]
@@ ~&LifL(*'=! \V_{ct7{+c(Jv_'>v'L i _ i c`\{^ v ` \^ ^ s,_`^L
actually, the plaintxt prolly won't look well when pasted,
b/c most document readers invert the color:
>>> plaintxt = asciiporn.img2plaintxt('mario.jpg', scale = 0.5, invert = True)
>>> print( plaintxt )
... b/w img w/ colors inverted. may look funny now :/
but it'll b normal when pasted in document
################################################################################
RECENT CHANGELOG:
20080121: removed py3to2 requirement
20090103
rewrote 3d plotter
fixed more 64bit issues
20081123
fixed bug where 64bit gets truncated to 32 on 32bit machine
256 color support
20081119
fixed bugs in setup.py
