[[Image(source:/www/logo-caca.png, align=right, border=2, alt="libcaca logo")]]

== Introduction ==

libcaca is a graphics library that outputs text instead of pixels, so that it can work on older video cards or text terminals. It is not unlike the famous [http://aa-project.sourceforge.net/aalib/ AAlib] library, with the following improvements:

    * Unicode support
    * 2048 available colours (some devices can only handle 16)
    * dithering of colour images
    * advanced text canvas operations (blitting, rotations)

Libcaca works in a text terminal (and should thus work on all Unix systems including Mac OS X) using the S-Lang or ncurses libraries. It also works natively on DOS and Windows.

Libcaca was written by Sam Hocevar and Jean-Yves Lamoureux. It is free software, and can be used, modified and distributed under the terms of the [http://sam.zoy.org/wtfpl/ Do What The Fuck You Want To Public License].

[[Image(source:/www/img/sample.png, align=right, border=2)]]

== Screenshots ==

{{{
#!comment
Change those fucking screenshots to proper Trac stuff when 0.11 is in Debian:
[[Image(source:/www/img/tn-stitch-80x45.jpeg, link=/img/stitch-80x45.png)]]
}}}

Here are a few libcaca screenshots.

{{{
#!html
<table cellspacing="5" border="0">
  <tr>
    <td align="center">
      <a href="/browser/www/img/stitch-80x45.png"><img alt="cacaview"
         width="73" height="90"
         src="/browser/www/img/tn-stitch-80x45.jpeg?format=raw" /></a>
      <br /><small><code>cacaview</code></small>
    </td>
    <td align="center">
      <a href="/browser/www/img/cacaball-80x50.png"><img alt="cacaball"
         width="101" height="90"
         src="/browser/www/img/tn-cacaball-80x50.jpeg?format=raw" /></a>
      <br /><small><code>cacaball</code></small>
    </td>
    <td align="center">
      <a href="/browser/www/img/cacaplas-80x50.png"><img alt="cacaplas"
         width="101" height="90"
         src="/browser/www/img/tn-cacaplas-80x50.jpeg?format=raw" /></a>
      <br /><small><code>cacaplas</code></small>
    </td>
    <td align="center">
      <a href="/browser/www/img/truecolor-32x16.png"><img alt="truecolor"
         width="87" height="90"
         src="/browser/www/img/tn-truecolor-32x16.jpeg?format=raw" /></a>
      <br /><small>TrueColor</small>
    </td>
    <td align="center">
    </td>
  </tr>
  <tr>
    <td align="center">
      <a href="/browser/www/img/unicode-80x24.png"><img alt="unicode"
         width="120" height="75"
         src="/browser/www/img/tn-unicode-80x24.jpeg?format=raw" /></a>
      <br /><small>Unicode</small>
    </td>
    <td align="center">
      <a href="/browser/www/img/swallow-80x32.png"><img alt="swallow"
         width="120" height="81"
         src="/browser/www/img/tn-swallow-80x32.jpeg?format=raw" /></a>
      <br /><small>swallowing applications</small>
    </td>
    <td align="center">
      <a href="/browser/www/img/rotate.png"><img alt="rotation"
         width="75" height="90"
         src="/browser/www/img/tn-rotate.jpeg?format=raw" /></a>
      <br /><small>canvas rotation</small>
    </td>
    <td align="center">
      <a href="/browser/www/img/export.png"><img alt="rotation"
         width="78" height="90"
         src="/browser/www/img/tn-export.jpeg?format=raw" /></a>
      <br /><small>ANSI to PNG</small>
    </td>
    <td align="center">
    </td>
  </tr>
</table>
}}}

== Download ==

The latest development version of libcaca is 0.99.beta14:
 * [/files/libcaca/libcaca-0.99.beta15.tar.gz libcaca-0.99.beta15.tar.gz]

The old, deprecated 0.9 release is still available. You are encouraged to evaluate and use 0.99, though.
 * [/files/libcaca/libcaca-0.9.tar.gz libcaca-0.9.tar.gz]
 * [/files/libcaca/libcaca-win32-0.9.zip libcaca-win32-0.9.zip]

== Why? ==

{{{
#!html
<blockquote><p>
Que dites-vous ?... C’est inutile ?... Je le sais !
<br />Mais on ne se bat pas dans l’espoir du succès !
<br />Non ! non, c’est bien plus beau lorsque c’est inutile !
<br /><small> -- Edmond Rostand, <i>Cyrano de Bergerac</i> </small>
</p></blockquote>
}}}

I am perfectly aware that libcaca is the waste of time it looks to be. No need to tell me about that. I urge you to read Théophile Gautier’s preface to ''Mademoiselle de Maupin'', which also gives an excellent explanation for the name “libcaca”:

{{{
#!html
<blockquote><p>
Il n’y a rien de vraiment beau que ce qui ne peut servir à rien ; tout ce
qui est utile est laid ; car c’est l’expression de quelque besoin ; et ceux
de l’homme sont ignobles et dégoûtants, comme sa pauvre et infirme nature. -
L’endroit le plus utile d’une maison, ce sont les latrines.
</p></blockquote>
}}}