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 #include "../include/GL/freeglut.h"
33 #include "freeglut_internal.h"
36 #if TARGET_HOST_UNIX_X11
37 #include <sys/types.h>
42 #elif TARGET_HOST_WIN32
46 #define MAX(a,b) (((a)>(b)) ? (a) : (b))
50 #define MIN(a,b) (((a)<(b)) ? (a) : (b))
55 * TODO BEFORE THE STABLE RELEASE:
57 * There are some issues concerning window redrawing under X11, and maybe
58 * some events are not handled. The Win32 version lacks some more features,
59 * but seems acceptable for not demanding purposes.
61 * Need to investigate why the X11 version breaks out with an error when
62 * closing a window (using the window manager, not glutDestroyWindow)...
65 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
68 * Handle a window configuration change. When no reshape
69 * callback is hooked, the viewport size is updated to
70 * match the new window size.
72 static void fghReshapeWindowByHandle ( SFG_WindowHandleType handle,
73 int width, int height )
75 SFG_Window *current_window = fgStructure.Window;
77 SFG_Window* window = fgWindowByHandle( handle );
78 freeglut_return_if_fail( window != NULL );
81 #if TARGET_HOST_UNIX_X11
83 XResizeWindow( fgDisplay.Display, window->Window.Handle,
85 XFlush( fgDisplay.Display ); /* XXX Shouldn't need this */
87 #elif TARGET_HOST_WIN32
93 GetWindowRect( window->Window.Handle, &winRect );
97 if ( window->Parent == NULL )
100 * Adjust the size of the window to allow for the size of the
101 * frame, if we are not a menu
103 if ( ! window->IsMenu )
105 width += GetSystemMetrics( SM_CXSIZEFRAME ) * 2;
106 height += GetSystemMetrics( SM_CYSIZEFRAME ) * 2 +
107 GetSystemMetrics( SM_CYCAPTION );
112 GetWindowRect( window->Parent->Window.Handle,
114 x -= winRect.left + GetSystemMetrics( SM_CXSIZEFRAME );
115 y -= winRect.top + GetSystemMetrics( SM_CYSIZEFRAME ) +
116 GetSystemMetrics( SM_CYCAPTION );
120 window->Window.Handle,
129 if( FETCH_WCB( *window, Reshape ) )
130 INVOKE_WCB( *window, Reshape, ( width, height ) );
133 fgSetWindow( window );
134 glViewport( 0, 0, width, height );
140 * Force a window redraw. In Windows at least this is only a partial
141 * solution: if the window is increasing in size in either dimension,
142 * the already-drawn part does not get drawn again and things look funny.
143 * But without this we get this bad behaviour whenever we resize the
146 window->State.Redisplay = GL_TRUE;
149 fgSetWindow( current_window );
153 * Calls a window's redraw method. This is used when
154 * a redraw is forced by the incoming window messages.
156 static void fghRedrawWindowByHandle ( SFG_WindowHandleType handle )
158 SFG_Window* window = fgWindowByHandle( handle );
159 freeglut_return_if_fail( window );
160 freeglut_return_if_fail( FETCH_WCB ( *window, Display ) );
162 window->State.Redisplay = GL_FALSE;
164 freeglut_return_if_fail( window->State.Visible );
166 if( window->State.NeedToResize )
168 SFG_Window *current_window = fgStructure.Window;
170 fgSetWindow( window );
172 fghReshapeWindowByHandle(
173 window->Window.Handle,
178 window->State.NeedToResize = GL_FALSE;
179 fgSetWindow ( current_window );
182 INVOKE_WCB( *window, Display, ( ) );
186 * A static helper function to execute display callback for a window
188 static void fghcbDisplayWindow( SFG_Window *window,
189 SFG_Enumerator *enumerator )
191 if( window->State.Redisplay &&
192 window->State.Visible )
194 if( window->State.NeedToResize )
196 SFG_Window *current_window = fgStructure.Window;
198 fgSetWindow( window );
200 fghReshapeWindowByHandle(
201 window->Window.Handle,
206 window->State.NeedToResize = GL_FALSE;
207 fgSetWindow ( current_window );
210 window->State.Redisplay = GL_FALSE;
212 #if TARGET_HOST_UNIX_X11
214 SFG_Window *current_window = fgStructure.Window;
216 INVOKE_WCB( *window, Display, ( ) );
217 fgSetWindow( current_window );
219 #elif TARGET_HOST_WIN32
221 window->Window.Handle, NULL, NULL,
222 RDW_NOERASE | RDW_INTERNALPAINT | RDW_INVALIDATE | RDW_UPDATENOW
227 fgEnumSubWindows( window, fghcbDisplayWindow, enumerator );
231 * Make all windows perform a display call
233 static void fghDisplayAll( void )
235 SFG_Enumerator enumerator;
237 enumerator.found = GL_FALSE;
238 enumerator.data = NULL;
240 fgEnumWindows( fghcbDisplayWindow, &enumerator );
244 * Window enumerator callback to check for the joystick polling code
246 static void fghcbCheckJoystickPolls( SFG_Window *window,
247 SFG_Enumerator *enumerator )
249 long int checkTime = fgElapsedTime( );
251 if( window->State.JoystickLastPoll + window->State.JoystickPollRate <=
254 fgJoystickPollWindow( window );
255 window->State.JoystickLastPoll = checkTime;
258 fgEnumSubWindows( window, fghcbCheckJoystickPolls, enumerator );
262 * Check all windows for joystick polling
264 static void fghCheckJoystickPolls( void )
266 SFG_Enumerator enumerator;
268 enumerator.found = GL_FALSE;
269 enumerator.data = NULL;
271 fgEnumWindows( fghcbCheckJoystickPolls, &enumerator );
275 * Check the global timers
277 static void fghCheckTimers( void )
279 long checkTime = fgElapsedTime( );
282 while( timer = fgState.Timers.First )
284 if( timer->TriggerTime > checkTime )
287 fgListRemove( &fgState.Timers, &timer->Node );
288 fgListAppend( &fgState.FreeTimers, &timer->Node );
290 timer->Callback( timer->ID );
297 long fgElapsedTime( void )
299 if ( fgState.Time.Set )
301 #if TARGET_HOST_UNIX_X11
305 gettimeofday( &now, NULL );
307 elapsed = (now.tv_usec - fgState.Time.Value.tv_usec) / 1000;
308 elapsed += (now.tv_sec - fgState.Time.Value.tv_sec) * 1000;
311 #elif TARGET_HOST_WIN32
312 return timeGetTime() - fgState.Time.Value;
317 #if TARGET_HOST_UNIX_X11
318 gettimeofday( &fgState.Time.Value, NULL );
319 #elif TARGET_HOST_WIN32
320 fgState.Time.Value = timeGetTime ();
322 fgState.Time.Set = GL_TRUE ;
331 void fgError( const char *fmt, ... )
337 fprintf( stderr, "freeglut ");
338 if( fgState.ProgramName )
339 fprintf (stderr, "(%s): ", fgState.ProgramName);
340 vfprintf( stderr, fmt, ap );
341 fprintf( stderr, "\n" );
345 if ( fgState.Initialised )
351 void fgWarning( const char *fmt, ... )
357 fprintf( stderr, "freeglut ");
358 if( fgState.ProgramName )
359 fprintf( stderr, "(%s): ", fgState.ProgramName );
360 vfprintf( stderr, fmt, ap );
361 fprintf( stderr, "\n" );
367 * Indicates whether Joystick events are being used by ANY window.
369 * The current mechanism is to walk all of the windows and ask if
370 * there is a joystick callback. Certainly in some cases, maybe
371 * in all cases, the joystick is attached to the system and accessed
372 * from ONE point by GLUT/freeglut, so this is not the right way,
373 * in general, to do this. However, the Joystick code is segregated
374 * in its own little world, so we can't access the information that
375 * we need in order to do that nicely.
378 * * Store Joystick data into freeglut global state.
379 * * Provide NON-static functions or data from Joystick *.c file.
381 * Basically, the RIGHT way to do this requires knowing something
382 * about the Joystick. Right now, the Joystick code is behind
386 static void fgCheckJoystickCallback( SFG_Window* w, SFG_Enumerator* e)
388 if( FETCH_WCB( *w, Joystick ) )
393 fgEnumSubWindows( w, fgCheckJoystickCallback, e );
395 static int fgHaveJoystick( void )
397 SFG_Enumerator enumerator;
398 enumerator.found = GL_FALSE;
399 enumerator.data = NULL;
400 fgEnumWindows( fgCheckJoystickCallback, &enumerator );
401 return !!enumerator.data;
403 static void fgHavePendingRedisplaysCallback( SFG_Window* w, SFG_Enumerator* e)
405 if( w->State.Redisplay )
410 fgEnumSubWindows( w, fgHavePendingRedisplaysCallback, e );
412 static int fgHavePendingRedisplays (void)
414 SFG_Enumerator enumerator;
415 enumerator.found = GL_FALSE;
416 enumerator.data = NULL;
417 fgEnumWindows( fgHavePendingRedisplaysCallback, &enumerator );
418 return !!enumerator.data;
421 * Returns the number of GLUT ticks (milliseconds) till the next timer event.
423 static long fgNextTimer( void )
428 if( (timer = fgState.Timers.First) )
429 ret = timer->TriggerTime - fgElapsedTime();
434 * Does the magic required to relinquish the CPU until something interesting
437 static void fgSleepForEvents( void )
439 #if TARGET_HOST_UNIX_X11
446 if( fgState.IdleCallback || fgHavePendingRedisplays( ) )
448 socket = ConnectionNumber( fgDisplay.Display );
450 FD_SET( socket, &fdset );
452 msec = fgNextTimer( );
453 if( fgHaveJoystick( ) )
454 msec = MIN( msec, 10 );
456 wait.tv_sec = msec / 1000;
457 wait.tv_usec = (msec % 1000) * 1000;
458 err = select( socket+1, &fdset, NULL, NULL, &wait );
461 fgWarning ( "freeglut select() error: %d\n", errno );
463 #elif TARGET_HOST_WIN32
467 #if TARGET_HOST_UNIX_X11
469 * Returns GLUT modifier mask for an XEvent.
471 int fgGetXModifiers( XEvent *event )
475 if( event->xkey.state & ( ShiftMask | LockMask ) )
476 ret |= GLUT_ACTIVE_SHIFT;
477 if( event->xkey.state & ControlMask )
478 ret |= GLUT_ACTIVE_CTRL;
479 if( event->xkey.state & Mod1Mask )
480 ret |= GLUT_ACTIVE_ALT;
487 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
490 * Executes a single iteration in the freeglut processing loop.
492 void FGAPIENTRY glutMainLoopEvent( void )
494 #if TARGET_HOST_UNIX_X11
499 * This code was repeated constantly, so here it goes into a definition:
501 #define GETWINDOW(a) \
502 window = fgWindowByHandle( event.a.window ); \
503 if( window == NULL ) \
506 #define GETMOUSE(a) \
507 window->State.MouseX = event.a.x; \
508 window->State.MouseY = event.a.y;
510 freeglut_assert_ready;
512 while( XPending( fgDisplay.Display ) )
514 XNextEvent( fgDisplay.Display, &event );
520 * Destroy the window when the WM_DELETE_WINDOW message arrives
522 if( (Atom) event.xclient.data.l[ 0 ] == fgDisplay.DeleteWindow )
524 GETWINDOW( xclient );
526 fgDestroyWindow ( window );
528 if( fgState.ActionOnWindowClose == GLUT_ACTION_EXIT )
534 fgState.ExecState = GLUT_EXEC_STATE_STOP;
540 * CreateNotify causes a configure-event so that sub-windows are
541 * handled compatibly with GLUT. Otherwise, your sub-windows
542 * (in freeglut only) will not get an initial reshape event,
543 * which can break things.
545 * XXX NOTE that it is possible that you will more than one Reshape
546 * XXX event for your top-level window, but something like this
547 * XXX appears to be required for compatbility.
549 * GLUT presumably does this because it generally tries to treat
550 * sub-windows the same as windows.
553 case ConfigureNotify:
554 GETWINDOW( xconfigure );
556 int width = event.xconfigure.width;
557 int height = event.xconfigure.height;
559 GETWINDOW( xconfigure );
560 if( FETCH_WCB( *window, Reshape ) )
561 INVOKE_WCB( *window, Reshape, ( width, height ) );
564 fgSetWindow( window );
565 glViewport( 0, 0, width, height );
572 * This is sent to confirm the XDestroyWindow call.
573 * XXX WHY is this commented out? Should we re-enable it?
575 /* fgAddToWindowDestroyList ( window ); */
580 * We are too dumb to process partial exposes...
581 * XXX Well, we could do it. However, it seems to only
582 * XXX be potentially useful for single-buffered (since
583 * XXX double-buffered does not respect viewport when we
584 * XXX do a buffer-swap).
586 if( event.xexpose.count == 0 )
587 fghRedrawWindowByHandle( event.xexpose.window );
593 * If we never do anything with this, can we just not ask to
594 * get these messages?
600 * Have the client's keyboard knowledge updated (xlib.ps,
601 * page 206, says that's a good thing to do)
603 XRefreshKeyboardMapping( (XMappingEvent *) &event );
606 case VisibilityNotify:
608 GETWINDOW( xvisibility );
609 if( ! FETCH_WCB( *window, WindowStatus ) )
611 fgSetWindow( window );
614 * Sending this event, the X server can notify us that the window
615 * has just acquired one of the three possible visibility states:
616 * VisibilityUnobscured, VisibilityPartiallyObscured or
617 * VisibilityFullyObscured
619 switch( event.xvisibility.state )
621 case VisibilityUnobscured:
622 INVOKE_WCB( *window, WindowStatus, ( GLUT_FULLY_RETAINED ) );
623 window->State.Visible = GL_TRUE;
626 case VisibilityPartiallyObscured:
627 INVOKE_WCB( *window, WindowStatus,
628 ( GLUT_PARTIALLY_RETAINED ) );
629 window->State.Visible = GL_TRUE;
632 case VisibilityFullyObscured:
633 INVOKE_WCB( *window, WindowStatus, ( GLUT_FULLY_COVERED ) );
634 window->State.Visible = GL_FALSE;
638 fgWarning( "Uknown X visibility state: %d",
639 event.xvisibility.state );
647 GETWINDOW( xcrossing );
648 GETMOUSE( xcrossing );
649 INVOKE_WCB( *window, Entry, ( ( EnterNotify == event.type ) ?
656 GETWINDOW( xmotion );
659 if( window->ActiveMenu )
661 if( window == window->ActiveMenu->ParentWindow )
663 window->ActiveMenu->Window->State.MouseX =
664 event.xmotion.x_root - window->ActiveMenu->X;
665 window->ActiveMenu->Window->State.MouseY =
666 event.xmotion.y_root - window->ActiveMenu->Y;
668 window->ActiveMenu->Window->State.Redisplay = GL_TRUE ;
669 fgSetWindow( window->ActiveMenu->ParentWindow );
675 * XXX For more than 5 buttons, just check {event.xmotion.state},
676 * XXX rather than a host of bit-masks?
678 #define BUTTON_MASK \
679 ( Button1Mask | Button2Mask | Button3Mask | Button4Mask | Button5Mask )
680 if ( event.xmotion.state & BUTTON_MASK )
681 INVOKE_WCB( *window, Motion, ( event.xmotion.x,
684 INVOKE_WCB( *window, Passive, ( event.xmotion.x,
692 GLboolean pressed = GL_TRUE;
695 if( event.type == ButtonRelease )
699 * A mouse button has been pressed or released. Traditionally,
700 * break if the window was found within the freeglut structures.
702 GETWINDOW( xbutton );
706 * An X button (at least in XFree86) is numbered from 1.
707 * A GLUT button is numbered from 0.
708 * Old GLUT passed through buttons other than just the first
709 * three, though it only gave symbolic names and official
710 * support to the first three.
712 button = event.xbutton.button - 1;
715 * XXX This comment is replicated in the WIN32 section and
716 * XXX maybe also in the menu code. Can we move the info
717 * XXX to one central place and *reference* it from here?
719 * Do not execute the application's mouse callback if a menu
720 * is hooked to this button. In that case an appropriate
721 * private call should be generated.
722 * Near as I can tell, this is the menu behaviour:
723 * - Down-click the menu button, menu not active: activate
724 * the menu with its upper left-hand corner at the mouse
726 * - Down-click any button outside the menu, menu active:
727 * deactivate the menu
728 * - Down-click any button inside the menu, menu active:
729 * select the menu entry and deactivate the menu
730 * - Up-click the menu button, menu not active: nothing happens
731 * - Up-click the menu button outside the menu, menu active:
733 * - Up-click the menu button inside the menu, menu active:
734 * select the menu entry and deactivate the menu
736 /* Window has an active menu, it absorbs any mouse click */
737 if( window->ActiveMenu )
739 if( window == window->ActiveMenu->ParentWindow )
741 window->ActiveMenu->Window->State.MouseX =
742 event.xbutton.x_root - window->ActiveMenu->X;
743 window->ActiveMenu->Window->State.MouseY =
744 event.xbutton.y_root - window->ActiveMenu->Y;
747 /* In the menu, invoke the callback and deactivate the menu*/
748 if( fgCheckActiveMenu( window->ActiveMenu->Window,
749 window->ActiveMenu ) )
752 * Save the current window and menu and set the current
753 * window to the window whose menu this is
755 SFG_Window *save_window = fgStructure.Window;
756 SFG_Menu *save_menu = fgStructure.Menu;
757 SFG_Window *parent_window =
758 window->ActiveMenu->ParentWindow;
759 fgSetWindow( parent_window );
760 fgStructure.Menu = window->ActiveMenu;
762 /* Execute the menu callback */
763 fgExecuteMenuCallback( window->ActiveMenu );
764 fgDeactivateMenu( parent_window );
766 /* Restore the current window and menu */
767 fgSetWindow( save_window );
768 fgStructure.Menu = save_menu;
772 * Outside the menu, deactivate if it's a downclick
773 * XXX This isn't enough. A downclick outside of
774 * XXX the interior of our freeglut windows should also
775 * XXX deactivate the menu. This is more complicated.
777 fgDeactivateMenu( window->ActiveMenu->ParentWindow );
779 window->State.Redisplay = GL_TRUE;
784 * No active menu, let's check whether we need to activate one.
786 if( ( 0 <= button ) &&
787 ( FREEGLUT_MAX_MENUS > button ) &&
788 ( window->Menu[ button ] ) &&
791 window->State.Redisplay = GL_TRUE;
792 fgSetWindow( window );
793 fgActivateMenu( window, button );
798 * Check if there is a mouse or mouse wheel callback hooked to the
801 if( ! FETCH_WCB( *window, Mouse ) &&
802 ! FETCH_WCB( *window, MouseWheel ) )
805 fgState.Modifiers = fgGetXModifiers( &event );
808 * Finally execute the mouse or mouse wheel callback
810 * XXX Use a symbolic constant, *not* "4"!
812 if( ( button < 3 ) || ( ! FETCH_WCB( *window, MouseWheel ) ) )
813 INVOKE_WCB( *window, Mouse, ( button,
814 pressed ? GLUT_DOWN : GLUT_UP,
821 * Map 4 and 5 to wheel zero; EVEN to +1, ODD to -1
822 * " 6 and 7 " " one; ...
824 * XXX This *should* be behind some variables/macros,
825 * XXX since the order and numbering isn't certain
826 * XXX See XFree86 configuration docs (even back in the
827 * XXX 3.x days, and especially with 4.x).
829 * XXX Note that {button} has already been decremeted
830 * XXX in mapping from X button numbering to GLUT.
832 int wheel_number = (button - 3) / 2;
838 INVOKE_WCB( *window, MouseWheel, ( wheel_number,
846 * Trash the modifiers state
848 fgState.Modifiers = 0xffffffff;
855 FGCBKeyboard keyboard_cb;
856 FGCBSpecial special_cb;
861 if( event.type == KeyPress )
863 keyboard_cb = FETCH_WCB( *window, Keyboard );
864 special_cb = FETCH_WCB( *window, Special );
868 keyboard_cb = FETCH_WCB( *window, KeyboardUp );
869 special_cb = FETCH_WCB( *window, SpecialUp );
873 * Is there a keyboard/special callback hooked for this window?
875 if( keyboard_cb || special_cb )
877 XComposeStatus composeStatus;
878 char asciiCode[ 32 ];
883 * Check for the ASCII/KeySym codes associated with the event:
885 len = XLookupString( &event.xkey, asciiCode, sizeof(asciiCode),
886 &keySym, &composeStatus
890 * GLUT API tells us to have two separate callbacks...
895 * ...one for the ASCII translateable keypresses...
899 fgSetWindow( window );
900 fgState.Modifiers = fgGetXModifiers( &event );
901 keyboard_cb( asciiCode[ 0 ],
902 event.xkey.x, event.xkey.y
904 fgState.Modifiers = 0xffffffff;
912 * ...and one for all the others, which need to be
913 * translated to GLUT_KEY_Xs...
917 case XK_F1: special = GLUT_KEY_F1; break;
918 case XK_F2: special = GLUT_KEY_F2; break;
919 case XK_F3: special = GLUT_KEY_F3; break;
920 case XK_F4: special = GLUT_KEY_F4; break;
921 case XK_F5: special = GLUT_KEY_F5; break;
922 case XK_F6: special = GLUT_KEY_F6; break;
923 case XK_F7: special = GLUT_KEY_F7; break;
924 case XK_F8: special = GLUT_KEY_F8; break;
925 case XK_F9: special = GLUT_KEY_F9; break;
926 case XK_F10: special = GLUT_KEY_F10; break;
927 case XK_F11: special = GLUT_KEY_F11; break;
928 case XK_F12: special = GLUT_KEY_F12; break;
930 case XK_Left: special = GLUT_KEY_LEFT; break;
931 case XK_Right: special = GLUT_KEY_RIGHT; break;
932 case XK_Up: special = GLUT_KEY_UP; break;
933 case XK_Down: special = GLUT_KEY_DOWN; break;
936 case XK_Prior: special = GLUT_KEY_PAGE_UP; break;
938 case XK_Next: special = GLUT_KEY_PAGE_DOWN; break;
940 case XK_Home: special = GLUT_KEY_HOME; break;
942 case XK_End: special = GLUT_KEY_END; break;
944 case XK_Insert: special = GLUT_KEY_INSERT; break;
948 * Execute the callback (if one has been specified),
949 * given that the special code seems to be valid...
951 if( special_cb && (special != -1) )
953 fgSetWindow( window );
954 fgState.Modifiers = fgGetXModifiers( &event );
955 special_cb( special, event.xkey.x, event.xkey.y );
956 fgState.Modifiers = 0xffffffff;
964 break; /* XXX Should disable this event */
967 fgWarning ("Unknown X event type: %d", event.type);
972 #elif TARGET_HOST_WIN32
976 while( PeekMessage( &stMsg, NULL, 0, 0, PM_NOREMOVE ) )
978 if( GetMessage( &stMsg, NULL, 0, 0 ) == 0 )
980 if( fgState.ActionOnWindowClose == GLUT_ACTION_EXIT )
985 fgState.ExecState = GLUT_EXEC_STATE_STOP;
989 TranslateMessage( &stMsg );
990 DispatchMessage( &stMsg );
994 if( fgState.Timers.First )
996 fghCheckJoystickPolls( );
1003 * Enters the freeglut processing loop.
1004 * Stays until the "ExecState" changes to "GLUT_EXEC_STATE_STOP".
1006 void FGAPIENTRY glutMainLoop( void )
1008 #if TARGET_HOST_WIN32
1009 SFG_Window *window = (SFG_Window *)fgStructure.Windows.First ;
1012 freeglut_assert_ready;
1014 #if TARGET_HOST_WIN32
1016 * Processing before the main loop: If there is a window which is open and
1017 * which has a visibility callback, call it. I know this is an ugly hack,
1018 * but I'm not sure what else to do about it. Ideally we should leave
1019 * something uninitialized in the create window code and initialize it in
1020 * the main loop, and have that initialization create a "WM_ACTIVATE"
1021 * message. Then we would put the visibility callback code in the
1022 * "case WM_ACTIVATE" block below. - John Fay -- 10/24/02
1026 if ( FETCH_WCB( *window, Visibility ) )
1028 SFG_Window *current_window = fgStructure.Window ;
1030 INVOKE_WCB( *window, Visibility, ( window->State.Visible ) );
1031 fgSetWindow( current_window );
1034 window = (SFG_Window *)window->Node.Next ;
1038 fgState.ExecState = GLUT_EXEC_STATE_RUNNING ;
1039 while( fgState.ExecState == GLUT_EXEC_STATE_RUNNING )
1041 glutMainLoopEvent( );
1043 if( fgStructure.Windows.First == NULL )
1044 fgState.ExecState = GLUT_EXEC_STATE_STOP;
1047 if( fgState.IdleCallback )
1048 fgState.IdleCallback( );
1055 * When this loop terminates, destroy the display, state and structure
1056 * of a freeglut session, so that another glutInit() call can happen
1062 * Leaves the freeglut processing loop.
1064 void FGAPIENTRY glutLeaveMainLoop( void )
1066 fgState.ExecState = GLUT_EXEC_STATE_STOP ;
1070 #if TARGET_HOST_WIN32
1072 * Determine a GLUT modifer mask based on MS-WINDOWS system info.
1074 int fgGetWin32Modifiers (void)
1077 ( ( ( GetKeyState( VK_LSHIFT ) < 0 ) ||
1078 ( GetKeyState( VK_RSHIFT ) < 0 )) ? GLUT_ACTIVE_SHIFT : 0 ) |
1079 ( ( ( GetKeyState( VK_LCONTROL ) < 0 ) ||
1080 ( GetKeyState( VK_RCONTROL ) < 0 )) ? GLUT_ACTIVE_CTRL : 0 ) |
1081 ( ( ( GetKeyState( VK_LMENU ) < 0 ) ||
1082 ( GetKeyState( VK_RMENU ) < 0 )) ? GLUT_ACTIVE_ALT : 0 );
1086 * The window procedure for handling Win32 events
1088 LRESULT CALLBACK fgWindowProc( HWND hWnd, UINT uMsg, WPARAM wParam,
1091 SFG_Window* window = fgWindowByHandle( hWnd );
1095 if ( ( window == NULL ) && ( uMsg != WM_CREATE ) )
1096 return DefWindowProc( hWnd, uMsg, wParam, lParam );
1098 /* printf ( "Window %3d message <%04x> %12d %12d\n", window?window->ID:0,
1099 uMsg, wParam, lParam ); */
1104 * The window structure is passed as the creation structure paramter...
1106 window = (SFG_Window *) (((LPCREATESTRUCT) lParam)->lpCreateParams);
1107 assert( window != NULL );
1109 window->Window.Handle = hWnd;
1110 window->Window.Device = GetDC( hWnd );
1111 if( window->IsMenu )
1113 unsigned int current_DisplayMode = fgState.DisplayMode;
1114 fgState.DisplayMode = GLUT_DOUBLE | GLUT_RGB | GLUT_DEPTH;
1115 fgSetupPixelFormat( window, GL_FALSE, PFD_MAIN_PLANE );
1116 fgState.DisplayMode = current_DisplayMode;
1118 if( fgStructure.MenuContext )
1119 wglMakeCurrent( window->Window.Device,
1120 fgStructure.MenuContext->Context
1124 fgStructure.MenuContext =
1125 (SFG_MenuContext *)malloc( sizeof(SFG_MenuContext) );
1126 fgStructure.MenuContext->Context =
1127 wglCreateContext( window->Window.Device );
1130 /* window->Window.Context = wglGetCurrentContext (); */
1131 window->Window.Context = wglCreateContext( window->Window.Device );
1135 fgSetupPixelFormat( window, GL_FALSE, PFD_MAIN_PLANE );
1137 if( ! fgState.UseCurrentContext )
1138 window->Window.Context =
1139 wglCreateContext( window->Window.Device );
1142 window->Window.Context = wglGetCurrentContext( );
1143 if( ! window->Window.Context )
1144 window->Window.Context =
1145 wglCreateContext( window->Window.Device );
1149 window->State.NeedToResize = GL_TRUE;
1150 window->State.Width = fgState.Size.X;
1151 window->State.Height = fgState.Size.Y;
1153 ReleaseDC( window->Window.Handle, window->Window.Device );
1158 * We got resized... But check if the window has been already added...
1160 window->State.NeedToResize = GL_TRUE;
1161 window->State.Width = LOWORD(lParam);
1162 window->State.Height = HIWORD(lParam);
1166 printf("WM_SETFOCUS: %p\n", window );
1167 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1171 if (LOWORD(wParam) != WA_INACTIVE)
1173 /* glutSetCursor( fgStructure.Window->State.Cursor ); */
1174 printf("WM_ACTIVATE: glutSetCursor( %p, %d)\n", window,
1175 window->State.Cursor );
1176 glutSetCursor( window->State.Cursor );
1179 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1184 * XXX Why not re-use some common code with the glutSetCursor()
1185 * XXX function (or perhaps invoke glutSetCursor())?
1186 * XXX That is, why are we duplicating code, here, from
1187 * XXX glutSetCursor()? The WIN32 code should be able to just
1188 * XXX call glutSetCurdsor() instead of defining two macros
1189 * XXX and implementing a nested case in-line.
1192 /* Set the cursor AND change it for this window class. */
1193 #define MAP_CURSOR(a,b) \
1195 SetCursor( LoadCursor( NULL, b ) ); \
1198 /* Nuke the cursor AND change it for this window class. */
1199 #define ZAP_CURSOR(a,b) \
1201 SetCursor( NULL ); \
1204 if( LOWORD( lParam ) == HTCLIENT )
1205 switch( window->State.Cursor )
1207 MAP_CURSOR( GLUT_CURSOR_RIGHT_ARROW, IDC_ARROW );
1208 MAP_CURSOR( GLUT_CURSOR_LEFT_ARROW, IDC_ARROW );
1209 MAP_CURSOR( GLUT_CURSOR_INFO, IDC_HELP );
1210 MAP_CURSOR( GLUT_CURSOR_DESTROY, IDC_CROSS );
1211 MAP_CURSOR( GLUT_CURSOR_HELP, IDC_HELP );
1212 MAP_CURSOR( GLUT_CURSOR_CYCLE, IDC_SIZEALL );
1213 MAP_CURSOR( GLUT_CURSOR_SPRAY, IDC_CROSS );
1214 MAP_CURSOR( GLUT_CURSOR_WAIT, IDC_WAIT );
1215 MAP_CURSOR( GLUT_CURSOR_TEXT, IDC_UPARROW );
1216 MAP_CURSOR( GLUT_CURSOR_CROSSHAIR, IDC_CROSS );
1217 /* MAP_CURSOR( GLUT_CURSOR_NONE, IDC_NO ); */
1218 ZAP_CURSOR( GLUT_CURSOR_NONE, NULL );
1221 MAP_CURSOR( GLUT_CURSOR_UP_DOWN, IDC_ARROW );
1224 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1228 window->State.Visible = GL_TRUE;
1229 window->State.Redisplay = GL_TRUE;
1233 /* Turn on the visibility in case it was turned off somehow */
1234 window->State.Visible = GL_TRUE;
1235 BeginPaint( hWnd, &ps );
1236 fghRedrawWindowByHandle( hWnd );
1237 EndPaint( hWnd, &ps );
1241 fgDestroyWindow ( window );
1242 if ( fgState.ActionOnWindowClose != GLUT_ACTION_CONTINUE_EXECUTION )
1248 * The window already got destroyed, so don't bother with it.
1254 window->State.MouseX = LOWORD( lParam );
1255 window->State.MouseY = HIWORD( lParam );
1257 if ( window->ActiveMenu )
1259 window->State.Redisplay = GL_TRUE;
1260 fgSetWindow ( window->ActiveMenu->ParentWindow );
1264 fgState.Modifiers = fgGetWin32Modifiers( );
1266 if( ( wParam & MK_LBUTTON ) ||
1267 ( wParam & MK_MBUTTON ) ||
1268 ( wParam & MK_RBUTTON ) )
1269 INVOKE_WCB( *window, Motion, ( window->State.MouseX,
1270 window->State.MouseY ) );
1272 INVOKE_WCB( *window, Passive, ( window->State.MouseX,
1273 window->State.MouseY ) );
1275 fgState.Modifiers = 0xffffffff;
1279 case WM_LBUTTONDOWN:
1280 case WM_MBUTTONDOWN:
1281 case WM_RBUTTONDOWN:
1286 GLboolean pressed = GL_TRUE;
1289 window->State.MouseX = LOWORD( lParam );
1290 window->State.MouseY = HIWORD( lParam );
1294 case WM_LBUTTONDOWN:
1296 button = GLUT_LEFT_BUTTON;
1298 case WM_MBUTTONDOWN:
1300 button = GLUT_MIDDLE_BUTTON;
1302 case WM_RBUTTONDOWN:
1304 button = GLUT_RIGHT_BUTTON;
1308 button = GLUT_LEFT_BUTTON;
1312 button = GLUT_MIDDLE_BUTTON;
1316 button = GLUT_RIGHT_BUTTON;
1324 if( GetSystemMetrics( SM_SWAPBUTTON ) )
1325 if( button == GLUT_LEFT_BUTTON )
1326 button = GLUT_RIGHT_BUTTON;
1327 else if( button == GLUT_RIGHT_BUTTON )
1328 button = GLUT_LEFT_BUTTON;
1331 return DefWindowProc( hWnd, uMsg, lParam, wParam );
1334 * XXX This comment is duplicated in two other spots.
1335 * XXX Can we centralize it?
1337 * Do not execute the application's mouse callback if a
1338 * menu is hooked to this button.
1339 * In that case an appropriate private call should be generated.
1340 * Near as I can tell, this is the menu behaviour:
1341 * - Down-click the menu button, menu not active: activate
1342 * the menu with its upper left-hand corner at the mouse location.
1343 * - Down-click any button outside the menu, menu active:
1344 * deactivate the menu
1345 * - Down-click any button inside the menu, menu active:
1346 * select the menu entry and deactivate the menu
1347 * - Up-click the menu button, menu not active: nothing happens
1348 * - Up-click the menu button outside the menu, menu active:
1350 * - Up-click the menu button inside the menu, menu active:
1351 * select the menu entry and deactivate the menu
1353 /* Window has an active menu, it absorbs any mouse click */
1354 if( window->ActiveMenu )
1356 /* Outside the menu, deactivate the menu if it's a downclick */
1357 if( ! fgCheckActiveMenu( window, window->ActiveMenu ) )
1360 fgDeactivateMenu( window->ActiveMenu->ParentWindow );
1362 else /* In menu, invoke the callback and deactivate the menu*/
1365 * Save the current window and menu and set the current
1366 * window to the window whose menu this is
1368 SFG_Window *save_window = fgStructure.Window;
1369 SFG_Menu *save_menu = fgStructure.Menu;
1370 SFG_Window *parent_window = window->ActiveMenu->ParentWindow;
1371 fgSetWindow( parent_window );
1372 fgStructure.Menu = window->ActiveMenu;
1374 /* Execute the menu callback */
1375 fgExecuteMenuCallback( window->ActiveMenu );
1376 fgDeactivateMenu( parent_window );
1378 /* Restore the current window and menu */
1379 fgSetWindow( save_window );
1380 fgStructure.Menu = save_menu;
1384 * Let's make the window redraw as a result of the mouse
1385 * click and menu activity.
1387 if( ! window->IsMenu )
1388 window->State.Redisplay = GL_TRUE;
1393 if ( window->Menu[ button ] && pressed )
1395 window->State.Redisplay = GL_TRUE;
1396 fgSetWindow( window );
1397 fgActivateMenu( window, button );
1402 if( ! FETCH_WCB( *window, Mouse ) )
1405 fgSetWindow( window );
1406 fgState.Modifiers = fgGetWin32Modifiers( );
1411 pressed ? GLUT_DOWN : GLUT_UP,
1412 window->State.MouseX,
1413 window->State.MouseY
1417 fgState.Modifiers = 0xffffffff;
1422 /* Should be WM_MOUSEWHEEL but my compiler doesn't recognize it */
1425 * XXX THIS IS SPECULATIVE -- John Fay, 10/2/03
1426 * XXX Should use WHEEL_DELTA instead of 120
1428 int wheel_number = LOWORD( wParam );
1429 short ticks = ( short )HIWORD( wParam ) / 120;
1439 * The mouse cursor has moved. Remember the new mouse cursor's position
1441 /* window->State.MouseX = LOWORD( lParam ); */
1442 /* Need to adjust by window position, */
1443 /* window->State.MouseY = HIWORD( lParam ); */
1444 /* change "lParam" to other parameter */
1446 if( ! FETCH_WCB( *window, MouseWheel ) &&
1447 ! FETCH_WCB( *window, Mouse ) )
1450 fgSetWindow( window );
1451 fgState.Modifiers = fgGetWin32Modifiers( );
1454 if( FETCH_WCB( *window, MouseWheel ) )
1455 INVOKE_WCB( *window, MouseWheel,
1458 window->State.MouseX,
1459 window->State.MouseY
1462 else /* No mouse wheel, call the mouse button callback twice */
1465 * XXX The below assumes that you have no more than 3 mouse
1466 * XXX buttons. Sorry.
1468 int button = wheel_number*2 + 4;
1471 INVOKE_WCB( *window, Mouse,
1472 ( button, GLUT_DOWN,
1473 window->State.MouseX, window->State.MouseY )
1475 INVOKE_WCB( *window, Mouse,
1477 window->State.MouseX, window->State.MouseX )
1481 fgState.Modifiers = 0xffffffff;
1491 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1495 * Remember the current modifiers state. This is done here in order
1496 * to make sure the VK_DELETE keyboard callback is executed properly.
1498 fgState.Modifiers = fgGetWin32Modifiers( );
1500 GetCursorPos( &mouse_pos );
1501 ScreenToClient( window->Window.Handle, &mouse_pos );
1503 window->State.MouseX = mouse_pos.x;
1504 window->State.MouseY = mouse_pos.y;
1507 * Convert the Win32 keystroke codes to GLUTtish way
1509 # define KEY(a,b) case a: keypress = b; break;
1513 KEY( VK_F1, GLUT_KEY_F1 );
1514 KEY( VK_F2, GLUT_KEY_F2 );
1515 KEY( VK_F3, GLUT_KEY_F3 );
1516 KEY( VK_F4, GLUT_KEY_F4 );
1517 KEY( VK_F5, GLUT_KEY_F5 );
1518 KEY( VK_F6, GLUT_KEY_F6 );
1519 KEY( VK_F7, GLUT_KEY_F7 );
1520 KEY( VK_F8, GLUT_KEY_F8 );
1521 KEY( VK_F9, GLUT_KEY_F9 );
1522 KEY( VK_F10, GLUT_KEY_F10 );
1523 KEY( VK_F11, GLUT_KEY_F11 );
1524 KEY( VK_F12, GLUT_KEY_F12 );
1525 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP );
1526 KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1527 KEY( VK_HOME, GLUT_KEY_HOME );
1528 KEY( VK_END, GLUT_KEY_END );
1529 KEY( VK_LEFT, GLUT_KEY_LEFT );
1530 KEY( VK_UP, GLUT_KEY_UP );
1531 KEY( VK_RIGHT, GLUT_KEY_RIGHT );
1532 KEY( VK_DOWN, GLUT_KEY_DOWN );
1533 KEY( VK_INSERT, GLUT_KEY_INSERT );
1537 * The delete key should be treated as an ASCII keypress:
1539 INVOKE_WCB( *window, Keyboard,
1540 ( 127, window->State.MouseX, window->State.MouseY )
1544 if( keypress != -1 )
1545 INVOKE_WCB( *window, Special,
1547 window->State.MouseX, window->State.MouseY )
1550 fgState.Modifiers = 0xffffffff;
1561 * Remember the current modifiers state. This is done here in order
1562 * to make sure the VK_DELETE keyboard callback is executed properly.
1564 fgState.Modifiers = fgGetWin32Modifiers( );
1566 GetCursorPos( &mouse_pos );
1567 ScreenToClient( window->Window.Handle, &mouse_pos );
1569 window->State.MouseX = mouse_pos.x;
1570 window->State.MouseY = mouse_pos.y;
1573 * Convert the Win32 keystroke codes to GLUTtish way.
1574 * "KEY(a,b)" was defined under "WM_KEYDOWN"
1579 KEY( VK_F1, GLUT_KEY_F1 );
1580 KEY( VK_F2, GLUT_KEY_F2 );
1581 KEY( VK_F3, GLUT_KEY_F3 );
1582 KEY( VK_F4, GLUT_KEY_F4 );
1583 KEY( VK_F5, GLUT_KEY_F5 );
1584 KEY( VK_F6, GLUT_KEY_F6 );
1585 KEY( VK_F7, GLUT_KEY_F7 );
1586 KEY( VK_F8, GLUT_KEY_F8 );
1587 KEY( VK_F9, GLUT_KEY_F9 );
1588 KEY( VK_F10, GLUT_KEY_F10 );
1589 KEY( VK_F11, GLUT_KEY_F11 );
1590 KEY( VK_F12, GLUT_KEY_F12 );
1591 KEY( VK_PRIOR, GLUT_KEY_PAGE_UP );
1592 KEY( VK_NEXT, GLUT_KEY_PAGE_DOWN );
1593 KEY( VK_HOME, GLUT_KEY_HOME );
1594 KEY( VK_END, GLUT_KEY_END );
1595 KEY( VK_LEFT, GLUT_KEY_LEFT );
1596 KEY( VK_UP, GLUT_KEY_UP );
1597 KEY( VK_RIGHT, GLUT_KEY_RIGHT );
1598 KEY( VK_DOWN, GLUT_KEY_DOWN );
1599 KEY( VK_INSERT, GLUT_KEY_INSERT );
1603 * The delete key should be treated as an ASCII keypress:
1605 INVOKE_WCB( *window, KeyboardUp,
1606 ( 127, window->State.MouseX, window->State.MouseY )
1615 GetKeyboardState( state );
1617 if( ToAscii( wParam, 0, state, code, 0 ) == 1 )
1620 INVOKE_WCB( *window, KeyboardUp,
1622 window->State.MouseX, window->State.MouseY )
1627 if( keypress != -1 )
1628 INVOKE_WCB( *window, SpecialUp,
1630 window->State.MouseX, window->State.MouseY )
1633 fgState.Modifiers = 0xffffffff;
1640 if( fgState.IgnoreKeyRepeat && (lParam & KF_REPEAT) )
1643 fgState.Modifiers = fgGetWin32Modifiers( );
1644 INVOKE_WCB( *window, Keyboard,
1646 window->State.MouseX, window->State.MouseY )
1648 fgState.Modifiers = 0xffffffff;
1652 case WM_CAPTURECHANGED:
1653 /* User has finished resizing the window, force a redraw */
1654 INVOKE_WCB( *window, Display, ( ) );
1656 /*lRet = DefWindowProc( hWnd, uMsg, wParam, lParam ); */
1660 * Other messages that I have seen and which are not handled already
1662 case WM_SETTEXT: /* 0x000c */
1663 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1664 /* Pass it on to "DefWindowProc" to set the window text */
1667 case WM_GETTEXT: /* 0x000d */
1668 /* Ideally we would copy the title of the window into "lParam" */
1669 /* strncpy ( (char *)lParam, "Window Title", wParam );
1670 lRet = ( wParam > 12 ) ? 12 : wParam; */
1671 /* the number of characters copied */
1672 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1675 case WM_GETTEXTLENGTH: /* 0x000e */
1676 /* Ideally we would get the length of the title of the window */
1678 /* the number of characters in "Window Title\0" (see above) */
1681 case WM_ERASEBKGND: /* 0x0014 */
1682 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1685 case WM_SYNCPAINT: /* 0x0088 */
1686 /* Another window has moved, need to update this one */
1687 window->State.Redisplay = GL_TRUE;
1688 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1689 /* Help screen says this message must be passed to "DefWindowProc" */
1692 case WM_NCPAINT: /* 0x0085 */
1693 /* Need to update the border of this window */
1694 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1695 /* Pass it on to "DefWindowProc" to repaint a standard border */
1698 case WM_SYSCOMMAND : /* 0x0112 */
1701 * We have received a system command message. Try to act on it.
1702 * The commands are passed in through the "lParam" parameter:
1703 * Clicking on a corner to resize the window gives a "F004" message
1704 * but this is not defined in my header file.
1715 /* User has clicked on the "-" to minimize the window */
1716 /* Turn off the visibility */
1717 window->State.Visible = GL_FALSE ;
1724 case SC_NEXTWINDOW :
1727 case SC_PREVWINDOW :
1731 /* Followed very closely by a WM_CLOSE message */
1755 case SC_SCREENSAVE :
1763 /* We need to pass the message on to the operating system as well */
1764 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1769 * Handle unhandled messages
1771 lRet = DefWindowProc( hWnd, uMsg, wParam, lParam );
1779 /*** END OF FILE ***/