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)