1al_set_new_display_flags(3)Library Functions Manualal_set_new_display_flags(3)
2
3
4
6 al_set_new_display_flags
7
9 #include <allegro5/allegro.h>
10
11 void al_set_new_display_flags(int flags)
12
14 Sets various flags to be used when creating new displays on the calling
15 thread. flags is a bitfield containing any reasonable combination of
16 the following:
17
18 ALLEGRO_WINDOWED
19 Prefer a windowed mode.
20
21 Under multi-head X (not XRandR/TwinView), the use of more than
22 one adapter is impossible due to bugs in X and glX. al_cre‐
23 ate_display(3) will fail if more than one adapter is attempted
24 to be used.
25
26 ALLEGRO_FULLSCREEN
27 Prefer a fullscreen mode.
28
29 Under X the use of more than one FULLSCREEN display when using
30 multi-head X, or true Xinerama is not possible due to bugs in X
31 and glX, display creation will fail if more than one adapter is
32 attempted to be used.
33
34 ALLEGRO_FULLSCREEN_WINDOW
35 Make the window span the entire screen. Unlike ALLE‐
36 GRO_FULLSCREEN this will never attempt to modify the screen res‐
37 olution. Instead the pixel dimensions of the created display
38 will be the same as the desktop.
39
40 The passed width and height are only used if the window is
41 switched out of fullscreen mode later but will be ignored ini‐
42 tially.
43
44 Under Windows and X11 a fullscreen display created with this
45 flag will behave differently from one created with the ALLE‐
46 GRO_FULLSCREEN flag - even if the ALLEGRO_FULLSCREEN display is
47 passed the desktop dimensions. The exact difference is platform
48 dependent, but some things which may be different is how alt-tab
49 works, how fast you can toggle between fullscreen/windowed mode
50 or how additional monitors behave while your display is in
51 fullscreen mode.
52
53 Additionally under X, the use of more than one adapter in multi-
54 head mode or with true Xinerama enabled is impossible due to
55 bugs in X/glX, creation will fail if more than one adapter is
56 attempted to be used.
57
58 ALLEGRO_RESIZABLE
59 The display is resizable (only applicable if combined with ALLE‐
60 GRO_WINDOWED).
61
62 ALLEGRO_OPENGL
63 Require the driver to provide an initialized OpenGL context
64 after returning successfully.
65
66 ALLEGRO_OPENGL_3_0
67 Require the driver to provide an initialized OpenGL context com‐
68 patible with OpenGL version 3.0.
69
70 ALLEGRO_OPENGL_FORWARD_COMPATIBLE
71 If this flag is set, the OpenGL context created with ALLE‐
72 GRO_OPENGL_3_0 will be forward compatible only, meaning that all
73 of the OpenGL API declared deprecated in OpenGL 3.0 will not be
74 supported. Currently, a display created with this flag will not
75 be compatible with Allegro drawing routines; the display option
76 ALLEGRO_COMPATIBLE_DISPLAY will be set to false.
77
78 ALLEGRO_DIRECT3D
79 Require the driver to do rendering with Direct3D and provide a
80 Direct3D device.
81
82 ALLEGRO_NOFRAME
83 Try to create a window without a frame (i.e. no border or
84 titlebar). This usualy does nothing for fullscreen modes, and
85 even in windowed moded it depends on the underlying platform
86 whether it is supported or not.
87
88 ALLEGRO_GENERATE_EXPOSE_EVENTS
89 Let the display generate expose events.
90
91 0 can be used for default values.
92
94 al_set_new_display_option(3), al_get_display_option(3)
95
96
97
98Allegro reference manual al_set_new_display_flags(3)