aboutsummaryrefslogtreecommitdiff
path: root/graphics/aewan/README
blob: f32750a554539c4d6d677a7e07ea70bef754021c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
Summary: Aewan is a multi-layered ascii-art/animation editor that
produces both stand-alone cat-able art files and an easy-to-parse
format for integration in your terminal applications. It is primarily
designed for Linux, although it currently also compiles under FreeBSD
and possibly other *NIX systems.

More details: Aewan is a curses-based program that allows for the
creation and editing of ascii art. The user is able to move the cursor
around the screen by means of the arrow keys and 'paint' characters
by pressing the corresponding keys. There are dialog boxes that allow
the user to choose foreground and background colors, as well as bold
and blink attributes. The user may also select rectangular areas of
the canvas in order to move, copy and paste them. Aewan also supports
'intelligent' horizontal and vertical flipping (e.g. converts '\' to
'/', etc).

What sets Aewan apart from similar projects is the fact that it can
work with multiple layers, and has the ability to turn transparency
and visibility on and off for each layer. A layer dialog is provided
through which the user can change the order of the layers. Thus, each
layer can be edited independently in order to generate a composite
drawing. Instead of using the layers for compositing, it is also
possible to use the layers as frames for an animation, thus enabling
the user to create ascii animations with Aewan.

Aewan can export animations to a "less movie", that is, a regular file
that will show the animation when when paged through in the 'less'
pager or similar program (even Notepad will work if you don't need
color). It can also export a shellscript which will play the animation
on the terminal when executed.

The file format is easy to parse, so it is easy to write a
terminal-based application that uses the Aewan files to display
onscreen. Currently it has been tested on the Linux terminal, rxvt,
xterm, the Cygwin terminal and the FreeBSD console.