1al_get_system_config(3) al_get_system_config(3)
2
3
4
6 al_get_system_config - Allegro 5 API
7
9 #include <allegro5/allegro.h>
10
11 ALLEGRO_CONFIG *al_get_system_config(void)
12
14 Returns the system configuration structure. The returned configuration
15 should not be destroyed with al_destroy_config(3). This is mainly used
16 for configuring Allegro and its addons. You may populate this configu‐
17 ration before Allegro is installed to control things like the logging
18 levels and other features.
19
20 Allegro will try to populate this configuration by loading a configura‐
21 tion file from a few different locations, in this order:
22
23 • Unix only: /etc/allegro5rc
24
25 • Unix only: $HOME/allegro5rc
26
27 • Unix only: $HOME/.allegro5rc
28
29 • allegro5.cfg next to the executable
30
31 If multiple copies are found, then they are merged using al_merge_con‐
32 fig_into(3).
33
34 The contents of this file are documented inside a prototypical alle‐
35 gro5.cfg that you can find in the root directory of the source distri‐
36 butions of Allegro. They are also reproduced below.
37
38 Note that Allegro will not look into that file unless you make a copy
39 of it and place it next to your executable!
40
41 __ALLEGRO_5_CFG
42
43
44
45Allegro reference manual al_get_system_config(3)