1al_set_new_display_flags(3)Library Functions Manualal_set_new_display_flags(3)
2
3
4

NAME

6       al_set_new_display_flags
7

SYNOPSIS

9              #include <allegro5/allegro.h>
10
11              void al_set_new_display_flags(int flags)
12

DESCRIPTION

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

SEE ALSO

94       al_set_new_display_option(3), al_get_display_option(3)
95
96
97
98Allegro reference manual                           al_set_new_display_flags(3)
Impressum