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 * Fallback if there's an active menu hooked to this window
657 if( window->ActiveMenu != NULL )
660 * Let's make the window redraw as a result of the mouse motion.
662 window->State.Redisplay = TRUE ;
668 * What kind of a movement was it?
670 if( (event.xmotion.state & Button1Mask) || (event.xmotion.state & Button2Mask) ||
671 (event.xmotion.state & Button3Mask) || (event.xmotion.state & Button4Mask) ||
672 (event.xmotion.state & Button5Mask) )
675 * A mouse button was pressed during the movement...
676 * Is there a motion callback hooked to the window?
678 if( window->Callbacks.Motion != NULL )
681 * Set the current window
683 fgStructure.Window = window ;
686 * Yup. Have it executed immediately
688 window->Callbacks.Motion( event.xmotion.x, event.xmotion.y );
694 * Otherwise it was a passive movement...
696 if( window->Callbacks.Passive != NULL )
699 * Set the current window
701 fgStructure.Window = window ;
704 * That's right, and there is a passive callback, too.
706 window->Callbacks.Passive( event.xmotion.x, event.xmotion.y );
715 GLboolean pressed = TRUE ;
718 if ( event.type == ButtonRelease ) pressed = FALSE ;
721 * A mouse button has been pressed or released. Traditionally,
722 * break if the window was found within the freeglut structures.
724 GETWINDOW( xbutton ); GETMOUSE( xbutton );
727 * GLUT API assumes that you can't have more than three mouse buttons, so:
729 switch( event.xbutton.button )
732 * WARNING: this might be wrong, if we only have two mouse buttons,
733 * Button2 might mean the right button, isn't that right?
735 case Button1: button = GLUT_LEFT_BUTTON; break;
736 case Button2: button = GLUT_MIDDLE_BUTTON; break;
737 case Button3: button = GLUT_RIGHT_BUTTON; break;
738 default: button = -1; break;
742 * Skip the unwanted mouse buttons...
748 * Do not execute the application's mouse callback if a menu is hooked to this button.
749 * In that case an appropriate private call should be generated.
750 * Near as I can tell, this is the menu behaviour:
751 * - Down-click the menu button, menu not active: activate the menu with its upper left-hand corner at the mouse location.
752 * - Down-click any button outside the menu, menu active: deactivate the menu
753 * - Down-click any button inside the menu, menu active: select the menu entry and deactivate the menu
754 * - Up-click the menu button, menu not active: nothing happens
755 * - Up-click the menu button outside the menu, menu active: nothing happens
756 * - Up-click the menu button inside the menu, menu active: select the menu entry and deactivate the menu
758 if ( window->ActiveMenu != NULL ) /* Window has an active menu, it absorbs any mouse click */
760 if ( fgCheckActiveMenu ( window, window->ActiveMenu ) == TRUE ) /* Inside the menu, invoke the callback and deactivate the menu*/
762 /* Save the current window and menu and set the current window to the window whose menu this is */
763 SFG_Window *save_window = fgStructure.Window ;
764 SFG_Menu *save_menu = fgStructure.Menu ;
765 fgSetWindow ( window ) ;
766 fgStructure.Menu = window->ActiveMenu ;
768 /* Execute the menu callback */
769 fgExecuteMenuCallback ( window->ActiveMenu ) ;
770 fgDeactivateMenu ( window->ActiveMenu->ParentWindow ) ;
772 /* Restore the current window and menu */
773 fgSetWindow ( save_window ) ;
774 fgStructure.Menu = save_menu ;
776 else /* Outside the menu, deactivate the menu if it's a downclick */
778 if ( pressed == TRUE ) fgDeactivateMenu ( window->ActiveMenu->ParentWindow ) ;
782 * Let's make the window redraw as a result of the mouse click and menu activity.
784 window->State.Redisplay = TRUE ;
790 * No active menu, let's check whether we need to activate one.
792 if ( ( window->Menu[ button ] != NULL ) && ( pressed == TRUE ) )
795 * Let's make the window redraw as a result of the mouse click.
797 window->State.Redisplay = TRUE ;
800 * Set the current window
802 fgSetWindow( window );
805 * Activate the appropriate menu structure...
807 fgActivateMenu( window, button );
813 * Check if there is a mouse callback hooked to the window
815 if( fgStructure.Window->Callbacks.Mouse == NULL )
819 * Remember the current modifiers state
822 if (event.xbutton.state & (ShiftMask|LockMask))
823 modifiers |= GLUT_ACTIVE_SHIFT;
824 if (event.xbutton.state & ControlMask)
825 modifiers |= GLUT_ACTIVE_CTRL;
826 if (event.xbutton.state & Mod1Mask)
827 modifiers |= GLUT_ACTIVE_ALT;
828 fgStructure.Window->State.Modifiers = modifiers;
831 * Finally execute the mouse callback
833 fgStructure.Window->Callbacks.Mouse(
835 event.type == ButtonPress ? GLUT_DOWN : GLUT_UP,
841 * Trash the modifiers state
843 fgStructure.Window->State.Modifiers = 0xffffffff;
850 FGCBkeyboard keyboard_cb;
851 FGCBspecial special_cb;
854 * A key has been pressed, find the window that had the focus:
856 GETWINDOW( xkey ); GETMOUSE( xkey );
858 if( event.type == KeyPress )
860 keyboard_cb = window->Callbacks.Keyboard;
861 special_cb = window->Callbacks.Special;
865 keyboard_cb = window->Callbacks.KeyboardUp;
866 special_cb = window->Callbacks.SpecialUp;
870 * Is there a keyboard/special callback hooked for this window?
872 if( (keyboard_cb != NULL) || (special_cb != NULL) )
874 XComposeStatus composeStatus;
875 char asciiCode[ 32 ];
880 * Check for the ASCII/KeySym codes associated with the event:
882 len = XLookupString( &event.xkey, asciiCode, sizeof(asciiCode), &keySym, &composeStatus );
885 * Get ready to calling the keyboard/special callbacks
887 fgSetWindow( window );
890 * GLUT API tells us to have two separate callbacks...
895 * ...one for the ASCII translateable keypresses...
897 if( keyboard_cb != NULL )
900 * Remember the current modifiers state
903 if (event.xkey.state & (ShiftMask|LockMask))
904 modifiers |= GLUT_ACTIVE_SHIFT;
905 if (event.xkey.state & ControlMask)
906 modifiers |= GLUT_ACTIVE_CTRL;
907 if (event.xkey.state & Mod1Mask)
908 modifiers |= GLUT_ACTIVE_ALT;
909 window->State.Modifiers = modifiers;
912 * Execute the callback
914 keyboard_cb( asciiCode[ 0 ], event.xkey.x, event.xkey.y );
917 * Trash the modifiers state
919 window->State.Modifiers = 0xffffffff;
927 * ...and one for all the others, which need to be translated to GLUT_KEY_Xs...
932 * First the function keys come:
934 case XK_F1: special = GLUT_KEY_F1; break;
935 case XK_F2: special = GLUT_KEY_F2; break;
936 case XK_F3: special = GLUT_KEY_F3; break;
937 case XK_F4: special = GLUT_KEY_F4; break;
938 case XK_F5: special = GLUT_KEY_F5; break;
939 case XK_F6: special = GLUT_KEY_F6; break;
940 case XK_F7: special = GLUT_KEY_F7; break;
941 case XK_F8: special = GLUT_KEY_F8; break;
942 case XK_F9: special = GLUT_KEY_F9; break;
943 case XK_F10: special = GLUT_KEY_F10; break;
944 case XK_F11: special = GLUT_KEY_F11; break;
945 case XK_F12: special = GLUT_KEY_F12; break;
948 * Then the arrows and stuff:
950 case XK_Left: special = GLUT_KEY_LEFT; break;
951 case XK_Right: special = GLUT_KEY_RIGHT; break;
952 case XK_Up: special = GLUT_KEY_UP; break;
953 case XK_Down: special = GLUT_KEY_DOWN; break;
956 case XK_Prior: special = GLUT_KEY_PAGE_UP; break;
958 case XK_Next: special = GLUT_KEY_PAGE_DOWN; break;
960 case XK_Home: special = GLUT_KEY_HOME; break;
962 case XK_End: special = GLUT_KEY_END; break;
964 case XK_Insert: special = GLUT_KEY_INSERT; break;
968 * Execute the callback (if one has been specified),
969 * given that the special code seems to be valid...
971 if( (special_cb != NULL) && (special != -1) )
974 * Remember the current modifiers state
977 if (event.xkey.state & (ShiftMask|LockMask))
978 modifiers |= GLUT_ACTIVE_SHIFT;
979 if (event.xkey.state & ControlMask)
980 modifiers |= GLUT_ACTIVE_CTRL;
981 if (event.xkey.state & Mod1Mask)
982 modifiers |= GLUT_ACTIVE_ALT;
983 window->State.Modifiers = modifiers;
985 special_cb( special, event.xkey.x, event.xkey.y );
988 * Trash the modifiers state
990 window->State.Modifiers = 0xffffffff;
1001 * Have all the timers checked.
1006 * Poll the joystick and notify all windows that want to be notified...
1008 fghCheckJoystickPolls();
1011 * No messages in the queue, which means we are idling...
1013 if( fgState.IdleCallback != NULL )
1014 fgState.IdleCallback();
1017 * Remember about displaying all the windows that have
1018 * been marked for a redisplay (possibly in the idle call):
1023 #elif TARGET_HOST_WIN32
1028 * The windows processing is considerably smaller
1030 if( PeekMessage( &stMsg, NULL, 0, 0, PM_NOREMOVE ) )
1033 * Grab the message now, checking for WM_QUIT
1035 if( GetMessage( &stMsg, NULL, 0, 0 ) == 0 )
1036 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1039 * Translate virtual-key messages and send them to the window...
1041 TranslateMessage( &stMsg );
1042 DispatchMessage( &stMsg );
1047 * Have all the timers checked.
1052 * Poll the joystick and notify all windows that want to be notified...
1054 fghCheckJoystickPolls();
1057 * No messages in the queue, which means we are idling...
1059 if( fgState.IdleCallback != NULL )
1060 fgState.IdleCallback();
1063 * Remember about displaying all the windows that have
1064 * been marked for a redisplay (possibly in the idle call):
1071 * If an event caused a window to be closed, do the actual closing here
1077 * Enters the freeglut processing loop. Stays until the "ExecState" changes to "GLUT_EXEC_STATE_STOP".
1079 void FGAPIENTRY glutMainLoop( void )
1081 #if TARGET_HOST_WIN32
1082 SFG_Window *window = fgStructure.Windows.First ;
1086 * Make sure the display has been created etc.
1088 freeglut_assert_ready;
1090 #if TARGET_HOST_WIN32
1092 * Processing before the main loop: If there is a window which is open and which
1093 * has a visibility callback, call it. I know this is an ugly hack, but I'm not sure
1094 * what else to do about it. Ideally we should leave something uninitialized in the
1095 * create window code and initialize it in the main loop, and have that initialization
1096 * create a "WM_ACTIVATE" message. Then we would put the visibility callback code in
1097 * the "case WM_ACTIVATE" block below. - John Fay -- 10/24/02
1099 while ( window != NULL )
1101 if ( window->Callbacks.Visibility != NULL )
1102 window->Callbacks.Visibility ( window->State.Visible ) ;
1104 window = window->Node.Next ;
1109 * Set freeglut to be running
1111 fgState.ExecState = GLUT_EXEC_STATE_RUNNING ;
1114 * Enter the main loop itself. Inside the loop, process events and check for loop exit.
1116 while ( fgState.ExecState == GLUT_EXEC_STATE_RUNNING )
1118 glutMainLoopEvent () ;
1121 * If there are no more windows open, stop execution
1123 if ( fgStructure.Windows.First == NULL )
1124 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1129 * If we got here by the user closing a window or by the application closing down, there may still be windows open.
1131 fgCleanUpGlutsMess () ;
1134 * Check whether we return to the calling program or simply exit
1136 if ( fgState.ActionOnWindowClose == GLUT_ACTION_EXIT )
1140 * When this loop terminates, destroy the display, state and structure
1141 * of a freeglut session, so that another glutInit() call can happen
1147 * Leaves the freeglut processing loop.
1149 void FGAPIENTRY glutLeaveMainLoop( void )
1151 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1155 * The window procedure for handling Win32 events
1157 #if TARGET_HOST_WIN32
1158 LRESULT CALLBACK fgWindowProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam )
1160 SFG_Window* window = fgWindowByHandle( hWnd );
1164 if ( ( window == NULL ) && ( uMsg != WM_CREATE ) )
1165 return( DefWindowProc( hWnd, uMsg, wParam, lParam ) );
1167 /* printf ( "Window %3d message <%04x> %12d %12d\n", window?window->ID:0, uMsg, wParam, lParam ) ; */
1169 * Check what type of message are we receiving
1175 * The window structure is passed as the creation structure paramter...
1177 window = (SFG_Window *) (((LPCREATESTRUCT) lParam)->lpCreateParams);
1178 assert( window != NULL );
1181 * We can safely store the window's handle now:
1183 window->Window.Handle = hWnd;
1186 * Get the window's device context
1188 window->Window.Device = GetDC( hWnd );
1191 * Create or get the OpenGL rendering context now
1193 if ( fgState.BuildingAMenu )
1196 * Setup the pixel format of our window
1198 unsigned int current_DisplayMode = fgState.DisplayMode ;
1199 fgState.DisplayMode = GLUT_DOUBLE | GLUT_RGB | GLUT_DEPTH ;
1200 fgSetupPixelFormat( window, FALSE, PFD_MAIN_PLANE );
1201 fgState.DisplayMode = current_DisplayMode ;
1204 * If there isn't already an OpenGL rendering context for menu windows, make one
1206 if ( !fgStructure.MenuContext )
1208 fgStructure.MenuContext = (SFG_MenuContext *)malloc ( sizeof(SFG_MenuContext) ) ;
1209 fgStructure.MenuContext->Context = wglCreateContext( window->Window.Device );
1212 wglMakeCurrent ( window->Window.Device, fgStructure.MenuContext->Context ) ;
1214 /* window->Window.Context = wglGetCurrentContext () ; */
1215 window->Window.Context = wglCreateContext( window->Window.Device );
1220 * Setup the pixel format of our window
1222 fgSetupPixelFormat( window, FALSE, PFD_MAIN_PLANE );
1224 if ( fgState.UseCurrentContext == TRUE )
1226 window->Window.Context = wglGetCurrentContext();
1227 if ( ! window->Window.Context )
1228 window->Window.Context = wglCreateContext( window->Window.Device );
1231 window->Window.Context = wglCreateContext( window->Window.Device );
1235 * Still, we'll be needing to explicitly resize the window
1237 window->State.NeedToResize = TRUE;
1240 * Finally, have the window's device context released
1242 ReleaseDC( window->Window.Handle, window->Window.Device );
1247 * We got resized... But check if the window has been already added...
1249 fghReshapeWindowByHandle( hWnd, LOWORD(lParam), HIWORD(lParam) );
1253 printf("WM_SETFOCUS: %p\n", window );
1254 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1258 if (LOWORD(wParam) != WA_INACTIVE)
1260 /* glutSetCursor( fgStructure.Window->State.Cursor ); */
1261 printf("WM_ACTIVATE: glutSetCursor( %p, %d)\n", window, window->State.Cursor );
1263 glutSetCursor( window->State.Cursor );
1266 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1272 * Windows seems to need reminding to erase the cursor for NONE.
1275 if ((LOWORD(lParam) == HTCLIENT) &&
1276 (fgStructure.Window->State.Cursor == GLUT_CURSOR_NONE))
1279 /* Set the cursor AND change it for this window class. */
1280 # define MAP_CURSOR(a,b) case a: SetCursor( LoadCursor( NULL, b ) ); \
1282 /* Nuke the cursor AND change it for this window class. */
1283 # define ZAP_CURSOR(a,b) case a: SetCursor( NULL ); \
1286 if (LOWORD(lParam) == HTCLIENT)
1287 switch( window->State.Cursor )
1289 MAP_CURSOR( GLUT_CURSOR_RIGHT_ARROW, IDC_ARROW );
1290 MAP_CURSOR( GLUT_CURSOR_LEFT_ARROW, IDC_ARROW );
1291 MAP_CURSOR( GLUT_CURSOR_INFO, IDC_HELP );
1292 MAP_CURSOR( GLUT_CURSOR_DESTROY, IDC_CROSS );
1293 MAP_CURSOR( GLUT_CURSOR_HELP, IDC_HELP );
1294 MAP_CURSOR( GLUT_CURSOR_CYCLE, IDC_SIZEALL );
1295 MAP_CURSOR( GLUT_CURSOR_SPRAY, IDC_CROSS );
1296 MAP_CURSOR( GLUT_CURSOR_WAIT, IDC_WAIT );
1297 MAP_CURSOR( GLUT_CURSOR_TEXT, IDC_UPARROW );
1298 MAP_CURSOR( GLUT_CURSOR_CROSSHAIR, IDC_CROSS );
1299 /* MAP_CURSOR( GLUT_CURSOR_NONE, IDC_NO ); */
1300 ZAP_CURSOR( GLUT_CURSOR_NONE, NULL );
1303 MAP_CURSOR( GLUT_CURSOR_UP_DOWN, IDC_ARROW );
1307 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1312 * We are now Visible!
1314 window->State.Visible = TRUE;
1315 window->State.Redisplay = TRUE;
1320 * Start the painting job
1323 BeginPaint( hWnd, &ps );
1326 * Call the engine's main frame drawing method
1328 fghRedrawWindowByHandle( hWnd );
1331 * End the painting job, release the device context
1333 EndPaint( hWnd, &ps );
1338 * Make sure we don't close a window with current context active
1340 if( fgStructure.Window == window )
1345 wglMakeCurrent( NULL, NULL );
1346 /* Step through the list of windows. If the rendering context is notbeing used
1347 * by another window, then we delete it.
1349 for ( iter = fgStructure.Windows.First; iter; iter = iter->Node.Next )
1351 if ( ( iter->Window.Context == window->Window.Context ) && ( iter != window ) )
1355 if ( used == FALSE ) wglDeleteContext( window->Window.Context );
1359 * Put on a linked list of windows to be removed after all the callbacks have returned
1361 fgAddToWindowDestroyList ( window, FALSE ) ;
1364 * Proceed with the window destruction
1366 DestroyWindow( hWnd );
1371 * The window already got destroyed, so don't bother with it.
1378 * The mouse cursor has moved. Remember the new mouse cursor's position
1380 window->State.MouseX = LOWORD( lParam );
1381 window->State.MouseY = HIWORD( lParam );
1384 * Fallback if there's an active menu hooked to this window
1386 if( window->ActiveMenu != NULL )
1389 * Let's make the window redraw as a result of the mouse motion.
1391 window->State.Redisplay = TRUE ;
1397 * Remember the current modifiers state.
1399 window->State.Modifiers =
1400 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1401 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1402 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1405 * Check if any of the mouse buttons is pressed...
1407 if( (wParam & MK_LBUTTON) || (wParam & MK_MBUTTON) || (wParam & MK_RBUTTON) )
1410 * Yeah, indeed. We need to use the motion callback then:
1412 if( window->Callbacks.Motion != NULL )
1415 * Make sure the current window is set...
1417 fgSetWindow( window );
1420 * Execute the active mouse motion callback now
1422 window->Callbacks.Motion( window->State.MouseX, window->State.MouseY );
1428 * All mouse buttons are up, execute the passive mouse motion callback
1430 if( window->Callbacks.Passive != NULL )
1433 * Make sure the current window is set
1435 fgSetWindow( window );
1438 * Execute the passive mouse motion callback
1440 window->Callbacks.Passive( window->State.MouseX, window->State.MouseY );
1445 * Thrash the current modifiers state now
1447 window->State.Modifiers = 0xffffffff;
1451 case WM_LBUTTONDOWN:
1452 case WM_MBUTTONDOWN:
1453 case WM_RBUTTONDOWN:
1458 GLboolean pressed = TRUE;
1462 * The mouse cursor has moved. Remember the new mouse cursor's position
1464 window->State.MouseX = LOWORD( lParam );
1465 window->State.MouseY = HIWORD( lParam );
1468 * We're curious about the GLUT API button name...
1472 case WM_LBUTTONDOWN: pressed = TRUE; button = GLUT_LEFT_BUTTON; break;
1473 case WM_MBUTTONDOWN: pressed = TRUE; button = GLUT_MIDDLE_BUTTON; break;
1474 case WM_RBUTTONDOWN: pressed = TRUE; button = GLUT_RIGHT_BUTTON; break;
1475 case WM_LBUTTONUP: pressed = FALSE; button = GLUT_LEFT_BUTTON; break;
1476 case WM_MBUTTONUP: pressed = FALSE; button = GLUT_MIDDLE_BUTTON; break;
1477 case WM_RBUTTONUP: pressed = FALSE; button = GLUT_RIGHT_BUTTON; break;
1478 default: pressed = FALSE; button = -1; break;
1482 * The left and right mouse buttons might have been swapped...
1484 if( GetSystemMetrics( SM_SWAPBUTTON ) )
1485 if( button == GLUT_LEFT_BUTTON ) button = GLUT_RIGHT_BUTTON;
1486 else if( button == GLUT_RIGHT_BUTTON ) button = GLUT_LEFT_BUTTON;
1489 * Hey, what's up with you?
1492 return( DefWindowProc( hWnd, uMsg, lParam, wParam ) );
1495 * Do not execute the application's mouse callback if a menu is hooked to this button.
1496 * In that case an appropriate private call should be generated.
1497 * Near as I can tell, this is the menu behaviour:
1498 * - Down-click the menu button, menu not active: activate the menu with its upper left-hand corner at the mouse location.
1499 * - Down-click any button outside the menu, menu active: deactivate the menu
1500 * - Down-click any button inside the menu, menu active: select the menu entry and deactivate the menu
1501 * - Up-click the menu button, menu not active: nothing happens
1502 * - Up-click the menu button outside the menu, menu active: nothing happens
1503 * - Up-click the menu button inside the menu, menu active: select the menu entry and deactivate the menu
1505 if ( window->ActiveMenu != NULL ) /* Window has an active menu, it absorbs any mouse click */
1507 if ( fgCheckActiveMenu ( window, window->ActiveMenu ) == TRUE ) /* Inside the menu, invoke the callback and deactivate the menu*/
1509 /* Save the current window and menu and set the current window to the window whose menu this is */
1510 SFG_Window *save_window = fgStructure.Window ;
1511 SFG_Menu *save_menu = fgStructure.Menu ;
1512 fgSetWindow ( window ) ;
1513 fgStructure.Menu = window->ActiveMenu ;
1515 /* Execute the menu callback */
1516 fgExecuteMenuCallback ( window->ActiveMenu ) ;
1517 fgDeactivateMenu ( window->ActiveMenu->ParentWindow ) ;
1519 /* Restore the current window and menu */
1520 fgSetWindow ( save_window ) ;
1521 fgStructure.Menu = save_menu ;
1523 else /* Outside the menu, deactivate the menu if it's a downclick */
1525 if ( pressed == TRUE ) fgDeactivateMenu ( window->ActiveMenu->ParentWindow ) ;
1529 * Let's make the window redraw as a result of the mouse click and menu activity.
1531 if ( ! window->IsMenu ) window->State.Redisplay = TRUE ;
1537 * No active menu, let's check whether we need to activate one.
1539 if ( ( window->Menu[ button ] != NULL ) && ( pressed == TRUE ) )
1542 * Let's make the window redraw as a result of the mouse click.
1544 window->State.Redisplay = TRUE ;
1547 * Set the current window
1549 fgSetWindow( window );
1552 * Activate the appropriate menu structure...
1554 fgActivateMenu( window, button );
1560 * Check if there is a mouse callback hooked to the window
1562 if( fgStructure.Window->Callbacks.Mouse == NULL )
1566 * Remember the current modifiers state.
1568 fgStructure.Window->State.Modifiers =
1569 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1570 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1571 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1574 * Finally execute the mouse callback
1576 fgStructure.Window->Callbacks.Mouse(
1578 pressed == TRUE ? GLUT_DOWN : GLUT_UP,
1579 window->State.MouseX,
1580 window->State.MouseY
1584 * Trash the modifiers state
1586 fgStructure.Window->State.Modifiers = 0xffffffff;
1597 * Ignore the automatic key repetition if needed:
1599 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1603 * Set the current window
1605 fgSetWindow( window );
1608 * Remember the current modifiers state. This is done here in order
1609 * to make sure the VK_DELETE keyboard callback is executed properly.
1611 window->State.Modifiers =
1612 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1613 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1614 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1617 * Set the mouse position
1619 GetCursorPos ( &mouse_pos ) ;
1620 ScreenToClient ( window->Window.Handle, &mouse_pos ) ;
1622 window->State.MouseX = mouse_pos.x ;
1623 window->State.MouseY = mouse_pos.y ;
1626 * Convert the Win32 keystroke codes to GLUTtish way
1628 # define KEY(a,b) case a: keypress = b; break;
1633 * Most of the special characters can be handled automagically...
1635 KEY( VK_F1, GLUT_KEY_F1 ); KEY( VK_F2, GLUT_KEY_F2 );
1636 KEY( VK_F3, GLUT_KEY_F3 ); KEY( VK_F4, GLUT_KEY_F4 );
1637 KEY( VK_F5, GLUT_KEY_F5 ); KEY( VK_F6, GLUT_KEY_F6 );
1638 KEY( VK_F7, GLUT_KEY_F7 ); KEY( VK_F8, GLUT_KEY_F8 );
1639 KEY( VK_F9, GLUT_KEY_F9 ); KEY( VK_F10, GLUT_KEY_F10 );
1640 KEY( VK_F11, GLUT_KEY_F11 ); KEY( VK_F12, GLUT_KEY_F12 );
1641 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP ); KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1642 KEY( VK_HOME, GLUT_KEY_HOME ); KEY( VK_END, GLUT_KEY_END );
1643 KEY( VK_LEFT, GLUT_KEY_LEFT ); KEY( VK_UP, GLUT_KEY_UP );
1644 KEY( VK_RIGHT, GLUT_KEY_RIGHT ); KEY( VK_DOWN, GLUT_KEY_DOWN );
1645 KEY( VK_INSERT, GLUT_KEY_INSERT );
1648 * ...yet there is a small exception we need to have handled...
1652 * The delete key should be treated as an ASCII keypress:
1654 if( window->Callbacks.Keyboard != NULL )
1655 window->Callbacks.Keyboard( 127, window->State.MouseX, window->State.MouseY );
1659 * Execute the special callback, if present, given the conversion was a success:
1661 if( (keypress != -1) && (window->Callbacks.Special != NULL) )
1664 * Have the special callback executed:
1666 window->Callbacks.Special( keypress, window->State.MouseX, window->State.MouseY );
1670 * Thrash the modifiers register now
1672 window->State.Modifiers = 0xffffffff;
1683 * Set the current window
1685 fgSetWindow( window );
1688 * Remember the current modifiers state. This is done here in order
1689 * to make sure the VK_DELETE keyboard callback is executed properly.
1691 window->State.Modifiers =
1692 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1693 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1694 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1697 * Set the mouse position
1699 GetCursorPos ( &mouse_pos ) ;
1700 ScreenToClient ( window->Window.Handle, &mouse_pos ) ;
1702 window->State.MouseX = mouse_pos.x ;
1703 window->State.MouseY = mouse_pos.y ;
1706 * Convert the Win32 keystroke codes to GLUTtish way. "KEY(a,b)" was defined under "WM_KEYDOWN"
1712 * Most of the special characters can be handled automagically...
1714 KEY( VK_F1, GLUT_KEY_F1 ); KEY( VK_F2, GLUT_KEY_F2 );
1715 KEY( VK_F3, GLUT_KEY_F3 ); KEY( VK_F4, GLUT_KEY_F4 );
1716 KEY( VK_F5, GLUT_KEY_F5 ); KEY( VK_F6, GLUT_KEY_F6 );
1717 KEY( VK_F7, GLUT_KEY_F7 ); KEY( VK_F8, GLUT_KEY_F8 );
1718 KEY( VK_F9, GLUT_KEY_F9 ); KEY( VK_F10, GLUT_KEY_F10 );
1719 KEY( VK_F11, GLUT_KEY_F11 ); KEY( VK_F12, GLUT_KEY_F12 );
1720 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP ); KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1721 KEY( VK_HOME, GLUT_KEY_HOME ); KEY( VK_END, GLUT_KEY_END );
1722 KEY( VK_LEFT, GLUT_KEY_LEFT ); KEY( VK_UP, GLUT_KEY_UP );
1723 KEY( VK_RIGHT, GLUT_KEY_RIGHT ); KEY( VK_DOWN, GLUT_KEY_DOWN );
1724 KEY( VK_INSERT, GLUT_KEY_INSERT );
1727 * ...yet there is a small exception we need to have handled...
1731 * The delete key should be treated as an ASCII keypress:
1733 if( window->Callbacks.KeyboardUp != NULL )
1734 window->Callbacks.KeyboardUp( 127, window->State.MouseX, window->State.MouseY );
1740 * Call the KeyboardUp callback for a regular character if there is one.
1745 GetKeyboardState(state);
1747 if ( ToAscii( wParam, 0, state, code, 0 ) == 1 )
1750 if( window->Callbacks.KeyboardUp != NULL )
1751 window->Callbacks.KeyboardUp( (char)wParam, window->State.MouseX, window->State.MouseY );
1756 * Execute the special callback, if present, given the conversion was a success:
1758 if( (keypress != -1) && (window->Callbacks.SpecialUp != NULL) )
1761 * Have the special callback executed:
1763 window->Callbacks.SpecialUp( keypress, window->State.MouseX, window->State.MouseY );
1767 * Thrash the modifiers register now
1769 window->State.Modifiers = 0xffffffff;
1777 * Ignore the automatic key repetition if needed:
1779 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1783 * Clear to go with the keyboard callback, if registered:
1785 if( window->Callbacks.Keyboard != NULL )
1788 * Remember the current modifiers state
1790 window->State.Modifiers =
1791 ( ( (GetKeyState( VK_LSHIFT ) < 0 ) || ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1792 ( ( (GetKeyState( VK_LCONTROL ) < 0 ) || ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1793 ( ( (GetKeyState( VK_LMENU ) < 0 ) || ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1796 * Have the special callback executed:
1798 window->Callbacks.Keyboard( (char)wParam, window->State.MouseX, window->State.MouseY );
1801 * Thrash the modifiers register now
1803 window->State.Modifiers = 0xffffffff;
1808 case WM_CAPTURECHANGED : /* User has finished resizing the window, force a redraw */
1809 if ( window->Callbacks.Display )
1810 window->Callbacks.Display () ;
1812 /* lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ) ; */
1816 * Other messages that I have seen and which are not handled already
1818 case WM_SETTEXT : /* 0x000c */
1819 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Pass it on to "DefWindowProc" to set the window text */
1822 case WM_GETTEXT : /* 0x000d */
1823 /* Ideally we would copy the title of the window into "lParam" */
1824 /* strncpy ( (char *)lParam, "Window Title", wParam ) ;
1825 lRet = ( wParam > 12 ) ? 12 : wParam ; */ /* the number of characters copied */
1826 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1829 case WM_GETTEXTLENGTH : /* 0x000e */
1830 /* Ideally we would get the length of the title of the window */
1831 lRet = 12 ; /* the number of characters in "Window Title\0" (see above) */
1834 case WM_ERASEBKGND : /* 0x0014 */
1835 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1838 case WM_SYNCPAINT : /* 0x0088 */
1839 /* Another window has moved, need to update this one */
1840 window->State.Redisplay = TRUE ;
1841 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Help screen says this message must be passed to "DefWindowProc" */
1844 case WM_NCPAINT : /* 0x0085 */
1845 /* Need to update the border of this window */
1846 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); /* Pass it on to "DefWindowProc" to repaint a standard border */
1851 * Handle unhandled messages
1853 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1861 /*** END OF FILE ***/