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)
