Name

glutInitDisplayMode - sets the initial display mode.

Python Specification

glutInitDisplayMode
	glutInitDisplayMode(mode) -> None

C Specification

void glutInitDisplayMode(unsigned int mode);

Parameters

mode      Display  mode,  normally the bitwise {\m OR}-ing
          of GLUT display  mode  bit  masks.   See  values
          below:

GLUT_RGBA
        Bit  mask  to  select an RGBA mode window. This is
        the default if neither  GLUT_RGBA  nor  GLUT_INDEX
        are specified.

GLUT_RGB
        An alias for GLUT_RGBA.

GLUT_INDEX
        Bit mask to select a color index mode window. This
        overrides GLUT_RGBA if it is also specified.

GLUT_SINGLE
        Bit mask to select a single buffered window.  This
        is the default if neither GLUT_DOUBLE or GLUT_SIN-
        GLE are specified.

GLUT_DOUBLE
        Bit mask to select a double buffered window.  This
        overrides GLUT_SINGLE if it is also specified.

GLUT_ACCUM
        Bit  mask to request a window with an accumulation
        buffer.

GLUT_ALPHA
        Bit mask to request a window with an alpha  compo-
        nent to the color buffer(s).

GLUT_DEPTH
        Bit  mask to request a window with a depth buffer.

GLUT_STENCIL
        Bit mask  to  request  a  window  with  a  stencil
        buffer.

GLUT_MULTISAMPLE
        Bit  mask  to  request a window with multisampling
        support. If multisampling is not available, a non-
        multisampling window will automatically be chosen.
        Note: both the OpenGL client-side and  server-side
        implementations  must  support the GLX_SAMPLE_SGIS
        extension for multisampling to be available.

GLUT_STEREO
        Bit mask to select a stereo window.

GLUT_LUMINANCE
        Bit mask to select a window with  a  ``luminance''
        color  model.  This model provides the functional-
        ity of OpenGL's RGBA color model,  but  the  green
        and  blue  components  are  not  maintained in the
        frame buffer. Instead each pixel's  red  component
        is  converted  to  an index between zero and glut-
        Get(GLUT_WINDOW_COLORMAP_SIZE)-1 and looked up  in
        a  per-window  color map to determine the color of
        pixels within the window. The initial colormap  of
        GLUT_LUMINANCE windows is initialized to be a lin-
        ear gray ramp, but can  be  modified  with  GLUT's
        colormap routines.

Description

       The  initial  display mode is used when creating top-level
       windows, subwindows, and overlays to determine the  OpenGL
       display mode for the to-be-created window or overlay.

       Note  that  GLUT_RGBA selects the RGBA color model, but it
       does not request any bits of alpha  (sometimes  called  an
       alpha  buffer  or  destination  alpha)  be  allocated.  To
       request alpha, specify GLUT_ALPHA.  The  same  applies  to
       GLUT_LUMINANCE.

       Note  that some bits "request" a capability and other bits
       "select" a capability.  A requestable  capability  may  be
       assigned  to  the  created  window even if the bit for the
       capability was not set.  For example, GLUT  may  create  a
       window  with  a depth buffer even though GLUT_DEPTH is not
       specified.

       The glutInitDisplayString routine provides a more powerful
       way  to select frame buffer capabilities for GLUT windows.

GLUT_LUMINANCE IMPLEMENTATION NOTES
       GLUT_LUMINANCE is not supported on most OpenGL  platforms.

See Also

glutInit, glutCreateWindow, glutInitDisplayString

Author

Mark J. Kilgard (mjk@nvidia.com)

:: Documentation :: References :: GLUT ::
:: Index (n/a) ::