1al_get_system_config(3)                                al_get_system_config(3)
2
3
4

NAME

6       al_get_system_config - Allegro 5 API
7

SYNOPSIS

9              #include <allegro5/allegro.h>
10
11              ALLEGRO_CONFIG *al_get_system_config(void)
12

DESCRIPTION

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       · allegro5.cfg next to the executable
28
29       If multiple copies are found, then they are merged using  al_merge_con‐
30       fig_into(3).
31
32       The  contents  of  this file are documented inside a prototypical alle‐
33       gro5.cfg that you can find in the root directory of the source  distri‐
34       butions  of  Allegro.   Note  that Allegro will not look into that file
35       unless you make a copy of it and place it next to your executable!
36
37
38
39Allegro reference manual                               al_get_system_config(3)