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_COM-
       MAND 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@nvidia.com)