Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_set_new_display_flags(3)			   al_set_new_display_flags(3)

NAME
       al_set_new_display_flags	- Allegro 5 API

SYNOPSIS
	      #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_cre-
	      ate_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	 ALLE-
	      GRO_FULLSCREEN this will never attempt to	modify the screen res-
	      olution.	 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 ini-
	      tially.

	      Under Windows and	X11 a fullscreen  display  created  with  this
	      flag  will  behave  differently  from one	created	with the ALLE-
	      GRO_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 ALLE-
	      GRO_WINDOWED).

       ALLEGRO_OPENGL
	      Require  the driver to provide an	initialized OpenGL context af-
	      ter returning successfully.

       ALLEGRO_OPENGL_3_0
	      Require the driver to provide an initialized OpenGL context com-
	      patible with OpenGL version 3.0.

       ALLEGRO_OPENGL_FORWARD_COMPATIBLE
	      If  this	flag  is  set,	the  OpenGL context created with ALLE-
	      GRO_OPENGL_3_0 will be forward compatible	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 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 ti-
	      tlebar).	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 ver-
	      sions 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_dis-
       play_option(3)

Allegro	reference manual			   al_set_new_display_flags(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=al_set_new_display_flags&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help