Section 3: library functions
NAME aa_recommendhikbd – insert the given driver on beggining of the list of recommended keyboard drivers. SYNOPSIS #include <aalib.h> void aa_recommendhikbd(const char *name); PARAMETERS const char *name Name of the driver (ought to match the "shortname" field of the driver definition structure). DESCRIPTION Insert the given driver on beggining of the list of recommended keyboard…
NAME aa_recommendhidisplay – insert the given driver on beggining of the list of recommended display drivers. SYNOPSIS #include <aalib.h> void aa_recommendhidisplay(const char *name); PARAMETERS const char *name Name of the driver (ought to match the "shortname" field of the driver definition structure). DESCRIPTION Insert the given driver on beggining of the list of recommended display…
NAME aa_recommendhi – insert the given driver on beggining of the list of recommended drivers. SYNOPSIS #include <aalib.h> void aa_recommendhi ( aa_linkedlist **l, const char *name ); PARAMETERS aa_linkedlist **l List to operate on (aa_displayrecommended, aa_kbdrecommended or aa_mouserecommended). const char *name Name of the driver (ought to match the "shortname" field of the driver definition…
NAME aa_puts – output string to AA-lib output buffers. SYNOPSIS #include <aalib.h> void aa_puts ( aa_context *c, int x, int y, enum aa_attribute attr, const char *s ); PARAMETERS aa_context *c Specifies the AA-lib context to operate on. int x X coordinate of the first character. int y Y coordinate of the first character. enum…
NAME aa_printf – print text to AA-lib output buffers. SYNOPSIS #include <aalib.h> int aa_printf ( aa_context *c, int x, int y, enum aa_attribute attr, const char *fmt, … ); PARAMETERS aa_context *c Specifies the AA-lib context to operate on. int x X coordinate of the first character. int y Y coordinate of the first character….
NAME aa_parseoptions – parse the standard command line options used by AA-lib. SYNOPSIS #include <aalib.h> int aa_parseoptions ( struct aa_hardware_params *p, aa_renderparams *r, int *argc, char **argv ); PARAMETERS struct aa_hardware_params *p Hardware parameters structure to alter. It is expected that this structure only with necessary modifications will be later used to initialize the AA-lib…
NAME aa_mouserecommended – List of recommended drivers. SYNOPSIS #include <aalib.h> extern aa_linkedlist *aa_mouserecommended; DESCRIPTION List of recommended drivers is used by aa_autoinit familly of functions and altered by aa_recommend familly of functions. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3),…
NAME aa_mousedrivers – NULL terminated array of mouse drivers supported by AA-lib. SYNOPSIS #include <aalib.h> extern const struct aa_mousedriver *const aa_mousedrivers[]; DESCRIPTION NULL terminated array of mouse drivers supported by AA-lib. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3), aa_attrs(3),…
NAME aa_mmwidth – returns width of the output screen in millimeters. SYNOPSIS #include <aalib.h> int aa_mmwidth(aa_context *a); PARAMETERS aa_context *a Specifies the AA-lib context to operate on. DESCRIPTION Returns width of the output screen in millimeters. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmheight(3),…
NAME aa_mmheight – returns height of the output screen in millimeters. SYNOPSIS #include <aalib.h> int aa_mmheight(aa_context *a); PARAMETERS aa_context *a Specifies the AA-lib context to operate on. DESCRIPTION Returns height of the output screen in millimeters. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3),…
NAME aa_kbdrecommended – List of recommended drivers. SYNOPSIS #include <aalib.h> extern aa_linkedlist *aa_kbdrecommended; DESCRIPTION List of recommended drivers is used by aa_autoinit familly of functions and altered by aa_recommend familly of functions. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3),…
NAME aa_kbddrivers – NULL-terminated array of keyboard drivers available in AA_lib. SYNOPSIS #include <aalib.h> extern const struct aa_kbddriver *const aa_kbddrivers[]; DESCRIPTION NULL-terminated array of keyboard drivers available in AA_lib. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3), aa_attrs(3), aa_currentfont(3), aa_autoinit(3),…
NAME aa_initmouse – initialize the AA-lib mouse driver. SYNOPSIS #include <aalib.h> int aa_initmouse ( struct aa_context *c, const struct aa_mousedriver *d, int mode ); PARAMETERS struct aa_context *c Specifies the AA-lib context to operate on. const struct aa_mousedriver *d Driver you wish to use. int mode Mask of extra features you request. No such features…
NAME aa_initkbd – initialize the AA-lib keyboard driver. SYNOPSIS #include <aalib.h> int aa_initkbd ( struct aa_context *context, const struct aa_kbddriver *drv, int mode ); PARAMETERS struct aa_context *context Specifies the AA-lib context to operate on. const struct aa_kbddriver *drv Driver you wish to use. int mode Mask of extra features you request. Can contain AA_SENDRELEASE…
NAME aa_init – open the output display for AA-lib. SYNOPSIS #include <aalib.h> aa_context *aa_init ( const struct aa_driver *driver, const struct aa_hardware_params *defparams, const void *driverdata ); PARAMETERS const struct aa_driver *driver Driver you want to use. Available drivers are listed in the NULL terminated aa_drivers array. const struct aa_hardware_params *defparams Hardware parameters you want….
NAME aa_imgwidth – returns width of the emulated image in pixels. SYNOPSIS #include <aalib.h> int aa_imgwidth(aa_context *a); PARAMETERS aa_context *a Specifies the AA-lib context to operate on. DESCRIPTION Returns width of the emulated image in pixels. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3),…
NAME aa_imgheight – returns height of the emulated image in pixels. SYNOPSIS #include <aalib.h> int aa_imgheight(aa_context *a); PARAMETERS aa_context *a Specifies the AA-lib context to operate on. DESCRIPTION Returns height of the emulated image in pixels. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3),…
NAME aa_image – returns pointer to the framebuffer emulated by AA-lib. SYNOPSIS #include <aalib.h> char *aa_image(aa_context *a); PARAMETERS aa_context *a Specifies the AA-lib context to operate on. DESCRIPTION The framebuffer is simple array of characters specifying the brightness value (or palette index depending on the aa_render call). The array is organizated in the aa_imgheight (a)…
NAME aa_hidemouse – hide the mouse cursor. SYNOPSIS #include <aalib.h> void aa_hidemouse(aa_context *c); PARAMETERS aa_context *c Not Documented. DESCRIPTION Hide the mouse cursor. This function may be ignored by some drivers. SEE ALSO save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3),…