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)