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 * Opens a window. Requires a SFG_Window object created and attached
488 * to the freeglut structure. OpenGL context is created here.
490 void fgOpenWindow( SFG_Window* window, const char* title,
491 GLboolean positionUse, int x, int y,
492 GLboolean sizeUse, int w, int h,
493 GLboolean gameMode, GLboolean isSubWindow )
495 #if TARGET_HOST_POSIX_X11
496 XVisualInfo * visualInfo;
497 XSetWindowAttributes winAttr;
498 XTextProperty textProperty;
499 XSizeHints sizeHints;
502 int renderType; /* GLX_RGBA_TYPE or GLX_COLOR_INDEX_TYPE */
503 unsigned int current_DisplayMode = fgState.DisplayMode ;
505 /* Save the display mode if we are creating a menu window */
506 if( window->IsMenu && ( ! fgStructure.MenuContext ) )
507 fgState.DisplayMode = GLUT_DOUBLE | GLUT_RGB ;
509 window->Window.FBConfig = fgChooseFBConfig( );
511 if( window->IsMenu && ( ! fgStructure.MenuContext ) )
512 fgState.DisplayMode = current_DisplayMode ;
514 if( ! window->Window.FBConfig )
517 * The "fgChooseFBConfig" returned a null meaning that the visual
518 * context is not available.
519 * Try a couple of variations to see if they will work.
521 if( !( fgState.DisplayMode & GLUT_DOUBLE ) )
523 fgState.DisplayMode |= GLUT_DOUBLE ;
524 window->Window.FBConfig = fgChooseFBConfig( );
525 fgState.DisplayMode &= ~GLUT_DOUBLE;
528 if( fgState.DisplayMode & GLUT_MULTISAMPLE )
530 fgState.DisplayMode &= ~GLUT_MULTISAMPLE ;
531 window->Window.FBConfig = fgChooseFBConfig( );
532 fgState.DisplayMode |= GLUT_MULTISAMPLE;
536 FREEGLUT_INTERNAL_ERROR_EXIT( window->Window.FBConfig != NULL,
537 "FBConfig with necessary capabilities not found", "fgOpenWindow" );
539 /* Get the X visual. */
540 visualInfo = glXGetVisualFromFBConfig( fgDisplay.Display,
541 *(window->Window.FBConfig) );
544 * XXX HINT: the masks should be updated when adding/removing callbacks.
545 * XXX This might speed up message processing. Is that true?
547 * XXX A: Not appreciably, but it WILL make it easier to debug.
548 * XXX Try tracing old GLUT and try tracing freeglut. Old GLUT
549 * XXX turns off events that it doesn't need and is a whole lot
550 * XXX more pleasant to trace. (Think mouse-motion! Tons of
551 * XXX ``bonus'' GUI events stream in.)
554 StructureNotifyMask | SubstructureNotifyMask | ExposureMask |
555 ButtonPressMask | ButtonReleaseMask | KeyPressMask | KeyReleaseMask |
556 VisibilityChangeMask | EnterWindowMask | LeaveWindowMask |
557 PointerMotionMask | ButtonMotionMask;
558 winAttr.background_pixmap = None;
559 winAttr.background_pixel = 0;
560 winAttr.border_pixel = 0;
562 winAttr.colormap = XCreateColormap(
563 fgDisplay.Display, fgDisplay.RootWindow,
564 visualInfo->visual, AllocNone
567 mask = CWBackPixmap | CWBorderPixel | CWColormap | CWEventMask;
569 if( window->IsMenu || ( gameMode == GL_TRUE ) )
571 winAttr.override_redirect = True;
572 mask |= CWOverrideRedirect;
576 x = y = -1; /* default window position */
578 w = h = 300; /* default window size */
580 window->Window.Handle = XCreateWindow(
582 window->Parent == NULL ? fgDisplay.RootWindow :
583 window->Parent->Window.Handle,
585 visualInfo->depth, InputOutput,
586 visualInfo->visual, mask,
591 * The GLX context creation, possibly trying the direct context rendering
592 * or else use the current context if the user has so specified
595 /* Set renderType. */
596 if( window->IsMenu && ( ! fgStructure.MenuContext ) )
598 /* Display mode has been set to GLUT_RGB. */
599 renderType = GLX_RGBA_TYPE;
601 else if (fgState.DisplayMode & GLUT_INDEX)
603 renderType = GLX_COLOR_INDEX_TYPE;
607 renderType = GLX_RGBA_TYPE;
613 * If there isn't already an OpenGL rendering context for menu
616 if( !fgStructure.MenuContext )
618 fgStructure.MenuContext =
619 (SFG_MenuContext *)malloc( sizeof(SFG_MenuContext) );
620 fgStructure.MenuContext->MContext = glXCreateNewContext(
621 fgDisplay.Display, *(window->Window.FBConfig), renderType,
622 NULL, ( fgState.DirectContext != GLUT_FORCE_INDIRECT_CONTEXT )
626 /* window->Window.Context = fgStructure.MenuContext->MContext; */
627 window->Window.Context = glXCreateNewContext(
628 fgDisplay.Display, *(window->Window.FBConfig), renderType,
629 NULL, ( fgState.DirectContext != GLUT_FORCE_INDIRECT_CONTEXT )
632 else if( fgState.UseCurrentContext )
634 window->Window.Context = glXGetCurrentContext( );
636 if( ! window->Window.Context )
637 window->Window.Context = glXCreateNewContext(
638 fgDisplay.Display, *(window->Window.FBConfig), renderType,
639 NULL, ( fgState.DirectContext != GLUT_FORCE_INDIRECT_CONTEXT )
643 window->Window.Context = glXCreateNewContext(
644 fgDisplay.Display, *(window->Window.FBConfig), renderType,
645 NULL, ( fgState.DirectContext != GLUT_FORCE_INDIRECT_CONTEXT )
648 #if !defined( __FreeBSD__ ) && !defined( __NetBSD__ )
649 if( !glXIsDirect( fgDisplay.Display, window->Window.Context ) )
651 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
652 fgError( "Unable to force direct context rendering for window '%s'",
654 else if( fgState.DirectContext == GLUT_TRY_DIRECT_CONTEXT )
655 fgWarning( "Unable to create direct context rendering for window '%s'\nThis may hurt performance.",
661 * XXX Assume the new window is visible by default
662 * XXX Is this a safe assumption?
664 window->State.Visible = GL_TRUE;
668 sizeHints.flags |= USPosition;
670 sizeHints.flags |= USSize;
673 * Fill in the size hints values now (the x, y, width and height
674 * settings are obsolete, are there any more WMs that support them?)
675 * Unless the X servers actually stop supporting these, we should
676 * continue to fill them in. It is *not* our place to tell the user
677 * that they should replace a window manager that they like, and which
678 * works, just because *we* think that it's not "modern" enough.
683 sizeHints.height = h;
685 wmHints.flags = StateHint;
686 wmHints.initial_state = fgState.ForceIconic ? IconicState : NormalState;
687 /* Prepare the window and iconified window names... */
688 XStringListToTextProperty( (char **) &title, 1, &textProperty );
692 window->Window.Handle,
701 XFree( textProperty.value );
703 XSetWMProtocols( fgDisplay.Display, window->Window.Handle,
704 &fgDisplay.DeleteWindow, 1 );
706 glXMakeContextCurrent(
708 window->Window.Handle,
709 window->Window.Handle,
710 window->Window.Context
713 XMapWindow( fgDisplay.Display, window->Window.Handle );
717 #elif TARGET_HOST_MS_WINDOWS
725 /* Grab the window class we have registered on glutInit(): */
726 atom = GetClassInfo( fgDisplay.Instance, _T("FREEGLUT"), &wc );
727 FREEGLUT_INTERNAL_ERROR_EXIT ( atom, "Window Class Info Not Found",
732 FREEGLUT_INTERNAL_ERROR_EXIT ( window->Parent == NULL,
733 "Game mode being invoked on a subwindow",
737 * Set the window creation flags appropriately to make the window
740 flags = WS_POPUP | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_VISIBLE;
744 int worig = w, horig = h;
746 #if !defined(_WIN32_WCE)
747 if ( ( ! isSubWindow ) && ( ! window->IsMenu ) )
750 * Update the window dimensions, taking account of window
751 * decorations. "freeglut" is to create the window with the
752 * outside of its border at (x,y) and with dimensions (w,h).
754 w += (GetSystemMetrics( SM_CXSIZEFRAME ) )*2;
755 h += (GetSystemMetrics( SM_CYSIZEFRAME ) )*2 +
756 GetSystemMetrics( SM_CYCAPTION );
758 #endif /* defined(_WIN32_WCE) */
765 /* setting State.Width/Height to call resize callback later */
768 if( ! window->IsMenu )
773 else /* fail safe - Windows can make a window of size (0, 0) */
774 w = h = 300; /* default window size */
775 window->State.Width = window->State.Height = -1;
779 window->State.Width = worig;
780 window->State.Height = horig;
784 * There's a small difference between creating the top, child and
787 flags = WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_VISIBLE;
789 if ( window->IsMenu )
792 exFlags |= WS_EX_TOOLWINDOW;
794 #if !defined(_WIN32_WCE)
795 else if( window->Parent == NULL )
796 flags |= WS_OVERLAPPEDWINDOW;
802 #if defined(_WIN32_WCE)
804 wchar_t* wstr = fghWstrFromStr(title);
806 window->Window.Handle = CreateWindow(
809 WS_VISIBLE | WS_POPUP,
819 SHFullScreen(window->Window.Handle, SHFS_HIDESTARTICON);
820 SHFullScreen(window->Window.Handle, SHFS_HIDESIPBUTTON);
821 SHFullScreen(window->Window.Handle, SHFS_HIDETASKBAR);
822 MoveWindow(window->Window.Handle, 0, 0, 240, 320, TRUE);
823 ShowWindow(window->Window.Handle, SW_SHOW);
824 UpdateWindow(window->Window.Handle);
827 window->Window.Handle = CreateWindowEx(
833 (HWND) window->Parent == NULL ? NULL : window->Parent->Window.Handle,
838 #endif /* defined(_WIN32_WCE) */
840 if( !( window->Window.Handle ) )
841 fgError( "Failed to create a window (%s)!", title );
843 /* Make a menu window always on top - fix Feature Request 947118 */
844 if( window->IsMenu || gameMode )
846 window->Window.Handle,
849 SWP_NOMOVE | SWP_NOSIZE
852 /* Hack to remove the caption (title bar) and/or border
853 * and all the system menu controls.
855 WindowStyle = GetWindowLong(window->Window.Handle, GWL_STYLE);
856 if ( fgState.DisplayMode & GLUT_CAPTIONLESS )
858 SetWindowLong ( window->Window.Handle, GWL_STYLE,
859 WindowStyle & ~(WS_DLGFRAME | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX));
861 else if ( fgState.DisplayMode & GLUT_BORDERLESS )
863 SetWindowLong ( window->Window.Handle, GWL_STYLE,
864 WindowStyle & ~(WS_BORDER | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX));
866 /* SetWindowPos(window->Window.Handle, NULL, 0, 0, 0, 0,
867 SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED); */
870 #if defined(_WIN32_WCE)
871 ShowWindow( window->Window.Handle, SW_SHOW );
873 ShowWindow( window->Window.Handle,
874 fgState.ForceIconic ? SW_SHOWMINIMIZED : SW_SHOW );
875 #endif /* defined(_WIN32_WCE) */
877 UpdateWindow( window->Window.Handle );
878 ShowCursor( TRUE ); /* XXX Old comments say "hide cursor"! */
882 fgSetWindow( window );
884 window->Window.DoubleBuffered =
885 ( fgState.DisplayMode & GLUT_DOUBLE ) ? 1 : 0;
887 if ( ! window->Window.DoubleBuffered )
889 glDrawBuffer ( GL_FRONT );
890 glReadBuffer ( GL_FRONT );
895 * Closes a window, destroying the frame and OpenGL context
897 void fgCloseWindow( SFG_Window* window )
899 #if TARGET_HOST_POSIX_X11
901 glXDestroyContext( fgDisplay.Display, window->Window.Context );
902 XFree( window->Window.FBConfig );
903 XDestroyWindow( fgDisplay.Display, window->Window.Handle );
904 /* XFlush( fgDisplay.Display ); */ /* XXX Shouldn't need this */
906 #elif TARGET_HOST_MS_WINDOWS
908 /* Make sure we don't close a window with current context active */
909 if( fgStructure.CurrentWindow == window )
910 wglMakeCurrent( NULL, NULL );
913 * Step through the list of windows. If the rendering context
914 * is not being used by another window, then we delete it.
920 for( iter = (SFG_Window *)fgStructure.Windows.First;
922 iter = (SFG_Window *)iter->Node.Next )
924 if( ( iter->Window.Context == window->Window.Context ) &&
930 wglDeleteContext( window->Window.Context );
933 DestroyWindow( window->Window.Handle );
938 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
941 * Creates a new top-level freeglut window
943 int FGAPIENTRY glutCreateWindow( const char* title )
945 /* XXX GLUT does not exit; it simply calls "glutInit" quietly if the
946 * XXX application has not already done so. The "freeglut" community
947 * XXX decided not to go this route (freeglut-developer e-mail from
948 * XXX Steve Baker, 12/16/04, 4:22 PM CST, "Re: [Freeglut-developer]
949 * XXX Desired 'freeglut' behaviour when there is no current window"
951 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutCreateWindow" );
953 return fgCreateWindow( NULL, title, fgState.Position.Use,
954 fgState.Position.X, fgState.Position.Y,
955 fgState.Size.Use, fgState.Size.X, fgState.Size.Y,
956 GL_FALSE, GL_FALSE )->ID;
960 * This function creates a sub window.
962 int FGAPIENTRY glutCreateSubWindow( int parentID, int x, int y, int w, int h )
965 SFG_Window* window = NULL;
966 SFG_Window* parent = NULL;
968 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutCreateSubWindow" );
969 parent = fgWindowByID( parentID );
970 freeglut_return_val_if_fail( parent != NULL, 0 );
973 x = parent->State.Width + x ;
974 if ( w >= 0 ) x -= w ;
977 if ( w < 0 ) w = parent->State.Width - x + w ;
986 y = parent->State.Height + y ;
987 if ( h >= 0 ) y -= h ;
990 if ( h < 0 ) h = parent->State.Height - y + h ;
997 window = fgCreateWindow( parent, "", GL_TRUE, x, y, GL_TRUE, w, h, GL_FALSE, GL_FALSE );
1004 * Destroys a window and all of its subwindows
1006 void FGAPIENTRY glutDestroyWindow( int windowID )
1009 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutDestroyWindow" );
1010 window = fgWindowByID( windowID );
1011 freeglut_return_if_fail( window != NULL );
1013 fgExecutionState ExecState = fgState.ExecState;
1014 fgAddToWindowDestroyList( window );
1015 fgState.ExecState = ExecState;
1020 * This function selects the current window
1022 void FGAPIENTRY glutSetWindow( int ID )
1024 SFG_Window* window = NULL;
1026 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindow" );
1027 if( fgStructure.CurrentWindow != NULL )
1028 if( fgStructure.CurrentWindow->ID == ID )
1031 window = fgWindowByID( ID );
1032 if( window == NULL )
1034 fgWarning( "glutSetWindow(): window ID %d not found!", ID );
1038 fgSetWindow( window );
1042 * This function returns the ID number of the current window, 0 if none exists
1044 int FGAPIENTRY glutGetWindow( void )
1046 SFG_Window *win = fgStructure.CurrentWindow;
1048 * Since GLUT did not throw an error if this function was called without a prior call to
1049 * "glutInit", this function shouldn't do so here. Instead let us return a zero.
1050 * See Feature Request "[ 1307049 ] glutInit check".
1052 if ( ! fgState.Initialised )
1055 while ( win && win->IsMenu )
1057 return win ? win->ID : 0;
1061 * This function makes the current window visible
1063 void FGAPIENTRY glutShowWindow( void )
1065 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutShowWindow" );
1066 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutShowWindow" );
1068 #if TARGET_HOST_POSIX_X11
1070 XMapWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1071 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1073 #elif TARGET_HOST_MS_WINDOWS
1075 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_SHOW );
1079 fgStructure.CurrentWindow->State.Redisplay = GL_TRUE;
1083 * This function hides the current window
1085 void FGAPIENTRY glutHideWindow( void )
1087 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutHideWindow" );
1088 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutHideWindow" );
1090 #if TARGET_HOST_POSIX_X11
1092 if( fgStructure.CurrentWindow->Parent == NULL )
1093 XWithdrawWindow( fgDisplay.Display,
1094 fgStructure.CurrentWindow->Window.Handle,
1097 XUnmapWindow( fgDisplay.Display,
1098 fgStructure.CurrentWindow->Window.Handle );
1099 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1101 #elif TARGET_HOST_MS_WINDOWS
1103 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_HIDE );
1107 fgStructure.CurrentWindow->State.Redisplay = GL_FALSE;
1111 * Iconify the current window (top-level windows only)
1113 void FGAPIENTRY glutIconifyWindow( void )
1115 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutIconifyWindow" );
1116 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutIconifyWindow" );
1118 fgStructure.CurrentWindow->State.Visible = GL_FALSE;
1119 #if TARGET_HOST_POSIX_X11
1121 XIconifyWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle,
1123 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1125 #elif TARGET_HOST_MS_WINDOWS
1127 ShowWindow( fgStructure.CurrentWindow->Window.Handle, SW_MINIMIZE );
1131 fgStructure.CurrentWindow->State.Redisplay = GL_FALSE;
1135 * Set the current window's title
1137 void FGAPIENTRY glutSetWindowTitle( const char* title )
1139 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindowTitle" );
1140 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetWindowTitle" );
1141 if( ! fgStructure.CurrentWindow->Parent )
1143 #if TARGET_HOST_POSIX_X11
1147 text.value = (unsigned char *) title;
1148 text.encoding = XA_STRING;
1150 text.nitems = strlen( title );
1154 fgStructure.CurrentWindow->Window.Handle,
1158 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1160 #elif TARGET_HOST_MS_WINDOWS
1163 wchar_t* wstr = fghWstrFromStr(title);
1164 SetWindowText( fgStructure.CurrentWindow->Window.Handle, wstr );
1168 SetWindowText( fgStructure.CurrentWindow->Window.Handle, title );
1176 * Set the current window's iconified title
1178 void FGAPIENTRY glutSetIconTitle( const char* title )
1180 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetIconTitle" );
1181 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetIconTitle" );
1183 if( ! fgStructure.CurrentWindow->Parent )
1185 #if TARGET_HOST_POSIX_X11
1189 text.value = (unsigned char *) title;
1190 text.encoding = XA_STRING;
1192 text.nitems = strlen( title );
1196 fgStructure.CurrentWindow->Window.Handle,
1200 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1202 #elif TARGET_HOST_MS_WINDOWS
1205 wchar_t* wstr = fghWstrFromStr(title);
1206 SetWindowText( fgStructure.CurrentWindow->Window.Handle, wstr );
1210 SetWindowText( fgStructure.CurrentWindow->Window.Handle, title );
1218 * Change the current window's size
1220 void FGAPIENTRY glutReshapeWindow( int width, int height )
1222 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutReshapeWindow" );
1223 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutReshapeWindow" );
1225 if (glutGet(GLUT_FULL_SCREEN))
1227 /* Leave full screen state before resizing. */
1228 glutFullScreenToggle();
1231 fgStructure.CurrentWindow->State.NeedToResize = GL_TRUE;
1232 fgStructure.CurrentWindow->State.Width = width ;
1233 fgStructure.CurrentWindow->State.Height = height;
1237 * Change the current window's position
1239 void FGAPIENTRY glutPositionWindow( int x, int y )
1241 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPositionWindow" );
1242 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPositionWindow" );
1244 if (glutGet(GLUT_FULL_SCREEN))
1246 /* Leave full screen state before moving. */
1247 glutFullScreenToggle();
1250 #if TARGET_HOST_POSIX_X11
1252 XMoveWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle,
1254 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
1256 #elif TARGET_HOST_MS_WINDOWS
1261 /* "GetWindowRect" returns the pixel coordinates of the outside of the window */
1262 GetWindowRect( fgStructure.CurrentWindow->Window.Handle, &winRect );
1264 fgStructure.CurrentWindow->Window.Handle,
1267 winRect.right - winRect.left,
1268 winRect.bottom - winRect.top,
1277 * Lowers the current window (by Z order change)
1279 void FGAPIENTRY glutPushWindow( void )
1281 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPushWindow" );
1282 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPushWindow" );
1284 #if TARGET_HOST_POSIX_X11
1286 XLowerWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1288 #elif TARGET_HOST_MS_WINDOWS
1291 fgStructure.CurrentWindow->Window.Handle,
1294 SWP_NOSIZE | SWP_NOMOVE
1301 * Raises the current window (by Z order change)
1303 void FGAPIENTRY glutPopWindow( void )
1305 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutPopWindow" );
1306 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutPopWindow" );
1308 #if TARGET_HOST_POSIX_X11
1310 XRaiseWindow( fgDisplay.Display, fgStructure.CurrentWindow->Window.Handle );
1312 #elif TARGET_HOST_MS_WINDOWS
1315 fgStructure.CurrentWindow->Window.Handle,
1318 SWP_NOSIZE | SWP_NOMOVE
1325 * Resize the current window so that it fits the whole screen
1327 void FGAPIENTRY glutFullScreen( void )
1329 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutFullScreen" );
1330 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutFullScreen" );
1332 if (glutGet(GLUT_FULL_SCREEN))
1334 /* Leave full screen state before resizing. */
1335 glutFullScreenToggle();
1339 #if TARGET_HOST_POSIX_X11
1341 Status status; /* Returned by XGetWindowAttributes(), not checked. */
1342 XWindowAttributes attributes;
1344 status = XGetWindowAttributes(fgDisplay.Display,
1345 fgStructure.CurrentWindow->Window.Handle,
1348 * The "x" and "y" members of "attributes" are the window's coordinates
1349 * relative to its parent, i.e. to the decoration window.
1351 XMoveResizeWindow(fgDisplay.Display,
1352 fgStructure.CurrentWindow->Window.Handle,
1355 fgDisplay.ScreenWidth,
1356 fgDisplay.ScreenHeight);
1358 #elif TARGET_HOST_MS_WINDOWS && !defined(_WIN32_WCE) /* FIXME: what about WinCE */
1361 /* For fullscreen mode, force the top-left corner to 0,0
1362 * and adjust the window rectangle so that the client area
1363 * covers the whole screen.
1368 rect.right = fgDisplay.ScreenWidth;
1369 rect.bottom = fgDisplay.ScreenHeight;
1371 AdjustWindowRect ( &rect, WS_OVERLAPPEDWINDOW | WS_CLIPSIBLINGS |
1372 WS_CLIPCHILDREN, FALSE );
1375 * SWP_NOACTIVATE Do not activate the window
1376 * SWP_NOOWNERZORDER Do not change position in z-order
1377 * SWP_NOSENDCHANGING Supress WM_WINDOWPOSCHANGING message
1378 * SWP_NOZORDER Retains the current Z order (ignore 2nd param)
1381 SetWindowPos( fgStructure.CurrentWindow->Window.Handle,
1385 rect.right - rect.left,
1386 rect.bottom - rect.top,
1387 SWP_NOACTIVATE | SWP_NOOWNERZORDER | SWP_NOSENDCHANGING |
1395 * Toggle the window's full screen state.
1397 void FGAPIENTRY glutFullScreenToggle( void )
1399 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutFullScreenToggle" );
1400 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutFullScreenToggle" );
1403 #if TARGET_HOST_POSIX_X11
1405 if (fgDisplay.StateFullScreen != None)
1411 xevent.type = ClientMessage;
1412 xevent.xclient.type = ClientMessage;
1413 xevent.xclient.serial = 0;
1414 xevent.xclient.send_event = True;
1415 xevent.xclient.display = fgDisplay.Display;
1416 xevent.xclient.window = fgStructure.CurrentWindow->Window.Handle;
1417 xevent.xclient.message_type = fgDisplay.State;
1418 xevent.xclient.format = 32;
1419 xevent.xclient.data.l[0] = 2; /* _NET_WM_STATE_TOGGLE */
1420 xevent.xclient.data.l[1] = fgDisplay.StateFullScreen;
1421 xevent.xclient.data.l[2] = 0;
1422 xevent.xclient.data.l[3] = 0;
1423 xevent.xclient.data.l[4] = 0;
1425 /*** Don't really understand how event masks work... ***/
1426 event_mask = SubstructureRedirectMask | SubstructureNotifyMask;
1428 status = XSendEvent(fgDisplay.Display,
1429 fgDisplay.RootWindow,
1433 FREEGLUT_INTERNAL_ERROR_EXIT(status != 0,
1434 "XSendEvent failed",
1435 "glutFullScreenToggle");
1441 * If the window manager is not Net WM compliant, fall back to legacy
1450 * A.Donev: Set and retrieve the window's user data
1452 void* FGAPIENTRY glutGetWindowData( void )
1454 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutGetWindowData" );
1455 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutGetWindowData" );
1456 return fgStructure.CurrentWindow->UserData;
1459 void FGAPIENTRY glutSetWindowData(void* data)
1461 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetWindowData" );
1462 FREEGLUT_EXIT_IF_NO_WINDOW ( "glutSetWindowData" );
1463 fgStructure.CurrentWindow->UserData = data;
1466 /*** END OF FILE ***/