GNU Info

(aalib.info)Initialization

---

Next: Drawing image Prev: Skeleton Up: Top

---

Enter node , (file) or (file)node

Initialization
**************

   It is possible to initialize AA-lib in various modes.  The main
initialization is done by following `aa_init'

     aa_context *aa_init(struct aa_driver *DRIVER,
                         struct aa_hardware_params *DEFPARAMS,
                         void *DRIVERDATA)

   This function prepares `aa_context *' type variable used by all
AA-lib functions. The DRIVER parameter specifies hardware driver to
initialize, DEFPARAMS parameters of hardware you require and DRIVERDATA
is used to pass implementation dependent extra information to the
hardware driver.

   To undo all actions done by `aa_init' function, call `aa_close':

     aa_close(aa_context *CONTEXT)

   This function frees allocated memory for `aa_context' and call's
unintialize function of the output drivers.

   Initializing AA-lib directly is non-trivial task. Many display
drivers and modes are available. Several helper functions are provided
to do this job for you.

   You may want initialize AA-lib in one of the following modes:

Initialization as a normal graphics library

Initialization as an ascii art renderer

Initialization for image saving

Specifying hardware parameters