fltk/src/Fl_visual.cxx
2021-11-26 15:01:54 +01:00

53 lines
1.7 KiB
C++

//
// Visual support for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2010 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
// file is missing or damaged, see the license at:
//
// https://www.fltk.org/COPYING.php
//
// Please see the following page on how to report bugs and issues:
//
// https://www.fltk.org/bugs.php
//
// Set the default visual according to passed switches:
#include <FL/Fl.H>
#include "Fl_Screen_Driver.H"
/** \fn Fl::visual(int flags)
Selects a visual so that your graphics are drawn correctly. This is
only allowed before you call show() on any windows. This does nothing
if the default visual satisfies the capabilities, or if no visual
satisfies the capabilities, or on systems that don't have such
brain-dead notions.
<P>Only the following combinations do anything useful:
<UL>
<LI>Fl::visual(FL_RGB)
<BR>Full/true color (if there are several depths FLTK chooses the
largest). Do this if you use fl_draw_image
for much better (non-dithered) output.
<BR>&nbsp; </LI>
<LI>Fl::visual(FL_RGB8)
<BR>Full color with at least 24 bits of color. FL_RGB will
always pick this if available, but if not it will happily return a
less-than-24 bit deep visual. This call fails if 24 bits are not
available.
<BR>&nbsp; </LI>
</UL>
<P>This returns true if the system has the capabilities by default or
FLTK succeeded in turning them on. Your program will still work even if
this returns false (it just won't look as good).
*/
int Fl::visual(int flags)
{
return screen_driver()->visual(flags);
}