glutCreateWindow(3GLUT) GLUT glutCreateWindow(3GLUT)

NAME
glutCreateWindow - creates a top-level window.

SYNTAX
int glutCreateWindow(char *name);

ARGUMENTS
name ASCII character string for use as window name.

DESCRIPTION
glutCreateWindow creates a top-level window. The name will
be provided to the window system as the window’s name. The
intent is that the window system will label the window
with the name.

Implicitly, the current window is set to the newly created
window.

Each created window has a unique associated OpenGL con-
text. State changes to a window’s associated OpenGL con-
text can be done immediately after the window is created.

The display state of a window is initially for the window
to be shown. But the window’s display state is not actu-
ally acted upon until glutMainLoop is entered. This means
until glutMainLoop is called, rendering to a created win-
dow is ineffective because the window can not yet be dis-
played.

The value returned is a unique small integer identifier
for the window. The range of allocated identifiers starts
at one. This window identifier can be used when calling
glutSetWindow.

X IMPLEMENTATION NOTES
The proper X Inter-Client Communication Conventions Manual
(ICCCM) top-level properties are established. The
WM_COMMAND property that lists the command line used to
invoke the GLUT program is only established for the first
window created.

SEE ALSO
glutCreateSubWindow, glutCreateMenu, glutDestroyWindow

AUTHOR
Mark J. Kilgard (mjk@sgi.com)

GLUT 3.2 1