1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>8.11. AAlib – text mode displaying</title><link rel="stylesheet" href="default.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="MPlayer - The Movie Player"><link rel="up" href="video.html" title="Chapter 8. Video output devices"><link rel="prev" href="opengl.html" title="8.10. OpenGL output"><link rel="next" href="caca.html" title="8.12. libcaca – Color ASCII Art library"><link rel="preface" href="howtoread.html" title="How to read this documentation"><link rel="chapter" href="intro.html" title="Chapter 1. Introduction"><link rel="chapter" href="install.html" title="Chapter 2. Installation"><link rel="chapter" href="usage.html" title="Chapter 3. Usage"><link rel="chapter" href="advaudio.html" title="Chapter 4. Advanced audio usage"><link rel="chapter" href="cd-dvd.html" title="Chapter 5. CD/DVD usage"><link rel="chapter" href="tv.html" title="Chapter 6. TV"><link rel="chapter" href="radio.html" title="Chapter 7. Radio"><link rel="chapter" href="video.html" title="Chapter 8. Video output devices"><link rel="chapter" href="ports.html" title="Chapter 9. Ports"><link rel="chapter" href="mencoder.html" title="Chapter 10. Basic usage of MEncoder"><link rel="chapter" href="encoding-guide.html" title="Chapter 11. Encoding with MEncoder"><link rel="chapter" href="faq.html" title="Chapter 12. Frequently Asked Questions"><link rel="appendix" href="bugreports.html" title="Appendix A. How to report bugs"><link rel="appendix" href="skin.html" title="Appendix B. MPlayer skin format"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">8.11. AAlib – text mode displaying</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="opengl.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Video output devices</th><td width="20%" align="right"> <a accesskey="n" href="caca.html">Next</a></td></tr></table><hr></div><div class="sect1" title="8.11. AAlib – text mode displaying"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="aalib"></a>8.11. AAlib – text mode displaying</h2></div></div></div><p>
2
AAlib is a library for displaying graphics in text mode, using powerful
3
ASCII renderer. There are <span class="emphasis"><em>lots</em></span> of programs already
4
supporting it, like Doom, Quake, etc. <span class="application">MPlayer</span>
5
contains a very usable driver for it. If <tt class="filename">./configure</tt>
6
detects aalib installed, the aalib libvo driver will be built.
8
You can use some keys in the AA Window to change rendering options:
9
</p><div class="informaltable"><table border="1"><colgroup><col><col></colgroup><thead><tr><th>Key</th><th>Action</th></tr></thead><tbody><tr><td><span class="keycap"><b>1</b></span></td><td>
11
</td></tr><tr><td><span class="keycap"><b>2</b></span></td><td>
13
</td></tr><tr><td><span class="keycap"><b>3</b></span></td><td>
15
</td></tr><tr><td><span class="keycap"><b>4</b></span></td><td>
17
</td></tr><tr><td><span class="keycap"><b>5</b></span></td><td>
18
switch fast rendering on/off
19
</td></tr><tr><td><span class="keycap"><b>6</b></span></td><td>
20
set dithering mode (none, error distribution, Floyd Steinberg)
21
</td></tr><tr><td><span class="keycap"><b>7</b></span></td><td>
23
</td></tr><tr><td><span class="keycap"><b>8</b></span></td><td>
24
toggles between aa and <span class="application">MPlayer</span> control
25
</td></tr></tbody></table></div><div class="variablelist" title="The following command line options can be used:"><p class="title"><b>The following command line options can be used:</b></p><dl><dt><span class="term"><tt class="option">-aaosdcolor=<em class="replaceable"><code>V</code></em></tt></span></dt><dd><p>
27
</p></dd><dt><span class="term"><tt class="option">-aasubcolor=<em class="replaceable"><code>V</code></em></tt></span></dt><dd><p>
30
where <em class="replaceable"><code>V</code></em> can be:
31
<code class="literal">0</code> (normal),
32
<code class="literal">1</code> (dark),
33
<code class="literal">2</code> (bold),
34
<code class="literal">3</code> (bold font),
35
<code class="literal">4</code> (reverse),
36
<code class="literal">5</code> (special).
37
</p></dd></dl></div><div class="variablelist" title="AAlib itself provides a large sum of options. Here are some important:"><p class="title"><b>AAlib itself provides a large sum of options. Here are some
38
important:</b></p><dl><dt><span class="term"><tt class="option">-aadriver</tt></span></dt><dd><p>
39
Set recommended aa driver (X11, curses, Linux).
40
</p></dd><dt><span class="term"><tt class="option">-aaextended</tt></span></dt><dd><p>
41
Use all 256 characters.
42
</p></dd><dt><span class="term"><tt class="option">-aaeight</tt></span></dt><dd><p>
44
</p></dd><dt><span class="term"><tt class="option">-aahelp</tt></span></dt><dd><p>
45
Prints out all aalib options.
46
</p></dd></dl></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
47
The rendering is very CPU intensive, especially when using AA-on-X
48
(using aalib on X), and it's least CPU intensive on standard,
49
non-framebuffer console. Use SVGATextMode to set up a big textmode,
50
then enjoy! (secondary head Hercules cards rock :)) (but IMHO you
51
can use <tt class="option">-vf 1bpp</tt> option to get graphics on hgafb:)
53
Use the <tt class="option">-framedrop</tt> option if your computer isn't fast
54
enough to render all frames!
56
Playing on terminal you'll get better speed and quality using the Linux
57
driver, not curses (<tt class="option">-aadriver linux</tt>). But therefore you
59
<tt class="filename">/dev/vcsa<em class="replaceable"><code><terminal></code></em></tt>!
60
That isn't autodetected by aalib, but vo_aa tries to find the best mode.
61
See <a class="ulink" href="http://aa-project.sf.net/tune" target="_top">http://aa-project.sf.net/tune</a> for further
63
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="opengl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="video.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="caca.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.10. OpenGL output </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 8.12.
64
<code class="systemitem">libcaca</code> – Color ASCII Art library
65
</td></tr></table></div></body></html>