glutCreateWindow - creates a top-level window.

glutCreateWindow
	glutCreateWindow(title) -> win

int glutCreateWindow(char *name);

name      ASCII character string for use as window name.

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.

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

glutCreateSubWindow, glutCreateMenu, glutDestroyWindow

Mark J. Kilgard (mjk@nvidia.com)