aa_parseoptions

aa_parseoptions(3)         Library Functions Manual         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)