AAlib-Ruby brings graphics to the text terminal. AAlib-Ruby provides both a
graphics context rendered as ascii-art and keyboard and mouse input.
AAlib-Ruby supports a number of text-only display drivers such as Curses,
SLang, and X11.
This is a DL based wrapper around the AA-lib C library. C struct alignment
issues may cause problems on certain platforms when accessing variables of
some objects.
Author:: Patrick Mahoney (mailto:pat@polycrystal.org)
Copyright:: Copyright (c) 2007 Patrick Mahoney
License:: Distributes under the same terms as Ruby
== Usage
First, AA-lib must be initialized with AAlib.init or AAlib.autoinit,
returning an AAlib::Context. Two buffers are maintained: the image buffer
and the text buffer. AAlib::Context#putpixel is the primary method to draw
on the image buffer. AAlib::Context#render converts the image buffer to
text, writing the result to the text buffer. Text may be written directly to
the text buffer using AAlib::Context#puts and similar. Note that text
written this way may be overwritten after a call to AAlib::Context#render.
Finally, AAlib::Context#flush writes the text buffer to the screen.
=== Example
require 'aalib'
hp = AAlib::HardwareParams.new
rp = AAlib::RenderParams.new
AAlib.parseoptions(hp, rp) or abort AAlib.help
aa = AAlib.autoinit(hp) or abort "failed to initialize AA-lib"
begin
aa.autoinitkbd # set up keyboard support
# Fill screen with diagonal gradient
width = aa.imgwidth
height = aa.imgheight
height.times do |y|
width.times do |x|
aa.putpixel(x, y, 127*(x.to_f/width) + 127*(y.to_f/height))
end
end
rp.randomval = 25
aa.render(rp)
msg = ' AA-lib: the ascii-art library '
blank = ' ' * msg.size
attr = AAlib::Attr::BOLD
col = (aa.scrwidth - msg.size)/2
row = aa.scrheight/2
aa.puts(col, row - 1, attr, blank)
aa.puts(col, row, attr, msg)
aa.puts(col, row + 1, attr, blank)
aa.flush
aa.getkey # wait for any key to exit
ensure
aa.close
end