File: aa_parseoptions.3

package info (click to toggle)
aalib 1.4p5-38
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 2,224 kB
  • ctags: 954
  • sloc: ansic: 10,379; sh: 7,786; makefile: 121
file content (114 lines) | stat: -rw-r--r-- 2,676 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
.\" WARNING! THIS FILE WAS GENERATED AUTOMATICALLY BY c2man!
.\" DO NOT EDIT! CHANGES MADE TO THIS FILE WILL BE LOST!
.TH "aa_parseoptions" 3 "8 September 1999" "c2man aalib.h"
.SH "NAME"
aa_parseoptions \- parse the standard command line options used by AA-lib.
.SH "SYNOPSIS"
.ft B
#include <aalib.h>
.sp
int aa_parseoptions
.br
(
.br
	struct aa_hardware_params *p,
.br
	aa_renderparams *r,
.br
	int *argc,
.br
	char **argv
.br
);
.ft R
.SH "PARAMETERS"
.TP
.B "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.
.TP
.B "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.
.TP
.B "int *argc"
Pointer to argc parameter passed to function "main".
.TP
.B "char **argv"
Pointer to argv parameter passed to function "main".
.SH "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.
.SH "RETURNS"
1 when sucesfull and 0 on failure. The program then can
print the help text available in aa_help variable.
.SH "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)