glutInitDisplayMode
Prev | GLUT | Next

## Name

glutInitDisplayMode — sets the initial display mode.

## C Specification

`void `glutInitDisplayMode`` | `(` | `unsigned int `mode`);`

## Python Specification

``glutInitDisplayMode`` | `(` | ``mode`) → `None``

## Parameters

`mode`

  Display mode, normally the bitwise 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_SINGLE` 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 component 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 functionality 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 `glutGet(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 linear 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

Prev | Up | Next
glutInit | Home | glutInitDisplayString