GLUTINITDISPLAYMODE

Section: C Library Functions (3)
Updated: LOCAL
Index Return to Main Contents

BSD mandoc

NAME

glutInitDisplayMode - Set the window creation display mode.

LIBRARY

OpenGLUT - window

SYNOPSIS

In openglut.h Ft void Fn glutInitDisplayMode unsigned int displayMode

PARAMETERS

Bf Em
displayMode Ef
Requested display mode bitmask.

DESCRIPTION

glutInitDisplayMode() allows you to control the mode for subsequent OpenGLUT windows.

Allowable Bf Sy
displayMode Ef
is a combination of:

- Bf Sy
GLUT_RGB Ef

Red, green, blue framebuffer.

- Bf Sy
GLUT_RGBA Ef

Red, green, blue, alpha framebuffer.

- Bf Sy
GLUT_INDEX Ef

Indexed color framebuffer.

- Bf Sy
GLUT_SINGLE Ef

Single-buffered mode.

- Bf Sy
GLUT_DOUBLE Ef

Double-buffered mode.

- Bf Sy
GLUT_ACCUM Ef

Accumulation buffer.

- Bf Sy
GLUT_ALPHA Ef

Alpha channel.

- Bf Sy
GLUT_DEPTH Ef

Depth buffering.

- Bf Sy
GLUT_STENCIL Ef

Stencil buffering.

- Bf Sy
GLUT_MULTISAMPLE Ef

Multisampling mode. (not always available)

- Bf Sy
GLUT_STEREO Ef

Left and right framebuffers.

- Bf Sy
GLUT_LUMINANCE Ef

Greyscale color mode.

Additionally, the following Bf Li
experimental Ef
features are implemented:

- Bf Sy
GLUT_OFFSCREEN Ef

Offscreen windows are very much like onscreen windows that have been dragged off of the edge of the screen. The biggest issue is that offscreen windows do not support subwindows. Other than that, onscreen windows that are dragged off of the edge may not store graphics that you render (while Bf Sy
GLUT_OFFSCREEN Ef
windows do), and there is no way to drag an offscreen window onscreen for user interaction.

- Bf Sy
GLUT_BORDERLESS Ef

Borderless windows are very experimental, and their precise behavior is not set in stone. See also glutCreateMenuWindow().

The following are Bf Li
defaults Ef
:

- Bf Sy
GLUT_RGB Ef

- Bf Sy
GLUT_SINGLE Ef

CAVEATS

Some display mode features were introduced by OpenGLUT.

Not all features or combinations of features are valid for all platforms.

There is no way to change the display mode of an open window.

BUGS

Bf Sy
GLUT_OFFSCREEN Ef
windows do not work with nVidia cards/drivers. (Both Win32 and X11)

Bf Sy
GLUT_BORDERLESS Ef
seems to vary by the window manager on X11, though twm (for example) performs very similarly to WIN32. But KDE's window manager (for example) does not let you send keystrokes to borderless windows without OpenGLUT hacks.