GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_SET_NEW_DISPLAY_FLAGS (3)

NAME

al_set_new_display_flags - Allegro 5 API

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

C]
#include <allegro5/allegro.h>

void al_set_new_display_flags(int flags) ]

DESCRIPTION

Sets various flags to be used when creating new displays on the calling thread. flags is a bitfield containing any reasonable combination of the following:
ALLEGRO_WINDOWED
  Prefer a windowed mode.

Under multi-head X (not XRandR/TwinView), the use of more than one adapter is impossible due to bugs in X and GLX. al_create_display(3) will fail if more than one adapter is attempted to be used.

ALLEGRO_FULLSCREEN
  Prefer a fullscreen mode.

Under X the use of more than one FULLSCREEN display when using multi-head X, or true Xinerama is not possible due to bugs in X and GLX, display creation will fail if more than one adapter is attempted to be used.

ALLEGRO_FULLSCREEN_WINDOW
  Make the window span the entire screen. Unlike ALLEGRO_FULLSCREEN this will never attempt to modify the screen resolution. Instead the pixel dimensions of the created display will be the same as the desktop.

The passed width and height are only used if the window is switched out of fullscreen mode later but will be ignored initially.

Under Windows and X11 a fullscreen display created with this flag will behave differently from one created with the ALLEGRO_FULLSCREEN flag - even if the ALLEGRO_FULLSCREEN display is passed the desktop dimensions. The exact difference is platform dependent, but some things which may be different is how alt-tab works, how fast you can toggle between fullscreen/windowed mode or how additional monitors behave while your display is in fullscreen mode.

Additionally under X, the use of more than one adapter in multi-head mode or with true Xinerama enabled is impossible due to bugs in X/GLX, creation will fail if more than one adapter is attempted to be used.

ALLEGRO_RESIZABLE
  The display is resizable (only applicable if combined with ALLEGRO_WINDOWED).
ALLEGRO_OPENGL
  Require the driver to provide an initialized OpenGL context after returning successfully.
ALLEGRO_OPENGL_3_0
  Require the driver to provide an initialized OpenGL context compatible with OpenGL version 3.0.
ALLEGRO_OPENGL_FORWARD_COMPATIBLE
  If this flag is set, the OpenGL context created with ALLEGRO_OPENGL_3_0 will be forward compatible I]only], meaning that all of the OpenGL API declared deprecated in OpenGL 3.0 will not be supported. Currently, a display created with this flag will I]not] be compatible with Allegro drawing routines; the display option ALLEGRO_COMPATIBLE_DISPLAY will be set to false.
ALLEGRO_DIRECT3D
  Require the driver to do rendering with Direct3D and provide a Direct3D device.
ALLEGRO_FRAMELESS
  Try to create a window without a frame (i.e. no border or titlebar). This usually does nothing for fullscreen modes, and even in windowed modes it depends on the underlying platform whether it is supported or not. Since: 5.0.7, 5.1.2
ALLEGRO_NOFRAME
  Original name for ALLEGRO_FRAMELESS. This works with older versions of Allegro.
ALLEGRO_GENERATE_EXPOSE_EVENTS
  Let the display generate expose events.
0 can be used for default values.

SEE ALSO

al_set_new_display_option(3), al_get_display_option(3), al_change_display_option(3)

Search for    or go to Top of page |  Section 3 |  Main Index


Allegro reference manual AL_SET_NEW_DISPLAY_FLAGS (3)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.