4 * Window management methods.
6 * Copyright (c) 1999-2000 Pawel W. Olszta. All Rights Reserved.
7 * Written by Pawel W. Olszta, <olszta@sourceforge.net>
8 * Creation date: Fri Dec 3 1999
10 * Permission is hereby granted, free of charge, to any person obtaining a
11 * copy of this software and associated documentation files (the "Software"),
12 * to deal in the Software without restriction, including without limitation
13 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
14 * and/or sell copies of the Software, and to permit persons to whom the
15 * Software is furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included
18 * in all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * PAWEL W. OLSZTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
24 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
25 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 #include <GL/freeglut.h>
29 #include "freeglut_internal.h"
31 #if TARGET_HOST_POSIX_X11
32 #include <limits.h> /* LONG_MAX */
35 #if defined(_WIN32_WCE)
36 # include <Aygshell.h>
37 # ifdef FREEGLUT_LIB_PRAGMAS
38 # pragma comment( lib, "Aygshell.lib" )
41 static wchar_t* fghWstrFromStr(const char* str)
43 int i,len=strlen(str);
44 wchar_t* wstr = (wchar_t*)malloc(2*len+2);
51 #endif /* defined(_WIN32_WCE) */
54 * TODO BEFORE THE STABLE RELEASE:
56 * fgChooseFBConfig() -- OK, but what about glutInitDisplayString()?
57 * fgSetupPixelFormat -- ignores the display mode settings
58 * fgOpenWindow() -- check the Win32 version, -iconic handling!
59 * fgCloseWindow() -- check the Win32 version
60 * glutCreateWindow() -- Check when default position and size is {-1,-1}
61 * glutCreateSubWindow() -- Check when default position and size is {-1,-1}
62 * glutDestroyWindow() -- check the Win32 version
63 * glutSetWindow() -- check the Win32 version
64 * glutGetWindow() -- OK
65 * glutSetWindowTitle() -- check the Win32 version
66 * glutSetIconTitle() -- check the Win32 version
67 * glutShowWindow() -- check the Win32 version
68 * glutHideWindow() -- check the Win32 version
69 * glutIconifyWindow() -- check the Win32 version
70 * glutReshapeWindow() -- check the Win32 version
71 * glutPositionWindow() -- check the Win32 version
72 * glutPushWindow() -- check the Win32 version
73 * glutPopWindow() -- check the Win32 version
76 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
79 * Chooses a visual basing on the current display mode settings
81 #if TARGET_HOST_POSIX_X11
83 GLXFBConfig* fgChooseFBConfig( void )
85 GLboolean wantIndexedMode = GL_FALSE;
89 /* First we have to process the display mode settings... */
91 * XXX Why is there a semi-colon in this #define? The code
92 * XXX that uses the macro seems to always add more semicolons...
94 #define ATTRIB(a) attributes[where++]=a;
95 #define ATTRIB_VAL(a,v) {ATTRIB(a); ATTRIB(v);}
97 if( fgState.DisplayMode & GLUT_INDEX )
99 ATTRIB_VAL( GLX_BUFFER_SIZE, 8 );
100 /* Buffer size is selected later. */
102 ATTRIB_VAL( GLX_RENDER_TYPE, GLX_COLOR_INDEX_BIT );
103 wantIndexedMode = GL_TRUE;
107 ATTRIB_VAL( GLX_RED_SIZE, 1 );
108 ATTRIB_VAL( GLX_GREEN_SIZE, 1 );
109 ATTRIB_VAL( GLX_BLUE_SIZE, 1 );
110 if( fgState.DisplayMode & GLUT_ALPHA )
111 ATTRIB_VAL( GLX_ALPHA_SIZE, 1 );
114 if( fgState.DisplayMode & GLUT_DOUBLE )
115 ATTRIB_VAL( GLX_DOUBLEBUFFER, True );
117 if( fgState.DisplayMode & GLUT_STEREO )
118 ATTRIB_VAL( GLX_STEREO, True );
120 if( fgState.DisplayMode & GLUT_DEPTH )
121 ATTRIB_VAL( GLX_DEPTH_SIZE, 1 );
123 if( fgState.DisplayMode & GLUT_STENCIL )
124 ATTRIB_VAL( GLX_STENCIL_SIZE, 1 );
126 if( fgState.DisplayMode & GLUT_ACCUM )
128 ATTRIB_VAL( GLX_ACCUM_RED_SIZE, 1 );
129 ATTRIB_VAL( GLX_ACCUM_GREEN_SIZE, 1 );
130 ATTRIB_VAL( GLX_ACCUM_BLUE_SIZE, 1 );
131 if( fgState.DisplayMode & GLUT_ALPHA )
132 ATTRIB_VAL( GLX_ACCUM_ALPHA_SIZE, 1 );
135 if ((fgState.DisplayMode & GLUT_AUX)
136 || (fgState.DisplayMode & GLUT_AUX1)
137 || (fgState.DisplayMode & GLUT_AUX2)
138 || (fgState.DisplayMode & GLUT_AUX3)
139 || (fgState.DisplayMode & GLUT_AUX4))
141 ATTRIB_VAL(GLX_AUX_BUFFERS, fgState.AuxiliaryBufferNumber)
144 if (fgState.DisplayMode & GLUT_MULTISAMPLE)
146 ATTRIB_VAL(GLX_SAMPLE_BUFFERS, 1)
147 ATTRIB_VAL(GLX_SAMPLES, fgState.SampleNumber)
150 /* Push a null at the end of the list */
154 GLXFBConfig * fbconfigArray; /* Array of FBConfigs */
155 GLXFBConfig * fbconfig; /* The FBConfig we want */
156 int fbconfigArraySize; /* Number of FBConfigs in the array */
159 /* Get all FBConfigs that match "attributes". */
160 fbconfigArray = glXChooseFBConfig( fgDisplay.Display,
163 &fbconfigArraySize );
165 if (fbconfigArray != NULL)
167 int result; /* Returned by glXGetFBConfigAttrib, not checked. */
170 if( wantIndexedMode )
173 * In index mode, we want the largest buffer size, i.e. visual
174 * depth. Here, FBConfigs are sorted by increasing buffer size
175 * first, so FBConfigs with the largest size come last.
178 int bufferSizeMin, bufferSizeMax;
180 /* Get bufferSizeMin. */
182 glXGetFBConfigAttrib( fgDisplay.Display,
186 /* Get bufferSizeMax. */
188 glXGetFBConfigAttrib( fgDisplay.Display,
189 fbconfigArray[fbconfigArraySize - 1],
193 if (bufferSizeMax > bufferSizeMin)
196 * Free and reallocate fbconfigArray, keeping only FBConfigs
197 * with the largest buffer size.
199 XFree(fbconfigArray);
201 /* Add buffer size token at the end of the list. */
203 ATTRIB_VAL( GLX_BUFFER_SIZE, bufferSizeMax );
206 fbconfigArray = glXChooseFBConfig( fgDisplay.Display,
209 &fbconfigArraySize );
214 * We now have an array of FBConfigs, the first one being the "best"
215 * one. So we should return only this FBConfig:
219 * - pick the XID of the FBConfig we want
220 * result = glXGetFBConfigAttrib( fgDisplay.Display,
226 * XFree(fbconfigArray);
228 * - reset "attributes" with the XID
230 * ATTRIB_VAL( GLX_FBCONFIG_ID, fbconfigXID );
233 * - get our FBConfig only
234 * fbconfig = glXChooseFBConfig( fgDisplay.Display,
237 * &fbconfigArraySize );
239 * However, for some configurations (for instance multisampling with
240 * Mesa 6.5.2 and ATI drivers), this does not work:
241 * glXChooseFBConfig returns NULL, whereas fbconfigXID is a valid
242 * XID. Further investigation is needed.
244 * So, for now, we return the whole array of FBConfigs. This should
245 * not produce any side effects elsewhere.
247 fbconfig = fbconfigArray;
257 #endif /* TARGET_HOST_POSIX_X11 */
260 * Setup the pixel format for a Win32 window
262 #if TARGET_HOST_MS_WINDOWS
263 /* The following include file is available from SGI but is not standard:
264 * #include <GL/wglext.h>
265 * So we copy the necessary parts out of it.
266 * XXX: should local definitions for extensions be put in a separate include file?
268 typedef const char * (WINAPI * PFNWGLGETEXTENSIONSSTRINGARBPROC) (HDC hdc);
270 typedef BOOL (WINAPI * PFNWGLCHOOSEPIXELFORMATARBPROC) (HDC hdc, const int *piAttribIList, const FLOAT *pfAttribFList, UINT nMaxFormats, int *piFormats, UINT *nNumFormats);
272 #define WGL_DRAW_TO_WINDOW_ARB 0x2001
273 #define WGL_ACCELERATION_ARB 0x2003
274 #define WGL_SUPPORT_OPENGL_ARB 0x2010
275 #define WGL_DOUBLE_BUFFER_ARB 0x2011
276 #define WGL_COLOR_BITS_ARB 0x2014
277 #define WGL_ALPHA_BITS_ARB 0x201B
278 #define WGL_DEPTH_BITS_ARB 0x2022
279 #define WGL_STENCIL_BITS_ARB 0x2023
280 #define WGL_FULL_ACCELERATION_ARB 0x2027
282 #define WGL_SAMPLE_BUFFERS_ARB 0x2041
283 #define WGL_SAMPLES_ARB 0x2042
286 GLboolean fgSetupPixelFormat( SFG_Window* window, GLboolean checkOnly,
287 unsigned char layer_type )
289 #if defined(_WIN32_WCE)
292 PIXELFORMATDESCRIPTOR* ppfd, pfd;
293 int flags, pixelformat;
295 freeglut_return_val_if_fail( window != NULL, 0 );
296 flags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL;
297 if( fgState.DisplayMode & GLUT_DOUBLE )
298 flags |= PFD_DOUBLEBUFFER;
300 if( fgState.DisplayMode & GLUT_STEREO )
303 #if defined(_MSC_VER)
304 #pragma message( "fgSetupPixelFormat(): there is still some work to do here!" )
307 /* Specify which pixel format do we opt for... */
308 pfd.nSize = sizeof(PIXELFORMATDESCRIPTOR);
312 if( fgState.DisplayMode & GLUT_INDEX )
314 pfd.iPixelType = PFD_TYPE_COLORINDEX;
322 pfd.iPixelType = PFD_TYPE_RGBA;
326 if ( fgState.DisplayMode & GLUT_ALPHA )
338 pfd.cAccumRedBits = 0;
339 pfd.cAccumGreenBits = 0;
340 pfd.cAccumBlueBits = 0;
341 pfd.cAccumAlphaBits = 0;
344 pfd.cStencilBits = 0;
347 pfd.cStencilBits = 8;
349 if( fgState.DisplayMode & GLUT_AUX4 )
351 else if( fgState.DisplayMode & GLUT_AUX3 )
353 else if( fgState.DisplayMode & GLUT_AUX2 )
355 else if( fgState.DisplayMode & GLUT_AUX1 )
360 pfd.iLayerType = layer_type;
363 pfd.dwVisibleMask = 0;
364 pfd.dwDamageMask = 0;
366 pfd.cColorBits = (BYTE) GetDeviceCaps( window->Window.Device, BITSPIXEL );
369 pixelformat = ChoosePixelFormat( window->Window.Device, ppfd );
371 /* windows hack for multismapling */
372 if (fgState.DisplayMode&GLUT_MULTISAMPLE)
374 PFNWGLGETEXTENSIONSSTRINGARBPROC wglGetEntensionsStringARB=NULL;
375 HGLRC rc, rc_before=wglGetCurrentContext();
377 HDC hDC, hDC_before=wglGetCurrentDC();
381 /* create a dummy window */
382 ZeroMemory(&wndCls, sizeof(wndCls));
383 wndCls.lpfnWndProc = DefWindowProc;
384 wndCls.hInstance = fgDisplay.Instance;
385 wndCls.style = CS_OWNDC | CS_HREDRAW | CS_VREDRAW;
386 wndCls.lpszClassName = _T("FREEGLUT_dummy");
387 atom = RegisterClass( &wndCls );
389 hWnd=CreateWindow((LPCSTR)atom, _T(""), WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_OVERLAPPEDWINDOW , 0,0,0,0, 0, 0, fgDisplay.Instance, 0 );
391 SetPixelFormat( hDC, pixelformat, ppfd );
393 rc = wglCreateContext( hDC );
394 wglMakeCurrent(hDC, rc);
396 wglGetEntensionsStringARB=(PFNWGLGETEXTENSIONSSTRINGARBPROC)wglGetProcAddress("wglGetExtensionsStringARB");
397 if (wglGetEntensionsStringARB)
399 const char * pWglExtString=wglGetEntensionsStringARB(hDC);
402 if (strstr(pWglExtString, "WGL_ARB_multisample"))
404 int pAttributes[100];
408 float fAttributes[] = {0,0};
410 PFNWGLCHOOSEPIXELFORMATARBPROC wglChoosePixelFormatARBProc=NULL;
412 wglChoosePixelFormatARBProc=(PFNWGLCHOOSEPIXELFORMATARBPROC)wglGetProcAddress("wglChoosePixelFormatARB");
413 if ( wglChoosePixelFormatARBProc )
415 pAttributes[iCounter++]=WGL_DRAW_TO_WINDOW_ARB; pAttributes[iCounter++]=GL_TRUE;
416 pAttributes[iCounter++]=WGL_SUPPORT_OPENGL_ARB; pAttributes[iCounter++]=GL_TRUE;
417 pAttributes[iCounter++]=WGL_ACCELERATION_ARB; pAttributes[iCounter++]=WGL_FULL_ACCELERATION_ARB;
419 pAttributes[iCounter++]=WGL_COLOR_BITS_ARB; pAttributes[iCounter++]=pfd.cColorBits ;
420 pAttributes[iCounter++]=WGL_ALPHA_BITS_ARB; pAttributes[iCounter++]=pfd.cAlphaBits;
421 pAttributes[iCounter++]=WGL_DEPTH_BITS_ARB; pAttributes[iCounter++]=pfd.cDepthBits;
422 pAttributes[iCounter++]=WGL_STENCIL_BITS_ARB; pAttributes[iCounter++]=pfd.cStencilBits;
424 pAttributes[iCounter++]=WGL_DOUBLE_BUFFER_ARB; pAttributes[iCounter++]=(fgState.DisplayMode & GLUT_DOUBLE)!=0;
425 pAttributes[iCounter++]=WGL_SAMPLE_BUFFERS_ARB; pAttributes[iCounter++]=GL_TRUE;
426 pAttributes[iCounter++]=WGL_SAMPLES_ARB; pAttributes[iCounter++]=4;
427 pAttributes[iCounter++]=0; pAttributes[iCounter++]=0; /* terminator */
429 bValid = wglChoosePixelFormatARBProc(window->Window.Device,pAttributes,fAttributes,1,&iPixelFormat,&numFormats);
431 if (bValid && numFormats>0)
432 pixelformat=iPixelFormat;
435 wglMakeCurrent( hDC_before, rc_before);
436 wglDeleteContext(rc);
437 ReleaseDC(hWnd, hDC);
439 UnregisterClass(_T("FREEGLUT_dummy"), fgDisplay.Instance);
444 if( pixelformat == 0 )
449 return SetPixelFormat( window->Window.Device, pixelformat, ppfd );
450 #endif /* defined(_WIN32_WCE) */
452 #endif /* TARGET_HOST_MS_WINDOWS */
455 * Sets the OpenGL context and the fgStructure "Current Window" pointer to
456 * the window structure passed in.
458 void fgSetWindow ( SFG_Window *window )
460 #if TARGET_HOST_POSIX_X11
462 glXMakeContextCurrent(
464 window->Window.Handle,
465 window->Window.Handle,
466 window->Window.Context
468 #elif TARGET_HOST_MS_WINDOWS
469 if( fgStructure.CurrentWindow )
470 ReleaseDC( fgStructure.CurrentWindow->Window.Handle,
471 fgStructure.CurrentWindow->Window.Device );
475 window->Window.Device = GetDC( window->Window.Handle );
477 window->Window.Device,
478 window->Window.Context
482 fgStructure.CurrentWindow = window;
487 #if TARGET_HOST_POSIX_X11
489 #ifndef GLX_CONTEXT_MAJOR_VERSION_ARB
490 #define GLX_CONTEXT_MAJOR_VERSION_ARB 0x2091
493 #ifndef GLX_CONTEXT_MINOR_VERSION_ARB
494 #define GLX_CONTEXT_MINOR_VERSION_ARB 0x2092
497 #ifndef GLX_CONTEXT_FLAGS_ARB
498 #define GLX_CONTEXT_FLAGS_ARB 0x2094
501 #ifndef GLX_CONTEXT_DEBUG_BIT_ARB
502 #define GLX_CONTEXT_DEBUG_BIT_ARB 0x0001
505 #ifndef GLX_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB
506 #define GLX_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB 0x0002
509 typedef GLXContext (*CreateContextAttribsProc)(Display *dpy, GLXFBConfig config,
510 GLXContext share_list, Bool direct,
511 const int *attrib_list);
513 static GLXContext fghCreateNewContext( SFG_Window* window )
515 /* for color model calculation */
516 int menu = ( window->IsMenu && !fgStructure.MenuContext );
517 int index_mode = ( fgState.DisplayMode & GLUT_INDEX );
519 /* "classic" context creation */
520 Display *dpy = fgDisplay.Display;
521 GLXFBConfig config = *(window->Window.FBConfig);
522 int render_type = ( !menu && index_mode ) ? GLX_COLOR_INDEX_TYPE : GLX_RGBA_TYPE;
523 GLXContext share_list = NULL;
524 Bool direct = ( fgState.DirectContext != GLUT_FORCE_INDIRECT_CONTEXT );
527 /* new context creation */
529 CreateContextAttribsProc createContextAttribs;
531 /* If nothing fancy has been required, simply use the old context creation GLX API entry */
532 if ( fgState.MajorVersion == 1 && fgState.MinorVersion == 0 && fgState.ContextFlags == 0)
534 context = glXCreateNewContext( dpy, config, render_type, share_list, direct );
535 if ( context == NULL ) {
536 fgError( "could not create new OpenGL context" );
541 /* color index mode is not available anymore with OpenGL 3.0 */
542 if ( render_type == GLX_COLOR_INDEX_TYPE ) {
543 fgWarning( "color index mode is deprecated, using RGBA mode" );
546 attribs[0] = GLX_CONTEXT_MAJOR_VERSION_ARB;
547 attribs[1] = fgState.MajorVersion;
548 attribs[2] = GLX_CONTEXT_MINOR_VERSION_ARB;
549 attribs[3] = fgState.MinorVersion;
550 attribs[4] = GLX_CONTEXT_FLAGS_ARB;
551 attribs[5] = ((fgState.ContextFlags & GLUT_DEBUG) ? GLX_CONTEXT_DEBUG_BIT_ARB : 0) |
552 ((fgState.ContextFlags & GLUT_FORWARD_COMPATIBLE) ? GLX_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB : 0);
555 createContextAttribs = (CreateContextAttribsProc) fghGetProcAddress( "glXCreateContextAttribsARB" );
556 if ( createContextAttribs == NULL ) {
557 fgError( "glXCreateContextAttribsARB not found" );
560 context = createContextAttribs( dpy, config, share_list, direct, attribs );
561 if ( context == NULL ) {
562 fgError( "could not create new OpenGL %d.%d context (flags %x)",
563 fgState.MajorVersion, fgState.MinorVersion, fgState.ContextFlags );
571 * Opens a window. Requires a SFG_Window object created and attached
572 * to the freeglut structure. OpenGL context is created here.
574 void fgOpenWindow( SFG_Window* window, const char* title,
575 GLboolean positionUse, int x, int y,
576 GLboolean sizeUse, int w, int h,
577 GLboolean gameMode, GLboolean isSubWindow )
579 #if TARGET_HOST_POSIX_X11
580 XVisualInfo * visualInfo;
581 XSetWindowAttributes winAttr;
582 XTextProperty textProperty;
583 XSizeHints sizeHints;
586 unsigned int current_DisplayMode = fgState.DisplayMode ;
588 /* Save the display mode if we are creating a menu window */
589 if( window->IsMenu && ( ! fgStructure.MenuContext ) )
590 fgState.DisplayMode = GLUT_DOUBLE | GLUT_RGB ;
592 window->Window.FBConfig = fgChooseFBConfig( );
594 if( window->IsMenu && ( ! fgStructure.MenuContext ) )
595 fgState.DisplayMode = current_DisplayMode ;
597 if( ! window->Window.FBConfig )
600 * The "fgChooseFBConfig" returned a null meaning that the visual
601 * context is not available.
602 * Try a couple of variations to see if they will work.
604 if( !( fgState.DisplayMode & GLUT_DOUBLE ) )
606 fgState.DisplayMode |= GLUT_DOUBLE ;
607 window->Window.FBConfig = fgChooseFBConfig( );
608 fgState.DisplayMode &= ~GLUT_DOUBLE;
611 if( fgState.DisplayMode & GLUT_MULTISAMPLE )
613 fgState.DisplayMode &= ~GLUT_MULTISAMPLE ;
614 window->Window.FBConfig = fgChooseFBConfig( );
615 fgState.DisplayMode |= GLUT_MULTISAMPLE;
619 FREEGLUT_INTERNAL_ERROR_EXIT( window->Window.FBConfig != NULL,
620 "FBConfig with necessary capabilities not found", "fgOpenWindow" );
622 /* Get the X visual. */
623 visualInfo = glXGetVisualFromFBConfig( fgDisplay.Display,
624 *(window->Window.FBConfig) );
627 * XXX HINT: the masks should be updated when adding/removing callbacks.
628 * XXX This might speed up message processing. Is that true?
630 * XXX A: Not appreciably, but it WILL make it easier to debug.
631 * XXX Try tracing old GLUT and try tracing freeglut. Old GLUT
632 * XXX turns off events that it doesn't need and is a whole lot
633 * XXX more pleasant to trace. (Think mouse-motion! Tons of
634 * XXX ``bonus'' GUI events stream in.)
637 StructureNotifyMask | SubstructureNotifyMask | ExposureMask |
638 ButtonPressMask | ButtonReleaseMask | KeyPressMask | KeyReleaseMask |
639 VisibilityChangeMask | EnterWindowMask | LeaveWindowMask |
640 PointerMotionMask | ButtonMotionMask;
641 winAttr.background_pixmap = None;
642 winAttr.background_pixel = 0;
643 winAttr.border_pixel = 0;
645 winAttr.colormap = XCreateColormap(
646 fgDisplay.Display, fgDisplay.RootWindow,
647 visualInfo->visual, AllocNone
650 mask = CWBackPixmap | CWBorderPixel | CWColormap | CWEventMask;
652 if( window->IsMenu || ( gameMode == GL_TRUE ) )
654 winAttr.override_redirect = True;
655 mask |= CWOverrideRedirect;
659 x = y = -1; /* default window position */
661 w = h = 300; /* default window size */
663 window->Window.Handle = XCreateWindow(
665 window->Parent == NULL ? fgDisplay.RootWindow :
666 window->Parent->Window.Handle,
668 visualInfo->depth, InputOutput,
669 visualInfo->visual, mask,
674 * The GLX context creation, possibly trying the direct context rendering
675 * or else use the current context if the user has so specified
681 * If there isn't already an OpenGL rendering context for menu
684 if( !fgStructure.MenuContext )
686 fgStructure.MenuContext =
687 (SFG_MenuContext *)malloc( sizeof(SFG_MenuContext) );
688 fgStructure.MenuContext->MContext = fghCreateNewContext( window );
691 /* window->Window.Context = fgStructure.MenuContext->MContext; */
692 window->Window.Context = fghCreateNewContext( window );
694 else if( fgState.UseCurrentContext )
696 window->Window.Context = glXGetCurrentContext( );
698 if( ! window->Window.Context )
699 window->Window.Context = fghCreateNewContext( window );
702 window->Window.Context = fghCreateNewContext( window );
704 #if !defined( __FreeBSD__ ) && !defined( __NetBSD__ )
705 if( !glXIsDirect( fgDisplay.Display, window->Window.Context ) )
707 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
708 fgError( "Unable to force direct context rendering for window '%s'",
710 else if( fgState.DirectContext == GLUT_TRY_DIRECT_CONTEXT )
711 fgWarning( "Unable to create direct context rendering for window '%s'\nThis may hurt performance.",
717 * XXX Assume the new window is visible by default
718 * XXX Is this a safe assumption?
720 window->State.Visible = GL_TRUE;
724 sizeHints.flags |= USPosition;
726 sizeHints.flags |= USSize;
729 * Fill in the size hints values now (the x, y, width and height
730 * settings are obsolete, are there any more WMs that support them?)
731 * Unless the X servers actually stop supporting these, we should
732 * continue to fill them in. It is *not* our place to tell the user
733 * that they should replace a window manager that they like, and which
734 * works, just because *we* think that it's not "modern" enough.
739 sizeHints.height = h;
741 wmHints.flags = StateHint;
742 wmHints.initial_state = fgState.ForceIconic ? IconicState : NormalState;
743 /* Prepare the window and iconified window names... */
744 XStringListToTextProperty( (char **) &title, 1, &textProperty );
748 window->Window.Handle,
757 XFree( textProperty.value );
759 XSetWMProtocols( fgDisplay.Display, window->Window.Handle,
760 &fgDisplay.DeleteWindow, 1 );
762 glXMakeContextCurrent(
764 window->Window.Handle,
765 window->Window.Handle,
766 window->Window.Context
769 XMapWindow( fgDisplay.Display, window->Window.Handle );
773 #elif TARGET_HOST_MS_WINDOWS
781 /* Grab the window class we have registered on glutInit(): */
782 atom = GetClassInfo( fgDisplay.Instance, _T("FREEGLUT"), &wc );
783 FREEGLUT_INTERNAL_ERROR_EXIT ( atom, "Window Class Info Not Found",
788 FREEGLUT_INTERNAL_ERROR_EXIT ( window->Parent == NULL,
789 "Game mode being invoked on a subwindow",
793 * Set the window creation flags appropriately to make the window
796 flags = WS_POPUP | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_VISIBLE;
800 int worig = w, horig = h;
802 #if !defined(_WIN32_WCE)
803 if ( ( ! isSubWindow ) && ( ! window->IsMenu ) )
806 * Update the window dimensions, taking account of window
807 * decorations. "freeglut" is to create the window with the
808 * outside of its border at (x,y) and with dimensions (w,h).
810 w += (GetSystemMetrics( SM_CXSIZEFRAME ) )*2;
811 h += (GetSystemMetrics( SM_CYSIZEFRAME ) )*2 +
812 GetSystemMetrics( SM_CYCAPTION );
814 #endif /* defined(_WIN32_WCE) */
821 /* setting State.Width/Height to call resize callback later */
824 if( ! window->IsMenu )
829 else /* fail safe - Windows can make a window of size (0, 0) */
830 w = h = 300; /* default window size */
831 window->State.Width = window->State.Height = -1;
835 window->State.Width = worig;
836 window->State.Height = horig;
840 * There's a small difference between creating the top, child and
843 flags = WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_VISIBLE;
845 if ( window->IsMenu )
848 exFlags |= WS_EX_TOOLWINDOW;
850 #if !defined(_WIN32_WCE)
851 else if( window->Parent == NULL )
852 flags |= WS_OVERLAPPEDWINDOW;
858 #if defined(_WIN32_WCE)
860 wchar_t* wstr = fghWstrFromStr(title);
862 window->Window.Handle = CreateWindow(
865 WS_VISIBLE | WS_POPUP,
875 SHFullScreen(window->Window.Handle, SHFS_HIDESTARTICON);
876 SHFullScreen(window->Window.Handle, SHFS_HIDESIPBUTTON);
877 SHFullScreen(window->Window.Handle, SHFS_HIDETASKBAR);
878 MoveWindow(window->Window.Handle, 0, 0, 240, 320, TRUE);
879 ShowWindow(window->Window.Handle, SW_SHOW);
880 UpdateWindow(window->Window.Handle);
883 window->Window.Handle = CreateWindowEx(
889 (HWND) window->Parent == NULL ? NULL : window->Parent->Window.Handle,
894 #endif /* defined(_WIN32_WCE) */
896 if( !( window->Window.Handle ) )
897 fgError( "Failed to create a window (%s)!", title );
899 /* Make a menu window always on top - fix Feature Request 947118 */
900 if( window->IsMenu || gameMode )
902 window->Window.Handle,
905 SWP_NOMOVE | SWP_NOSIZE
908 /* Hack to remove the caption (title bar) and/or border
909 * and all the system menu controls.
911 WindowStyle = GetWindowLong(window->Window.Handle, GWL_STYLE);
912 if ( fgState.DisplayMode & GLUT_CAPTIONLESS )
914 SetWindowLong ( window->Window.Handle, GWL_STYLE,
915 WindowStyle & ~(WS_DLGFRAME | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX));
917 else if ( fgState.DisplayMode & GLUT_BORDERLESS )
919 SetWindowLong ( window->Window.Handle, GWL_STYLE,
920 WindowStyle & ~(WS_BORDER | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX));
922 /* SetWindowPos(window->Window.Handle, NULL, 0, 0, 0, 0,
923 SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED); */
926 #if defined(_WIN32_WCE)
927 ShowWindow( window->Window.Handle, SW_SHOW );
929 ShowWindow( window->Window.Handle,
930 fgState.ForceIconic ? SW_SHOWMINIMIZED : SW_SHOW );
931 #endif /* defined(_WIN32_WCE) */
933 UpdateWindow( window->Window.Handle );
934 ShowCursor( TRUE ); /* XXX Old comments say "hide cursor"! */
938 fgSetWindow( window );
940 window->Window.DoubleBuffered =
941 ( fgState.DisplayMode & GLUT_DOUBLE ) ? 1 : 0;
943 if ( ! window->Window.DoubleBuffered )
945 glDrawBuffer ( GL_FRONT );
946 glReadBuffer ( GL_FRONT );
951 * Closes a window, destroying the frame and OpenGL context
953 void fgCloseWindow( SFG_Window* window )
955 #if TARGET_HOST_POSIX_X11
957 glXDestroyContext( fgDisplay.Display, window->Window.Context );
958 XFree( window->Window.FBConfig );
959 XDestroyWindow( fgDisplay.Display, window->Window.Handle );
960 /* XFlush( fgDisplay.Display ); */ /* XXX Shouldn't need this */
962 #elif TARGET_HOST_MS_WINDOWS
964 /* Make sure we don't close a window with current context active */
965 if( fgStructure.CurrentWindow == window )
966 wglMakeCurrent( NULL, NULL );
969 * Step through the list of windows. If the rendering context
970 * is not being used by another window, then we delete it.
976 for( iter = (SFG_Window *)fgStructure.Windows.First;
978 iter = (SFG_Window *)iter->Node.Next )
980 if( ( iter->Window.Context == window->Window.Context ) &&
986 wglDeleteContext( window->Window.Context );
989 DestroyWindow( window->Window.Handle );
994 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
997 * Creates a new top-level freeglut window
999 int FGAPIENTRY glutCreateWindow( const char* title )
1001 /* XXX GLUT does not exit; it simply calls "glutInit" quietly if the
1002 * XXX application has not already done so. The "freeglut" community
1003 * XXX decided not to go this route (freeglut-developer e-mail from
1004 * XXX Steve Baker, 12/16/04, 4:22 PM CST, "Re: [Freeglut-developer]
1005 * XXX Desired 'freeglut' behaviour when there is no current window"
1007 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutCreateWindow" );
1009 return fgCreateWindow( NULL, title, fgState.Position.Use,
1010 fgState.Position.X, fgState.Position.Y,
1011 fgState.Size.Use, fgState.Size.X, fgState.Size.Y,
1012 GL_FALSE, GL_FALSE )->ID;
1016 * This function creates a sub window.
1018 int FGAPIENTRY glutCreateSubWindow( int parentID, int x, int y, int w, int h )
1021 SFG_Window* window = NULL;
1022 SFG_Window* parent = NULL;
1024 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutCreateSubWindow" );
1025 parent = fgWindowByID( parentID );
1026 freeglut_return_val_if_fail( parent != NULL, 0 );
1029 x = parent->State.Width + x ;
1030 if ( w >= 0 ) x -= w ;
1033 if ( w < 0 ) w = parent->State.Width - x + w ;
1042 y = parent->State.Height + y ;
1043 if ( h >= 0 ) y -= h ;
1046 if ( h < 0 ) h = parent->State.Height - y + h ;
1053 window = fgCreateWindow( parent, "", GL_TRUE, x, y, GL_TRUE, w, h, GL_FALSE, GL_FALSE );
1060 * Destroys a window and all of its subwindows
1062 void FGAPIENTRY glutDestroyWindow( int windowID )
1065 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutDestroyWindow" );
1066 window = fgWindowByID( windowID );
1067 freeglut_return_if_fail( window != NULL );
1069 fgExecutionState ExecState = fgState.ExecState;
1070 fgAddToWindowDestroyList( window );
1071 fgState.ExecState = ExecState;
1076 * This function selects the current window
1078 void FGAPIENTRY glutSetWindow( int ID )
1080 SFG_Window* window = NULL;
1082 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindow" );
1083 if( fgStructure.CurrentWindow != NULL )
1084 if( fgStructure.CurrentWindow->ID == ID )
1087 window = fgWindowByID( ID );
1088 if( window == NULL )
1090 fgWarning( "glutSetWindow(): window ID %d not found!", ID );
1094 fgSetWindow( window );
1098 * This function returns the ID number of the current window, 0 if none exists
1100 int FGAPIENTRY glutGetWindow( void )
1102 SFG_Window *win = fgStructure.CurrentWindow;
1104 * Since GLUT did not throw an error if this function was called without a prior call to
1105 * "glutInit", this function shouldn't do so here. Instead let us return a zero.
1106 * See Feature Request "[ 1307049 ] glutInit check".
1108 if ( ! fgState.Initialised )
1111 while ( win && win->IsMenu )
1113 return win ? win->ID : 0;
1117 * This function makes the current window visible
1119 void FGAPIENTRY glutShowWindow( void )
1121 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutShowWindow" );
1122 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutShowWindow" );
1124 #if TARGET_HOST_POSIX_X11
1126 XMapWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1127 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1129 #elif TARGET_HOST_MS_WINDOWS
1131 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_SHOW );
1135 fgStructure.CurrentWindow->State.Redisplay = GL_TRUE;
1139 * This function hides the current window
1141 void FGAPIENTRY glutHideWindow( void )
1143 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutHideWindow" );
1144 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutHideWindow" );
1146 #if TARGET_HOST_POSIX_X11
1148 if( fgStructure.CurrentWindow->Parent == NULL )
1149 XWithdrawWindow( fgDisplay.Display,
1150 fgStructure.CurrentWindow->Window.Handle,
1153 XUnmapWindow( fgDisplay.Display,
1154 fgStructure.CurrentWindow->Window.Handle );
1155 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1157 #elif TARGET_HOST_MS_WINDOWS
1159 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_HIDE );
1163 fgStructure.CurrentWindow->State.Redisplay = GL_FALSE;
1167 * Iconify the current window (top-level windows only)
1169 void FGAPIENTRY glutIconifyWindow( void )
1171 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutIconifyWindow" );
1172 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutIconifyWindow" );
1174 fgStructure.CurrentWindow->State.Visible = GL_FALSE;
1175 #if TARGET_HOST_POSIX_X11
1177 XIconifyWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle,
1179 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1181 #elif TARGET_HOST_MS_WINDOWS
1183 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_MINIMIZE );
1187 fgStructure.CurrentWindow->State.Redisplay = GL_FALSE;
1191 * Set the current window's title
1193 void FGAPIENTRY glutSetWindowTitle( const char* title )
1195 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindowTitle" );
1196 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetWindowTitle" );
1197 if( ! fgStructure.CurrentWindow->Parent )
1199 #if TARGET_HOST_POSIX_X11
1203 text.value = (unsigned char *) title;
1204 text.encoding = XA_STRING;
1206 text.nitems = strlen( title );
1210 fgStructure.CurrentWindow->Window.Handle,
1214 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1216 #elif TARGET_HOST_MS_WINDOWS
1219 wchar_t* wstr = fghWstrFromStr(title);
1220 SetWindowText( fgStructure.CurrentWindow->Window.Handle, wstr );
1224 SetWindowText( fgStructure.CurrentWindow->Window.Handle, title );
1232 * Set the current window's iconified title
1234 void FGAPIENTRY glutSetIconTitle( const char* title )
1236 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetIconTitle" );
1237 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetIconTitle" );
1239 if( ! fgStructure.CurrentWindow->Parent )
1241 #if TARGET_HOST_POSIX_X11
1245 text.value = (unsigned char *) title;
1246 text.encoding = XA_STRING;
1248 text.nitems = strlen( title );
1252 fgStructure.CurrentWindow->Window.Handle,
1256 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1258 #elif TARGET_HOST_MS_WINDOWS
1261 wchar_t* wstr = fghWstrFromStr(title);
1262 SetWindowText( fgStructure.CurrentWindow->Window.Handle, wstr );
1266 SetWindowText( fgStructure.CurrentWindow->Window.Handle, title );
1274 * Change the current window's size
1276 void FGAPIENTRY glutReshapeWindow( int width, int height )
1278 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutReshapeWindow" );
1279 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutReshapeWindow" );
1281 if (glutGet(GLUT_FULL_SCREEN))
1283 /* Leave full screen state before resizing. */
1284 glutFullScreenToggle();
1287 fgStructure.CurrentWindow->State.NeedToResize = GL_TRUE;
1288 fgStructure.CurrentWindow->State.Width = width ;
1289 fgStructure.CurrentWindow->State.Height = height;
1293 * Change the current window's position
1295 void FGAPIENTRY glutPositionWindow( int x, int y )
1297 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPositionWindow" );
1298 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPositionWindow" );
1300 if (glutGet(GLUT_FULL_SCREEN))
1302 /* Leave full screen state before moving. */
1303 glutFullScreenToggle();
1306 #if TARGET_HOST_POSIX_X11
1308 XMoveWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle,
1310 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1312 #elif TARGET_HOST_MS_WINDOWS
1317 /* "GetWindowRect" returns the pixel coordinates of the outside of the window */
1318 GetWindowRect( fgStructure.CurrentWindow->Window.Handle, &winRect );
1320 fgStructure.CurrentWindow->Window.Handle,
1323 winRect.right - winRect.left,
1324 winRect.bottom - winRect.top,
1333 * Lowers the current window (by Z order change)
1335 void FGAPIENTRY glutPushWindow( void )
1337 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPushWindow" );
1338 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPushWindow" );
1340 #if TARGET_HOST_POSIX_X11
1342 XLowerWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1344 #elif TARGET_HOST_MS_WINDOWS
1347 fgStructure.CurrentWindow->Window.Handle,
1350 SWP_NOSIZE | SWP_NOMOVE
1357 * Raises the current window (by Z order change)
1359 void FGAPIENTRY glutPopWindow( void )
1361 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPopWindow" );
1362 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPopWindow" );
1364 #if TARGET_HOST_POSIX_X11
1366 XRaiseWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1368 #elif TARGET_HOST_MS_WINDOWS
1371 fgStructure.CurrentWindow->Window.Handle,
1374 SWP_NOSIZE | SWP_NOMOVE
1381 * Resize the current window so that it fits the whole screen
1383 void FGAPIENTRY glutFullScreen( void )
1385 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutFullScreen" );
1386 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutFullScreen" );
1388 if (glutGet(GLUT_FULL_SCREEN))
1390 /* Leave full screen state before resizing. */
1391 glutFullScreenToggle();
1395 #if TARGET_HOST_POSIX_X11
1397 Status status; /* Returned by XGetWindowAttributes(), not checked. */
1398 XWindowAttributes attributes;
1400 status = XGetWindowAttributes(fgDisplay.Display,
1401 fgStructure.CurrentWindow->Window.Handle,
1404 * The "x" and "y" members of "attributes" are the window's coordinates
1405 * relative to its parent, i.e. to the decoration window.
1407 XMoveResizeWindow(fgDisplay.Display,
1408 fgStructure.CurrentWindow->Window.Handle,
1411 fgDisplay.ScreenWidth,
1412 fgDisplay.ScreenHeight);
1414 #elif TARGET_HOST_MS_WINDOWS && !defined(_WIN32_WCE) /* FIXME: what about WinCE */
1417 /* For fullscreen mode, force the top-left corner to 0,0
1418 * and adjust the window rectangle so that the client area
1419 * covers the whole screen.
1424 rect.right = fgDisplay.ScreenWidth;
1425 rect.bottom = fgDisplay.ScreenHeight;
1427 AdjustWindowRect ( &rect, WS_OVERLAPPEDWINDOW | WS_CLIPSIBLINGS |
1428 WS_CLIPCHILDREN, FALSE );
1431 * SWP_NOACTIVATE Do not activate the window
1432 * SWP_NOOWNERZORDER Do not change position in z-order
1433 * SWP_NOSENDCHANGING Supress WM_WINDOWPOSCHANGING message
1434 * SWP_NOZORDER Retains the current Z order (ignore 2nd param)
1437 SetWindowPos( fgStructure.CurrentWindow->Window.Handle,
1441 rect.right - rect.left,
1442 rect.bottom - rect.top,
1443 SWP_NOACTIVATE | SWP_NOOWNERZORDER | SWP_NOSENDCHANGING |
1451 * Toggle the window's full screen state.
1453 void FGAPIENTRY glutFullScreenToggle( void )
1455 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutFullScreenToggle" );
1456 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutFullScreenToggle" );
1459 #if TARGET_HOST_POSIX_X11
1461 if (fgDisplay.StateFullScreen != None)
1467 xevent.type = ClientMessage;
1468 xevent.xclient.type = ClientMessage;
1469 xevent.xclient.serial = 0;
1470 xevent.xclient.send_event = True;
1471 xevent.xclient.display = fgDisplay.Display;
1472 xevent.xclient.window = fgStructure.CurrentWindow->Window.Handle;
1473 xevent.xclient.message_type = fgDisplay.State;
1474 xevent.xclient.format = 32;
1475 xevent.xclient.data.l[0] = 2; /* _NET_WM_STATE_TOGGLE */
1476 xevent.xclient.data.l[1] = fgDisplay.StateFullScreen;
1477 xevent.xclient.data.l[2] = 0;
1478 xevent.xclient.data.l[3] = 0;
1479 xevent.xclient.data.l[4] = 0;
1481 /*** Don't really understand how event masks work... ***/
1482 event_mask = SubstructureRedirectMask | SubstructureNotifyMask;
1484 status = XSendEvent(fgDisplay.Display,
1485 fgDisplay.RootWindow,
1489 FREEGLUT_INTERNAL_ERROR_EXIT(status != 0,
1490 "XSendEvent failed",
1491 "glutFullScreenToggle");
1497 * If the window manager is not Net WM compliant, fall back to legacy
1506 * A.Donev: Set and retrieve the window's user data
1508 void* FGAPIENTRY glutGetWindowData( void )
1510 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutGetWindowData" );
1511 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutGetWindowData" );
1512 return fgStructure.CurrentWindow->UserData;
1515 void FGAPIENTRY glutSetWindowData(void* data)
1517 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindowData" );
1518 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetWindowData" );
1519 fgStructure.CurrentWindow->UserData = data;
1522 /*** END OF FILE ***/