aa_parseoptions(3) Introduction to Library Functions aa_parseoptions(3)
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 context.
aa_renderparams *r Rendering prameters structure to alter. It is expected that
this structure only with necessary modifications will be later
used to render images.
int *argc Pointer to argc parameter passed to function "main".
char **argv Pointer to argv parameter passed to function "main".
DESCRIPTION
Use this function to parse the standard command line options used by
AA-lib. Every AA-lib program ought to call this function to let user
specify some extra parameters. The function alters the
aa_hardware_params and aa_renderparams structures and removes known
options from the argc/argv lists. It also parse the AAOPTS
environment variable. When called with NULL for the argc/argv
parameters, it parses AAOPTS only. At least this call ought to be in
every AA-lib program.
RETURNS
1 when sucesfull and 0 on failure. The program then can print the
help text available in aa_help variable.
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),
aa_attrs(3),
aa_currentfont(3),
aa_autoinit(3),
aa_autoinitkbd(3),
aa_autoinitmouse(3),
aa_recommendhi(3),
aa_recommendlow(3),
aa_init(3),
aa_initkbd(3),
aa_initmouse(3),
aa_close(3),
aa_uninitkbd(3),
aa_uninitmouse(3),
aa_fastrender(3),
aa_render(3),
aa_puts(3),
aa_printf(3),
aa_gotoxy(3),
aa_hidecursor(3),
aa_showcursor(3),
aa_getmouse(3),
aa_hidemouse(3),
aa_showmouse(3),
aa_registerfont(3),
aa_setsupported(3),
aa_setfont(3),
aa_getevent(3),
aa_getkey(3),
aa_resize(3),
aa_resizehandler(3),
aa_edit(3),
aa_createedit(3),
aa_editkey(3),
aa_putpixel(3),
aa_recommendhikbd(3),
aa_recommendlowkbd(3),
aa_recommendhimouse(3),
aa_recommendlowmouse(3),
aa_recommendhidisplay(3),
aa_recommendlowdisplay(3)c2man aalib.h 8 September 1999 aa_parseoptions(3)