NAME¶
desktop_color_depth - Finds out the desktop color depth. Allegro game
programming library.
SYNOPSIS¶
#include <allegro.h>
int desktop_color_depth();
DESCRIPTION¶
Finds out the currently selected desktop color depth. You can use this
information to make your program use the same color depth as the desktop,
which will likely make it run faster because the graphic driver won't be doing
unnecessary color conversions behind your back.
Under some OSes, switching to a full screen graphics mode may automatically
change the desktop color depth. You have, therefore, to call this function
before setting any graphics mode in order to retrieve the real desktop color
depth. Example:
allegro_init();
...
if ((depth = desktop_color_depth()) != 0) {
set_color_depth(depth);
}
RETURN VALUE¶
Returns the color depth or zero on platforms where this information is not
available or does not apply.
SEE ALSO¶
get_desktop_resolution(3alleg4),
set_color_depth(3alleg4),
set_gfx_mode(3alleg4)