4 * The windows message processing 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.
32 #define G_LOG_DOMAIN "freeglut-main"
34 #include "../include/GL/freeglut.h"
35 #include "freeglut_internal.h"
38 * TODO BEFORE THE STABLE RELEASE:
40 * There are some issues concerning window redrawing under X11, and maybe
41 * some events are not handled. The Win32 version lacks some more features,
42 * but seems acceptable for not demanding purposes.
44 * Need to investigate why the X11 version breaks out with an error when
45 * closing a window (using the window manager, not glutDestroyWindow)...
48 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
51 * Calls a window's redraw method. This is used when
52 * a redraw is forced by the incoming window messages.
55 static void fghRedrawWindowByHandle
56 #if TARGET_HOST_UNIX_X11
58 #elif TARGET_HOST_WIN32
63 * Find the window we have to redraw...
65 SFG_Window* window = fgWindowByHandle( handle );
66 freeglut_return_if_fail( window != NULL );
69 * Check if there is a display callback hooked to it
71 freeglut_return_if_fail( window->Callbacks.Display != NULL );
74 * Return if the window is not visible
76 freeglut_return_if_fail( window->State.Visible == TRUE );
79 * Set the window as the current one.
81 fgSetWindow( window );
84 * Do not exagerate with the redisplaying
86 window->State.Redisplay = FALSE;
89 * Have the callback executed now. The buffers should
90 * be swapped by the glutSwapBuffers() execution inside
91 * the callback itself.
94 window->Callbacks.Display();
98 * Handle a window configuration change. When no reshape
99 * callback is hooked, the viewport size is updated to
100 * match the new window size.
102 static void fghReshapeWindowByHandle
103 #if TARGET_HOST_UNIX_X11
104 ( Window handle, int width, int height )
105 #elif TARGET_HOST_WIN32
106 ( HWND handle, int width, int height )
110 * Find the window that received the reshape event
112 SFG_Window* window = fgWindowByHandle( handle );
113 freeglut_return_if_fail( window != NULL );
116 * Remember about setting the current window...
118 fgSetWindow( window );
121 * Check if there is a reshape callback hooked
123 if( window->Callbacks.Reshape != NULL )
126 * OKi, have it called immediately
128 window->Callbacks.Reshape( width, height );
133 * Otherwise just resize the viewport
135 glViewport( 0, 0, width, height );
139 * Force a window redraw. In Windows at least this is only a partial solution: if the
140 * window is increasing in size in either dimension, the already-drawn part does not get
141 * drawn again and things look funny. But without this we get this bad behaviour whenever
142 * we resize the window.
144 window->State.Redisplay = TRUE ;
148 * A static helper function to execute display callback for a window
150 static void fghcbDisplayWindow( SFG_Window *window, SFG_Enumerator *enumerator )
152 #if TARGET_HOST_UNIX_X11
154 * Check if there is an idle callback hooked
156 if( (window->Callbacks.Display != NULL) &&
157 (window->State.Redisplay == TRUE) &&
158 (window->State.Visible == TRUE) )
161 * OKi, this is the case: have the window set as the current one
163 fgSetWindow( window );
166 * Do not exagerate with the redisplaying
168 window->State.Redisplay = FALSE;
171 * And execute the display callback immediately after
173 window->Callbacks.Display();
176 #elif TARGET_HOST_WIN32
179 * Do we need to explicitly resize the window?
181 if( window->State.NeedToResize )
183 fgSetWindow( window );
185 fghReshapeWindowByHandle(
186 window->Window.Handle,
187 glutGet( GLUT_WINDOW_WIDTH ),
188 glutGet( GLUT_WINDOW_HEIGHT )
192 * Never ever do that again:
194 window->State.NeedToResize = FALSE;
198 * This is done in a bit different way under Windows
200 if( (window->Callbacks.Display != NULL) &&
201 (window->State.Redisplay == TRUE) &&
202 (window->State.Visible == TRUE) )
205 * Do not exagerate with the redisplaying
207 window->State.Redisplay = FALSE;
210 window->Window.Handle, NULL, NULL,
211 RDW_NOERASE | RDW_INTERNALPAINT | RDW_INVALIDATE | RDW_UPDATENOW
218 * Process this window's children (if any)
220 fgEnumSubWindows( window, fghcbDisplayWindow, enumerator );
224 * Make all windows perform a display call
226 static void fghDisplayAll( void )
228 SFG_Enumerator enumerator;
231 * Uses a method very similiar for fgWindowByHandle...
233 enumerator.found = FALSE;
234 enumerator.data = NULL;
237 * Start the enumeration now:
239 fgEnumWindows( fghcbDisplayWindow, &enumerator );
243 * Window enumerator callback to check for the joystick polling code
245 static void fghcbCheckJoystickPolls( SFG_Window *window, SFG_Enumerator *enumerator )
247 long int checkTime = fgElapsedTime();
250 * Check if actually need to do the poll for the currently enumerated window:
252 if( window->State.JoystickLastPoll + window->State.JoystickPollRate >= checkTime )
255 * Yeah, that's it. Poll the joystick...
257 fgJoystickPollWindow( window );
260 * ...and reset the polling counters:
262 window->State.JoystickLastPoll = checkTime;
266 * Process this window's children (if any)
268 fgEnumSubWindows( window, fghcbCheckJoystickPolls, enumerator );
272 * Check all windows for joystick polling
274 static void fghCheckJoystickPolls( void )
276 SFG_Enumerator enumerator;
279 * Uses a method very similiar for fgWindowByHandle...
281 enumerator.found = FALSE;
282 enumerator.data = NULL;
285 * Start the enumeration now:
287 fgEnumWindows( fghcbCheckJoystickPolls, &enumerator );
291 * Check the global timers
293 static void fghCheckTimers( void )
295 long checkTime = fgElapsedTime();
296 SFG_Timer *timer, *next;
299 fgListInit(&timedOut);
302 * For every timer that is waiting for triggering
304 for( timer = fgState.Timers.First; timer; timer = next )
306 next = timer->Node.Next;
309 * Check for the timeout:
311 if( timer->TriggerTime <= checkTime )
314 * Add the timer to the timed out timers list
316 fgListRemove( &fgState.Timers, &timer->Node );
317 fgListAppend( &timedOut, &timer->Node );
322 * Now feel free to execute all the hooked and timed out timer callbacks
323 * And delete the timed out timers...
325 while ( (timer = timedOut.First) )
327 if( timer->Callback != NULL )
328 timer->Callback( timer->ID );
329 fgListRemove( &timedOut, &timer->Node );
338 long fgElapsedTime( void )
340 #if TARGET_HOST_UNIX_X11
344 gettimeofday( &now, NULL );
346 elapsed = (now.tv_usec - fgState.Time.Value.tv_usec) / 1000;
347 elapsed += (now.tv_sec - fgState.Time.Value.tv_sec) * 1000;
350 #elif TARGET_HOST_WIN32
351 return (timeGetTime() - fgState.Time.Value);
358 void fgError( const char *fmt, ... )
364 fprintf( stderr, "freeglut: ");
365 vfprintf( stderr, fmt, ap );
366 fprintf( stderr, "\n" );
373 void fgWarning( const char *fmt, ... )
379 fprintf( stderr, "freeglut: ");
380 vfprintf( stderr, fmt, ap );
381 fprintf( stderr, "\n" );
389 static void fgCleanUpGlutsMess( void )
395 if ( fgStructure.Windows.First != NULL )
397 SFG_Window *win = fgStructure.Windows.First ;
401 while ( win != NULL )
403 SFG_Window *temp_win = win->Node.Next ;
404 fgDestroyWindow ( win, FALSE ) ;
410 /* these are pointers to external handles */
412 __glutWindowListSize = 0;
413 __glutStaleWindowList = NULL;
414 __glutWindowList = NULL;
415 __glutCurrentWindow = NULL;
417 /* make sure we no longer have a GL context */
419 if ( wglGetCurrentContext() != NULL )
421 wglDeleteContext( wglGetCurrentContext() );
424 hInstance = GetModuleHandle(NULL);
425 UnregisterClass( classname, hInstance );
427 /* clean up allocated timer memory */
429 tList = __glutTimerList;
432 while ( __glutTimerList )
435 tList = __glutTimerList;
437 if ( __glutTimerList )
438 __glutTimerList = __glutTimerList->next;
447 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
450 * Executes a single iteration in the freeglut processing loop.
452 void FGAPIENTRY glutMainLoopEvent( void )
454 #if TARGET_HOST_UNIX_X11
460 * This code was repeated constantly, so here it goes into a definition:
462 # define GETWINDOW(a) window = fgWindowByHandle( event.a.window );if( window == NULL ) break;
463 # define GETMOUSE(a) window->State.MouseX = event.a.x; window->State.MouseY = event.a.y;
466 * Make sure the display has been created etc.
468 freeglut_assert_ready;
471 * Do we have any event messages pending?
473 if( XPending( fgDisplay.Display ) )
476 * Grab the next event to be processed...
478 XNextEvent( fgDisplay.Display, &event );
481 * Check the event's type
487 * The window creation confirmation
493 * This is sent to confirm the XDestroyWindow call.
496 * Call the window closure callback, remove from the structure, etc.
498 /* fgAddToWindowDestroyList ( window, FALSE ); */
504 * Destroy the window when the WM_DELETE_WINDOW message arrives
506 if( (Atom) event.xclient.data.l[ 0 ] == fgDisplay.DeleteWindow )
508 GETWINDOW( xclient );
511 * Call the XWindows functions to close the window
513 fgCloseWindow ( window ) ;
516 * Call the window closure callback, remove from the structure, etc.
518 fgAddToWindowDestroyList ( window, FALSE );
524 * A window of ours has been unmapped...
530 * We are too dumb to process partial exposes...
532 if( event.xexpose.count == 0 )
533 fghRedrawWindowByHandle( event.xexpose.window );
536 case ConfigureNotify:
538 * The window gets resized
540 fghReshapeWindowByHandle(
541 event.xconfigure.window,
542 event.xconfigure.width,
543 event.xconfigure.height
549 * Have the client's keyboard knowledge updated (xlib.ps,
550 * page 206, says that's a good thing to do)
552 XRefreshKeyboardMapping( (XMappingEvent *) &event );
555 case VisibilityNotify:
558 * The window's visiblity might have changed
560 GETWINDOW( xvisibility );
563 * Break now if no window status callback has been hooked to that window
565 if( window->Callbacks.WindowStatus == NULL )
569 * We're going to send a callback to a window. Make it current.
571 fgSetWindow( window );
574 * Sending this event, the X server can notify us that the window has just
575 * acquired one of the three possible visibility states: VisibilityUnobscured,
576 * VisibilityPartiallyObscured or VisibilityFullyObscured
578 switch( event.xvisibility.state )
580 case VisibilityUnobscured:
582 * We are fully visible...
584 window->Callbacks.WindowStatus( GLUT_FULLY_RETAINED );
585 window->State.Visible = TRUE;
588 case VisibilityPartiallyObscured:
590 * The window is partially visible
592 window->Callbacks.WindowStatus( GLUT_PARTIALLY_RETAINED );
593 window->State.Visible = TRUE;
596 case VisibilityFullyObscured:
598 * The window is totally obscured
600 window->Callbacks.WindowStatus( GLUT_FULLY_COVERED );
601 window->State.Visible = FALSE;
610 * Mouse is over one of our windows
612 GETWINDOW( xcrossing ); GETMOUSE( xcrossing );
615 * Is there an entry callback hooked to the window?
617 if( window->Callbacks.Entry != NULL )
620 * Yeah. Notify the window about having the mouse cursor over
622 window->Callbacks.Entry( GLUT_ENTERED );
630 * Mouse is no longer over one of our windows
632 GETWINDOW( xcrossing ); GETMOUSE( xcrossing );
635 * Is there an entry callback hooked to the window?
637 if( window->Callbacks.Entry != NULL )
640 * Yeah. Notify the window about having the mouse cursor over
642 window->Callbacks.Entry( GLUT_LEFT );
650 * The mouse cursor was moved...
652 GETWINDOW( xmotion ); GETMOUSE( xmotion );
655 * Set the current window
657 fgStructure.Window = window ;
660 * What kind of a movement was it?
662 if( (event.xmotion.state & Button1Mask) || (event.xmotion.state & Button2Mask) ||
663 (event.xmotion.state & Button3Mask) || (event.xmotion.state & Button4Mask) ||
664 (event.xmotion.state & Button5Mask) )
667 * A mouse button was pressed during the movement...
668 * Is there a motion callback hooked to the window?
670 if( window->Callbacks.Motion != NULL )
673 * Yup. Have it executed immediately
675 window->Callbacks.Motion( event.xmotion.x, event.xmotion.y );
681 * Otherwise it was a passive movement...
683 if( window->Callbacks.Passive != NULL )
686 * That's right, and there is a passive callback, too.
688 window->Callbacks.Passive( event.xmotion.x, event.xmotion.y );
697 GLboolean pressed = TRUE ;
700 if ( event.type == ButtonRelease ) pressed = FALSE ;
703 * A mouse button has been pressed or released. Traditionally,
704 * break if the window was found within the freeglut structures.
706 GETWINDOW( xbutton ); GETMOUSE( xbutton );
709 * GLUT API assumes that you can't have more than three mouse buttons, so:
711 switch( event.xbutton.button )
714 * WARNING: this might be wrong, if we only have two mouse buttons,
715 * Button2 might mean the right button, isn't that right?
717 case Button1: button = GLUT_LEFT_BUTTON; break;
718 case Button2: button = GLUT_MIDDLE_BUTTON; break;
719 case Button3: button = GLUT_RIGHT_BUTTON; break;
720 default: button = -1; break;
724 * Skip the unwanted mouse buttons...
730 * Do not execute the application's mouse callback if a menu is hooked to this button.
731 * In that case an appropriate private call should be generated.
732 * Near as I can tell, this is the menu behaviour:
733 * - Down-click the menu button, menu not active: activate the menu with its upper left-hand corner at the mouse location.
734 * - Down-click any button outside the menu, menu active: deactivate the menu
735 * - Down-click any button inside the menu, menu active: select the menu entry and deactivate the menu
736 * - Up-click the menu button, menu not active: nothing happens
737 * - Up-click the menu button outside the menu, menu active: nothing happens
738 * - Up-click the menu button inside the menu, menu active: select the menu entry and deactivate the menu
740 if ( window->ActiveMenu != NULL ) /* Window has an active menu, it absorbs any mouse click */
742 if ( fgCheckActiveMenu ( window, window->ActiveMenu ) == TRUE ) /* Inside the menu, invoke the callback and deactivate the menu*/
744 /* Save the current window and menu and set the current window to the window whose menu this is */
745 SFG_Window *save_window = fgStructure.Window ;
746 SFG_Menu *save_menu = fgStructure.Menu ;
747 fgSetWindow ( window ) ;
748 fgStructure.Menu = window->ActiveMenu ;
750 /* Execute the menu callback */
751 fgExecuteMenuCallback ( window->ActiveMenu ) ;
752 fgDeactivateMenu ( window ) ;
754 /* Restore the current window and menu */
755 fgSetWindow ( save_window ) ;
756 fgStructure.Menu = save_menu ;
758 else /* Outside the menu, deactivate the menu if it's a downclick */
760 if ( pressed == TRUE ) fgDeactivateMenu ( window ) ;
764 * Let's make the window redraw as a result of the mouse click and menu activity.
766 window->State.Redisplay = TRUE ;
772 * No active menu, let's check whether we need to activate one.
774 if ( ( window->Menu[ button ] != NULL ) && ( pressed == TRUE ) )
777 * Let's make the window redraw as a result of the mouse click.
779 window->State.Redisplay = TRUE ;
782 * Activate the appropriate menu structure...
784 fgActivateMenu( window, button );
790 * Check if there is a mouse callback hooked to the window
792 if( window->Callbacks.Mouse == NULL )
796 * Set the current window
798 fgSetWindow( window );
801 * Remember the current modifiers state
804 if (event.xbutton.state & (ShiftMask|LockMask))
805 modifiers |= GLUT_ACTIVE_SHIFT;
806 if (event.xbutton.state & ControlMask)
807 modifiers |= GLUT_ACTIVE_CTRL;
808 if (event.xbutton.state & Mod1Mask)
809 modifiers |= GLUT_ACTIVE_ALT;
810 window->State.Modifiers = modifiers;
813 * Finally execute the mouse callback
815 window->Callbacks.Mouse(
817 event.type == ButtonPress ? GLUT_DOWN : GLUT_UP,
823 * Trash the modifiers state
825 window->State.Modifiers = 0xffffffff;
832 FGCBkeyboard keyboard_cb;
833 FGCBspecial special_cb;
836 * A key has been pressed, find the window that had the focus:
838 GETWINDOW( xkey ); GETMOUSE( xkey );
840 if( event.type == KeyPress )
842 keyboard_cb = window->Callbacks.Keyboard;
843 special_cb = window->Callbacks.Special;
847 keyboard_cb = window->Callbacks.KeyboardUp;
848 special_cb = window->Callbacks.SpecialUp;
852 * Is there a keyboard/special callback hooked for this window?
854 if( (keyboard_cb != NULL) || (special_cb != NULL) )
856 XComposeStatus composeStatus;
857 char asciiCode[ 32 ];
862 * Check for the ASCII/KeySym codes associated with the event:
864 len = XLookupString( &event.xkey, asciiCode, sizeof(asciiCode), &keySym, &composeStatus );
867 * Get ready to calling the keyboard/special callbacks
869 fgSetWindow( window );
872 * GLUT API tells us to have two separate callbacks...
877 * ...one for the ASCII translateable keypresses...
879 if( keyboard_cb != NULL )
882 * Remember the current modifiers state
885 if (event.xkey.state & (ShiftMask|LockMask))
886 modifiers |= GLUT_ACTIVE_SHIFT;
887 if (event.xkey.state & ControlMask)
888 modifiers |= GLUT_ACTIVE_CTRL;
889 if (event.xkey.state & Mod1Mask)
890 modifiers |= GLUT_ACTIVE_ALT;
891 window->State.Modifiers = modifiers;
894 * Execute the callback
896 keyboard_cb( asciiCode[ 0 ], event.xkey.x, event.xkey.y );
899 * Trash the modifiers state
901 window->State.Modifiers = 0xffffffff;
909 * ...and one for all the others, which need to be translated to GLUT_KEY_Xs...
914 * First the function keys come:
916 case XK_F1: special = GLUT_KEY_F1; break;
917 case XK_F2: special = GLUT_KEY_F2; break;
918 case XK_F3: special = GLUT_KEY_F3; break;
919 case XK_F4: special = GLUT_KEY_F4; break;
920 case XK_F5: special = GLUT_KEY_F5; break;
921 case XK_F6: special = GLUT_KEY_F6; break;
922 case XK_F7: special = GLUT_KEY_F7; break;
923 case XK_F8: special = GLUT_KEY_F8; break;
924 case XK_F9: special = GLUT_KEY_F9; break;
925 case XK_F10: special = GLUT_KEY_F10; break;
926 case XK_F11: special = GLUT_KEY_F11; break;
927 case XK_F12: special = GLUT_KEY_F12; break;
930 * Then the arrows and stuff:
932 case XK_Left: special = GLUT_KEY_LEFT; break;
933 case XK_Right: special = GLUT_KEY_RIGHT; break;
934 case XK_Up: special = GLUT_KEY_UP; break;
935 case XK_Down: special = GLUT_KEY_DOWN; break;
938 case XK_Prior: special = GLUT_KEY_PAGE_UP; break;
940 case XK_Next: special = GLUT_KEY_PAGE_DOWN; break;
942 case XK_Home: special = GLUT_KEY_HOME; break;
944 case XK_End: special = GLUT_KEY_END; break;
946 case XK_Insert: special = GLUT_KEY_INSERT; break;
950 * Execute the callback (if one has been specified),
951 * given that the special code seems to be valid...
953 if( (special_cb != NULL) && (special != -1) )
956 * Remember the current modifiers state
959 if (event.xkey.state & (ShiftMask|LockMask))
960 modifiers |= GLUT_ACTIVE_SHIFT;
961 if (event.xkey.state & ControlMask)
962 modifiers |= GLUT_ACTIVE_CTRL;
963 if (event.xkey.state & Mod1Mask)
964 modifiers |= GLUT_ACTIVE_ALT;
965 window->State.Modifiers = modifiers;
967 special_cb( special, event.xkey.x, event.xkey.y );
970 * Trash the modifiers state
972 window->State.Modifiers = 0xffffffff;
983 * Have all the timers checked.
988 * Poll the joystick and notify all windows that want to be notified...
990 fghCheckJoystickPolls();
993 * No messages in the queue, which means we are idling...
995 if( fgState.IdleCallback != NULL )
996 fgState.IdleCallback();
999 * Remember about displaying all the windows that have
1000 * been marked for a redisplay (possibly in the idle call):
1005 #elif TARGET_HOST_WIN32
1010 * The windows processing is considerably smaller
1012 if( PeekMessage( &stMsg, NULL, 0, 0, PM_NOREMOVE ) )
1015 * Grab the message now, checking for WM_QUIT
1017 if( GetMessage( &stMsg, NULL, 0, 0 ) == 0 )
1018 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1021 * Translate virtual-key messages and send them to the window...
1023 TranslateMessage( &stMsg );
1024 DispatchMessage( &stMsg );
1029 * Have all the timers checked.
1034 * Poll the joystick and notify all windows that want to be notified...
1036 fghCheckJoystickPolls();
1039 * No messages in the queue, which means we are idling...
1041 if( fgState.IdleCallback != NULL )
1042 fgState.IdleCallback();
1045 * Remember about displaying all the windows that have
1046 * been marked for a redisplay (possibly in the idle call):
1053 * If an event caused a window to be closed, do the actual closing here
1059 * Enters the freeglut processing loop. Stays until the "ExecState" changes to "GLUT_EXEC_STATE_STOP".
1061 void FGAPIENTRY glutMainLoop( void )
1063 #if TARGET_HOST_WIN32
1064 SFG_Window *window = fgStructure.Windows.First ;
1068 * Make sure the display has been created etc.
1070 freeglut_assert_ready;
1072 #if TARGET_HOST_WIN32
1074 * Processing before the main loop: If there is a window which is open and which
1075 * has a visibility callback, call it. I know this is an ugly hack, but I'm not sure
1076 * what else to do about it. Ideally we should leave something uninitialized in the
1077 * create window code and initialize it in the main loop, and have that initialization
1078 * create a "WM_ACTIVATE" message. Then we would put the visibility callback code in
1079 * the "case WM_ACTIVATE" block below. - John Fay -- 10/24/02
1081 while ( window != NULL )
1083 if ( window->Callbacks.Visibility != NULL )
1084 window->Callbacks.Visibility ( window->State.Visible ) ;
1086 window = window->Node.Next ;
1091 * Set freeglut to be running
1093 fgState.ExecState = GLUT_EXEC_STATE_RUNNING ;
1096 * Enter the main loop itself. Inside the loop, process events and check for loop exit.
1098 while ( fgState.ExecState == GLUT_EXEC_STATE_RUNNING )
1100 glutMainLoopEvent () ;
1103 * If there are no more windows open, stop execution
1105 if ( fgStructure.Windows.First == NULL )
1106 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1111 * If we got here by the user closing a window or by the application closing down, there may still be windows open.
1113 fgCleanUpGlutsMess () ;
1116 * Check whether we return to the calling program or simply exit
1118 if ( fgState.ActionOnWindowClose == GLUT_ACTION_EXIT )
1122 * When this loop terminates, destroy the display, state and structure
1123 * of a freeglut session, so that another glutInit() call can happen
1129 * Leaves the freeglut processing loop.
1131 void FGAPIENTRY glutLeaveMainLoop( void )
1133 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1137 * The window procedure for handling Win32 events
1139 #if TARGET_HOST_WIN32
1140 LRESULT CALLBACK fgWindowProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam )
1142 SFG_Window* window = fgWindowByHandle( hWnd );
1146 if ( ( window == NULL ) && ( uMsg != WM_CREATE ) )
1147 return( DefWindowProc( hWnd, uMsg, wParam, lParam ) );
1149 /* printf ( "Window %3d message <%04x> %12d %12d\n", window?window->ID:0, uMsg, wParam, lParam ) ; */
1151 * Check what type of message are we receiving
1157 * The window structure is passed as the creation structure paramter...
1159 window = (SFG_Window *) (((LPCREATESTRUCT) lParam)->lpCreateParams);
1160 assert( window != NULL );
1163 * We can safely store the window's handle now:
1165 window->Window.Handle = hWnd;
1168 * Get the window's device context
1170 window->Window.Device = GetDC( hWnd );
1173 * Setup the pixel format of our window
1175 fgSetupPixelFormat( window, FALSE, PFD_MAIN_PLANE );
1178 * Create or get the OpenGL rendering context now
1180 if ( fgState.UseCurrentContext == TRUE )
1181 window->Window.Context = wglGetCurrentContext();
1183 window->Window.Context = wglCreateContext( window->Window.Device );
1186 * Still, we'll be needing to explicitly resize the window
1188 window->State.NeedToResize = TRUE;
1191 * Finally, have the window's device context released
1193 ReleaseDC( window->Window.Handle, window->Window.Device );
1198 * We got resized... But check if the window has been already added...
1200 fghReshapeWindowByHandle( hWnd, LOWORD(lParam), HIWORD(lParam) );
1204 printf("WM_SETFOCUS: %p\n", window );
1205 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1209 if (LOWORD(wParam) != WA_INACTIVE)
1211 /* glutSetCursor( fgStructure.Window->State.Cursor ); */
1212 printf("WM_ACTIVATE: glutSetCursor( %p, %d)\n", window, window->State.Cursor );
1214 glutSetCursor( window->State.Cursor );
1217 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1223 * Windows seems to need reminding to erase the cursor for NONE.
1226 if ((LOWORD(lParam) == HTCLIENT) &&
1227 (fgStructure.Window->State.Cursor == GLUT_CURSOR_NONE))
1230 /* Set the cursor AND change it for this window class. */
1231 # define MAP_CURSOR(a,b) case a: SetCursor( LoadCursor( NULL, b ) ); \
1233 /* Nuke the cursor AND change it for this window class. */
1234 # define ZAP_CURSOR(a,b) case a: SetCursor( NULL ); \
1237 if (LOWORD(lParam) == HTCLIENT)
1238 switch( window->State.Cursor )
1240 MAP_CURSOR( GLUT_CURSOR_RIGHT_ARROW, IDC_ARROW );
1241 MAP_CURSOR( GLUT_CURSOR_LEFT_ARROW, IDC_ARROW );
1242 MAP_CURSOR( GLUT_CURSOR_INFO, IDC_HELP );
1243 MAP_CURSOR( GLUT_CURSOR_DESTROY, IDC_CROSS );
1244 MAP_CURSOR( GLUT_CURSOR_HELP, IDC_HELP );
1245 MAP_CURSOR( GLUT_CURSOR_CYCLE, IDC_SIZEALL );
1246 MAP_CURSOR( GLUT_CURSOR_SPRAY, IDC_CROSS );
1247 MAP_CURSOR( GLUT_CURSOR_WAIT, IDC_WAIT );
1248 MAP_CURSOR( GLUT_CURSOR_TEXT, IDC_UPARROW );
1249 MAP_CURSOR( GLUT_CURSOR_CROSSHAIR, IDC_CROSS );
1250 /* MAP_CURSOR( GLUT_CURSOR_NONE, IDC_NO ); */
1251 ZAP_CURSOR( GLUT_CURSOR_NONE, NULL );
1254 MAP_CURSOR( GLUT_CURSOR_UP_DOWN, IDC_ARROW );
1258 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1263 * We are now Visible!
1265 window->State.Visible = TRUE;
1266 window->State.Redisplay = TRUE;
1271 * Start the painting job
1274 BeginPaint( hWnd, &ps );
1277 * Call the engine's main frame drawing method
1279 fghRedrawWindowByHandle( hWnd );
1282 * End the painting job, release the device context
1284 EndPaint( hWnd, &ps );
1289 * Make sure we don't close a window with current context active
1291 if( fgStructure.Window == window )
1296 wglMakeCurrent( NULL, NULL );
1297 /* Step through the list of windows. If the rendering context is notbeing used
1298 * by another window, then we delete it.
1300 for ( iter = fgStructure.Windows.First; iter; iter = iter->Node.Next )
1302 if ( ( iter->Window.Context == window->Window.Context ) && ( iter != window ) )
1306 if ( used == FALSE ) wglDeleteContext( window->Window.Context );
1310 * Put on a linked list of windows to be removed after all the callbacks have returned
1312 fgAddToWindowDestroyList ( window, FALSE ) ;
1315 * Proceed with the window destruction
1317 DestroyWindow( hWnd );
1322 * The window already got destroyed, so don't bother with it.
1329 * The mouse cursor has moved. Remember the new mouse cursor's position
1331 window->State.MouseX = LOWORD( lParam );
1332 window->State.MouseY = HIWORD( lParam );
1335 * Fallback if there's an active menu hooked to this window
1337 if( window->ActiveMenu != NULL )
1340 * Let's make the window redraw as a result of the mouse motion.
1342 window->State.Redisplay = TRUE ;
1348 * Remember the current modifiers state.
1350 window->State.Modifiers =
1351 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1352 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1353 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1356 * Check if any of the mouse buttons is pressed...
1358 if( (wParam & MK_LBUTTON) || (wParam & MK_MBUTTON) || (wParam & MK_RBUTTON) )
1361 * Yeah, indeed. We need to use the motion callback then:
1363 if( window->Callbacks.Motion != NULL )
1366 * Make sure the current window is set...
1368 fgSetWindow( window );
1371 * Execute the active mouse motion callback now
1373 window->Callbacks.Motion( window->State.MouseX, window->State.MouseY );
1379 * All mouse buttons are up, execute the passive mouse motion callback
1381 if( window->Callbacks.Passive != NULL )
1384 * Make sure the current window is set
1386 fgSetWindow( window );
1389 * Execute the passive mouse motion callback
1391 window->Callbacks.Passive( window->State.MouseX, window->State.MouseY );
1396 * Thrash the current modifiers state now
1398 window->State.Modifiers = 0xffffffff;
1402 case WM_LBUTTONDOWN:
1403 case WM_MBUTTONDOWN:
1404 case WM_RBUTTONDOWN:
1409 GLboolean pressed = TRUE;
1413 * The mouse cursor has moved. Remember the new mouse cursor's position
1415 window->State.MouseX = LOWORD( lParam );
1416 window->State.MouseY = HIWORD( lParam );
1419 * We're curious about the GLUT API button name...
1423 case WM_LBUTTONDOWN: pressed = TRUE; button = GLUT_LEFT_BUTTON; break;
1424 case WM_MBUTTONDOWN: pressed = TRUE; button = GLUT_MIDDLE_BUTTON; break;
1425 case WM_RBUTTONDOWN: pressed = TRUE; button = GLUT_RIGHT_BUTTON; break;
1426 case WM_LBUTTONUP: pressed = FALSE; button = GLUT_LEFT_BUTTON; break;
1427 case WM_MBUTTONUP: pressed = FALSE; button = GLUT_MIDDLE_BUTTON; break;
1428 case WM_RBUTTONUP: pressed = FALSE; button = GLUT_RIGHT_BUTTON; break;
1429 default: pressed = FALSE; button = -1; break;
1433 * The left and right mouse buttons might have been swapped...
1435 if( GetSystemMetrics( SM_SWAPBUTTON ) )
1436 if( button == GLUT_LEFT_BUTTON ) button = GLUT_RIGHT_BUTTON;
1437 else if( button == GLUT_RIGHT_BUTTON ) button = GLUT_LEFT_BUTTON;
1440 * Hey, what's up with you?
1443 return( DefWindowProc( hWnd, uMsg, lParam, wParam ) );
1446 * Do not execute the application's mouse callback if a menu is hooked to this button.
1447 * In that case an appropriate private call should be generated.
1448 * Near as I can tell, this is the menu behaviour:
1449 * - Down-click the menu button, menu not active: activate the menu with its upper left-hand corner at the mouse location.
1450 * - Down-click any button outside the menu, menu active: deactivate the menu
1451 * - Down-click any button inside the menu, menu active: select the menu entry and deactivate the menu
1452 * - Up-click the menu button, menu not active: nothing happens
1453 * - Up-click the menu button outside the menu, menu active: nothing happens
1454 * - Up-click the menu button inside the menu, menu active: select the menu entry and deactivate the menu
1456 if ( window->ActiveMenu != NULL ) /* Window has an active menu, it absorbs any mouse click */
1458 if ( fgCheckActiveMenu ( window, window->ActiveMenu ) == TRUE ) /* Inside the menu, invoke the callback and deactivate the menu*/
1460 /* Save the current window and menu and set the current window to the window whose menu this is */
1461 SFG_Window *save_window = fgStructure.Window ;
1462 SFG_Menu *save_menu = fgStructure.Menu ;
1463 fgSetWindow ( window ) ;
1464 fgStructure.Menu = window->ActiveMenu ;
1466 /* Execute the menu callback */
1467 fgExecuteMenuCallback ( window->ActiveMenu ) ;
1468 fgDeactivateMenu ( window ) ;
1470 /* Restore the current window and menu */
1471 fgSetWindow ( save_window ) ;
1472 fgStructure.Menu = save_menu ;
1474 else /* Outside the menu, deactivate the menu if it's a downclick */
1476 if ( pressed == TRUE ) fgDeactivateMenu ( window ) ;
1480 * Let's make the window redraw as a result of the mouse click and menu activity.
1482 window->State.Redisplay = TRUE ;
1488 * No active menu, let's check whether we need to activate one.
1490 if ( ( window->Menu[ button ] != NULL ) && ( pressed == TRUE ) )
1493 * Let's make the window redraw as a result of the mouse click.
1495 window->State.Redisplay = TRUE ;
1498 * Activate the appropriate menu structure...
1500 fgActivateMenu( window, button );
1506 * Check if there is a mouse callback hooked to the window
1508 if( window->Callbacks.Mouse == NULL )
1512 * Set the current window
1514 fgSetWindow( window );
1517 * Remember the current modifiers state.
1519 window->State.Modifiers =
1520 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1521 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1522 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1525 * Finally execute the mouse callback
1527 window->Callbacks.Mouse(
1529 pressed == TRUE ? GLUT_DOWN : GLUT_UP,
1530 window->State.MouseX,
1531 window->State.MouseY
1535 * Trash the modifiers state
1537 window->State.Modifiers = 0xffffffff;
1548 * Ignore the automatic key repetition if needed:
1550 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1554 * Set the current window
1556 fgSetWindow( window );
1559 * Remember the current modifiers state. This is done here in order
1560 * to make sure the VK_DELETE keyboard callback is executed properly.
1562 window->State.Modifiers =
1563 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1564 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1565 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1568 * Set the mouse position
1570 GetCursorPos ( &mouse_pos ) ;
1571 ScreenToClient ( window->Window.Handle, &mouse_pos ) ;
1573 window->State.MouseX = mouse_pos.x ;
1574 window->State.MouseY = mouse_pos.y ;
1577 * Convert the Win32 keystroke codes to GLUTtish way
1579 # define KEY(a,b) case a: keypress = b; break;
1584 * Most of the special characters can be handled automagically...
1586 KEY( VK_F1, GLUT_KEY_F1 ); KEY( VK_F2, GLUT_KEY_F2 );
1587 KEY( VK_F3, GLUT_KEY_F3 ); KEY( VK_F4, GLUT_KEY_F4 );
1588 KEY( VK_F5, GLUT_KEY_F5 ); KEY( VK_F6, GLUT_KEY_F6 );
1589 KEY( VK_F7, GLUT_KEY_F7 ); KEY( VK_F8, GLUT_KEY_F8 );
1590 KEY( VK_F9, GLUT_KEY_F9 ); KEY( VK_F10, GLUT_KEY_F10 );
1591 KEY( VK_F11, GLUT_KEY_F11 ); KEY( VK_F12, GLUT_KEY_F12 );
1592 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP ); KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1593 KEY( VK_HOME, GLUT_KEY_HOME ); KEY( VK_END, GLUT_KEY_END );
1594 KEY( VK_LEFT, GLUT_KEY_LEFT ); KEY( VK_UP, GLUT_KEY_UP );
1595 KEY( VK_RIGHT, GLUT_KEY_RIGHT ); KEY( VK_DOWN, GLUT_KEY_DOWN );
1596 KEY( VK_INSERT, GLUT_KEY_INSERT );
1599 * ...yet there is a small exception we need to have handled...
1603 * The delete key should be treated as an ASCII keypress:
1605 if( window->Callbacks.Keyboard != NULL )
1606 window->Callbacks.Keyboard( 127, window->State.MouseX, window->State.MouseY );
1610 * Execute the special callback, if present, given the conversion was a success:
1612 if( (keypress != -1) && (window->Callbacks.Special != NULL) )
1615 * Have the special callback executed:
1617 window->Callbacks.Special( keypress, window->State.MouseX, window->State.MouseY );
1621 * Thrash the modifiers register now
1623 window->State.Modifiers = 0xffffffff;
1634 * Set the current window
1636 fgSetWindow( window );
1639 * Remember the current modifiers state. This is done here in order
1640 * to make sure the VK_DELETE keyboard callback is executed properly.
1642 window->State.Modifiers =
1643 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1644 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1645 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1648 * Set the mouse position
1650 GetCursorPos ( &mouse_pos ) ;
1651 ScreenToClient ( window->Window.Handle, &mouse_pos ) ;
1653 window->State.MouseX = mouse_pos.x ;
1654 window->State.MouseY = mouse_pos.y ;
1657 * Convert the Win32 keystroke codes to GLUTtish way. "KEY(a,b)" was defined under "WM_KEYDOWN"
1663 * Most of the special characters can be handled automagically...
1665 KEY( VK_F1, GLUT_KEY_F1 ); KEY( VK_F2, GLUT_KEY_F2 );
1666 KEY( VK_F3, GLUT_KEY_F3 ); KEY( VK_F4, GLUT_KEY_F4 );
1667 KEY( VK_F5, GLUT_KEY_F5 ); KEY( VK_F6, GLUT_KEY_F6 );
1668 KEY( VK_F7, GLUT_KEY_F7 ); KEY( VK_F8, GLUT_KEY_F8 );
1669 KEY( VK_F9, GLUT_KEY_F9 ); KEY( VK_F10, GLUT_KEY_F10 );
1670 KEY( VK_F11, GLUT_KEY_F11 ); KEY( VK_F12, GLUT_KEY_F12 );
1671 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP ); KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1672 KEY( VK_HOME, GLUT_KEY_HOME ); KEY( VK_END, GLUT_KEY_END );
1673 KEY( VK_LEFT, GLUT_KEY_LEFT ); KEY( VK_UP, GLUT_KEY_UP );
1674 KEY( VK_RIGHT, GLUT_KEY_RIGHT ); KEY( VK_DOWN, GLUT_KEY_DOWN );
1675 KEY( VK_INSERT, GLUT_KEY_INSERT );
1678 * ...yet there is a small exception we need to have handled...
1682 * The delete key should be treated as an ASCII keypress:
1684 if( window->Callbacks.KeyboardUp != NULL )
1685 window->Callbacks.KeyboardUp( 127, window->State.MouseX, window->State.MouseY );
1691 * Call the KeyboardUp callback for a regular character if there is one.
1696 GetKeyboardState(state);
1698 if ( ToAscii( wParam, 0, state, code, 0 ) == 1 )
1701 if( window->Callbacks.KeyboardUp != NULL )
1702 window->Callbacks.KeyboardUp( (char)wParam, window->State.MouseX, window->State.MouseY );
1707 * Execute the special callback, if present, given the conversion was a success:
1709 if( (keypress != -1) && (window->Callbacks.SpecialUp != NULL) )
1712 * Have the special callback executed:
1714 window->Callbacks.SpecialUp( keypress, window->State.MouseX, window->State.MouseY );
1718 * Thrash the modifiers register now
1720 window->State.Modifiers = 0xffffffff;
1728 * Ignore the automatic key repetition if needed:
1730 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1734 * Clear to go with the keyboard callback, if registered:
1736 if( window->Callbacks.Keyboard != NULL )
1739 * Remember the current modifiers state
1741 window->State.Modifiers =
1742 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1743 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1744 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1747 * Have the special callback executed:
1749 window->Callbacks.Keyboard( (char)wParam, window->State.MouseX, window->State.MouseY );
1752 * Thrash the modifiers register now
1754 window->State.Modifiers = 0xffffffff;
1759 case WM_CAPTURECHANGED : /* User has finished resizing the window, force a redraw */
1760 if ( window->Callbacks.Display )
1761 window->Callbacks.Display () ;
1763 /* lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ) ; */
1767 * Other messages that I have seen and which are not handled already
1769 case WM_SETTEXT : /* 0x000c */
1770 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Pass it on to "DefWindowProc" to set the window text */
1773 case WM_GETTEXT : /* 0x000d */
1774 /* Ideally we would copy the title of the window into "lParam" */
1775 /* strncpy ( (char *)lParam, "Window Title", wParam ) ;
1776 lRet = ( wParam > 12 ) ? 12 : wParam ; */ /* the number of characters copied */
1777 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1780 case WM_GETTEXTLENGTH : /* 0x000e */
1781 /* Ideally we would get the length of the title of the window */
1782 lRet = 12 ; /* the number of characters in "Window Title\0" (see above) */
1785 case WM_ERASEBKGND : /* 0x0014 */
1786 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1789 case WM_SYNCPAINT : /* 0x0088 */
1790 /* Another window has moved, need to update this one */
1791 window->State.Redisplay = TRUE ;
1792 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Help screen says this message must be passed to "DefWindowProc" */
1795 case WM_NCPAINT : /* 0x0085 */
1796 /* Need to update the border of this window */
1797 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Pass it on to "DefWindowProc" to repaint a standard border */
1802 * Handle unhandled messages
1804 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1812 /*** END OF FILE ***/