board/MAI/bios_emulator/scitech/src/pm/win32/event.c - uboot/mindspeed - Git at Google

 /****************************************************************************
 *
 *                   SciTech Multi-platform Graphics Library
 *
 *  ========================================================================
 *
 *    The contents of this file are subject to the SciTech MGL Public
 *    License Version 1.0 (the "License"); you may not use this file
 *    except in compliance with the License. You may obtain a copy of
 *    the License at http://www.scitechsoft.com/mgl-license.txt
 *
 *    Software distributed under the License is distributed on an
 *    "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 *    implied. See the License for the specific language governing
 *    rights and limitations under the License.
 *
 *    The Original Code is Copyright (C) 1991-1998 SciTech Software, Inc.
 *
 *    The Initial Developer of the Original Code is SciTech Software, Inc.
 *    All Rights Reserved.
 *
 *  ========================================================================
 *
 * Language:     ANSI C
 * Environment:  Win32
 *
 * Description:  Win32 implementation for the SciTech cross platform
 *               event library.
 *
 ****************************************************************************/

 /*---------------------------- Global Variables ---------------------------*/

 static ushort   keyUpMsg[256] = {0};    /* Table of key up messages     */
 static int      rangeX,rangeY;          /* Range of mouse coordinates   */

 /*---------------------------- Implementation -----------------------------*/

 /* These are not used under Win32 */
 #define _EVT_disableInt()       1
 #define _EVT_restoreInt(flags)  (void)(flags)

 /****************************************************************************
 PARAMETERS:
 scanCode    - Scan code to test

 REMARKS:
 This macro determines if a specified key is currently down at the
 time that the call is made.
 ****************************************************************************/
 #define _EVT_isKeyDown(scanCode)    (keyUpMsg[scanCode] != 0)

 /****************************************************************************
 REMARKS:
 This function is used to return the number of ticks since system
 startup in milliseconds. This should be the same value that is placed into
 the time stamp fields of events, and is used to implement auto mouse down
 events.
 ****************************************************************************/
 ulong _EVT_getTicks(void)
 { return timeGetTime(); }

 /****************************************************************************
 REMARKS:
 Pumps all messages in the message queue from Win32 into our event queue.
 ****************************************************************************/
 void _EVT_pumpMessages(void)
 {
     MSG     msg;
     MSG     charMsg;
     event_t evt;

     /* TODO: Add support for DirectInput! We can't support relative mouse */
     /*       movement motion counters without DirectInput ;-(. */
     while (PeekMessage(&msg,NULL,0,0,PM_REMOVE)) {
 	memset(&evt,0,sizeof(evt));
 	switch (msg.message) {
 	    case WM_MOUSEMOVE:
 		evt.what = EVT_MOUSEMOVE;
 		break;
 	    case WM_LBUTTONDBLCLK:
 		evt.what = EVT_MOUSEDOWN;
 		evt.message = EVT_LEFTBMASK | EVT_DBLCLICK;
 		break;
 	    case WM_LBUTTONDOWN:
 		evt.what = EVT_MOUSEDOWN;
 		evt.message = EVT_LEFTBMASK;
 		break;
 	    case WM_LBUTTONUP:
 		evt.what = EVT_MOUSEUP;
 		evt.message = EVT_LEFTBMASK;
 		break;
 	    case WM_RBUTTONDBLCLK:
 		evt.what = EVT_MOUSEDOWN | EVT_DBLCLICK;
 		evt.message = EVT_RIGHTBMASK;
 		break;
 	    case WM_RBUTTONDOWN:
 		evt.what = EVT_MOUSEDOWN;
 		evt.message = EVT_RIGHTBMASK;
 		break;
 	    case WM_RBUTTONUP:
 		evt.what = EVT_MOUSEUP;
 		evt.message = EVT_RIGHTBMASK;
 		break;
 	    case WM_MBUTTONDBLCLK:
 		evt.what = EVT_MOUSEDOWN | EVT_DBLCLICK;
 		evt.message = EVT_MIDDLEBMASK;
 		break;
 	    case WM_MBUTTONDOWN:
 		evt.what = EVT_MOUSEDOWN;
 		evt.message = EVT_MIDDLEBMASK;
 		break;
 	    case WM_MBUTTONUP:
 		evt.what = EVT_MOUSEUP;
 		evt.message = EVT_MIDDLEBMASK;
 		break;
 	    case WM_KEYDOWN:
 	    case WM_SYSKEYDOWN:
 		if (HIWORD(msg.lParam) & KF_REPEAT) {
 		    evt.what = EVT_KEYREPEAT;
 		    }
 		else {
 		    evt.what = EVT_KEYDOWN;
 		    }
 		break;
 	    case WM_KEYUP:
 	    case WM_SYSKEYUP:
 		evt.what = EVT_KEYUP;
 		break;
 	    }

 	/* Convert mouse event modifier flags */
 	if (evt.what & EVT_MOUSEEVT) {
 	    if (_PM_deskX) {
 		evt.where_x = ((long)msg.pt.x * rangeX) / _PM_deskX;
 		evt.where_y = ((long)msg.pt.y * rangeY) / _PM_deskY;
 		}
 	    else {
 		ScreenToClient(_PM_hwndConsole, &msg.pt);
 		evt.where_x = msg.pt.x;
 		evt.where_y = msg.pt.y;
 		}
 	    if (evt.what == EVT_MOUSEMOVE) {
 		/* Save the current mouse position */
 		EVT.mx = evt.where_x;
 		EVT.my = evt.where_y;
 		if (EVT.oldMove != -1) {
 		    EVT.evtq[EVT.oldMove].where_x = evt.where_x;/* Modify existing one  */
 		    EVT.evtq[EVT.oldMove].where_y = evt.where_y;
 /*                  EVT.evtq[EVT.oldMove].relative_x += mickeyX;    / / TODO! */
 /*                  EVT.evtq[EVT.oldMove].relative_y += mickeyY;    / / TODO! */
 		    evt.what = 0;
 		    }
 		else {
 		    EVT.oldMove = EVT.freeHead; /* Save id of this move event   */
 /*                  evt.relative_x = mickeyX;    / / TODO! */
 /*                  evt.relative_y = mickeyY;    / / TODO! */
 		    }
 		}
 	    else
 		EVT.oldMove = -1;
 	    if (msg.wParam & MK_LBUTTON)
 		evt.modifiers |= EVT_LEFTBUT;
 	    if (msg.wParam & MK_RBUTTON)
 		evt.modifiers |= EVT_RIGHTBUT;
 	    if (msg.wParam & MK_MBUTTON)
 		evt.modifiers |= EVT_MIDDLEBUT;
 	    if (msg.wParam & MK_SHIFT)
 		evt.modifiers |= EVT_SHIFTKEY;
 	    if (msg.wParam & MK_CONTROL)
 		evt.modifiers |= EVT_CTRLSTATE;
 	    }

 	/* Convert keyboard codes */
 	TranslateMessage(&msg);
 	if (evt.what & EVT_KEYEVT) {
 	    int scanCode = (msg.lParam >> 16) & 0xFF;
 	    if (evt.what == EVT_KEYUP) {
 		/* Get message for keyup code from table of cached down values */
 		evt.message = keyUpMsg[scanCode];
 		keyUpMsg[scanCode] = 0;
 		}
 	    else {
 		if (PeekMessage(&charMsg,NULL,WM_CHAR,WM_CHAR,PM_REMOVE))
 		    evt.message = charMsg.wParam;
 		if (PeekMessage(&charMsg,NULL,WM_SYSCHAR,WM_SYSCHAR,PM_REMOVE))
 		    evt.message = charMsg.wParam;
 		evt.message |= ((msg.lParam >> 8) & 0xFF00);
 		keyUpMsg[scanCode] = (ushort)evt.message;
 		}
 	    if (evt.what == EVT_KEYREPEAT)
 		evt.message |= (msg.lParam << 16);
 	    if (HIWORD(msg.lParam) & KF_ALTDOWN)
 		evt.modifiers |= EVT_ALTSTATE;
 	    if (GetKeyState(VK_SHIFT) & 0x8000U)
 		evt.modifiers |= EVT_SHIFTKEY;
 	    if (GetKeyState(VK_CONTROL) & 0x8000U)
 		evt.modifiers |= EVT_CTRLSTATE;
 	    EVT.oldMove = -1;
 	    }

 	if (evt.what != 0) {
 	    /* Add time stamp and add the event to the queue */
 	    evt.when = msg.time;
 	    if (EVT.count < EVENTQSIZE)
 		addEvent(&evt);
 	    }
 	DispatchMessage(&msg);
 	}
 }

 /****************************************************************************
 REMARKS:
 This macro/function is used to converts the scan codes reported by the
 keyboard to our event libraries normalised format. We only have one scan
 code for the 'A' key, and use shift modifiers to determine if it is a
 Ctrl-F1, Alt-F1 etc. The raw scan codes from the keyboard work this way,
 but the OS gives us 'cooked' scan codes, we have to translate them back
 to the raw format.
 ****************************************************************************/
 #define _EVT_maskKeyCode(evt)

 /****************************************************************************
 REMARKS:
 Safely abort the event module upon catching a fatal error.
 ****************************************************************************/
 void _EVT_abort(
     int signal)
 {
     (void)signal;
     EVT_exit();
     PM_fatalError("Unhandled exception!");
 }

 /****************************************************************************
 PARAMETERS:
 mouseMove   - Callback function to call wheneve the mouse needs to be moved

 REMARKS:
 Initiliase the event handling module. Here we install our mouse handling ISR
 to be called whenever any button's are pressed or released. We also build
 the free list of events in the event queue.

 We use handler number 2 of the mouse libraries interrupt handlers for our
 event handling routines.
 ****************************************************************************/
 void EVTAPI EVT_init(
     _EVT_mouseMoveHandler mouseMove)
 {
     /* Initialise the event queue */
     EVT.mouseMove = mouseMove;
     initEventQueue();
     memset(keyUpMsg,0,sizeof(keyUpMsg));

     /* Catch program termination signals so we can clean up properly */
     signal(SIGABRT, _EVT_abort);
     signal(SIGFPE, _EVT_abort);
     signal(SIGINT, _EVT_abort);
 }

 /****************************************************************************
 REMARKS
 Changes the range of coordinates returned by the mouse functions to the
 specified range of values. This is used when changing between graphics
 modes set the range of mouse coordinates for the new display mode.
 ****************************************************************************/
 void EVTAPI EVT_setMouseRange(
     int xRes,
     int yRes)
 {
     rangeX = xRes;
     rangeY = yRes;
 }

 /****************************************************************************
 REMARKS
 Modifes the mouse coordinates as necessary if scaling to OS coordinates,
 and sets the OS mouse cursor position.
 ****************************************************************************/
 void _EVT_setMousePos(
     int *x,
     int *y)
 {
     /* Scale coordinates up to desktop coordinates first */
     int scaledX = (*x * _PM_deskX) / rangeX;
     int scaledY = (*y * _PM_deskY) / rangeY;

     /* Scale coordinates back to screen coordinates again */
     *x = (scaledX * rangeX) / _PM_deskX;
     *y = (scaledY * rangeY) / _PM_deskY;
     SetCursorPos(scaledX,scaledY);
 }

 /****************************************************************************
 REMARKS:
 Initiailises the internal event handling modules. The EVT_suspend function
 can be called to suspend event handling (such as when shelling out to DOS),
 and this function can be used to resume it again later.
 ****************************************************************************/
 void EVT_resume(void)
 {
     /* Do nothing for Win32 */
 }

 /****************************************************************************
 REMARKS
 Suspends all of our event handling operations. This is also used to
 de-install the event handling code.
 ****************************************************************************/
 void EVT_suspend(void)
 {
     /* Do nothing for Win32 */
 }

 /****************************************************************************
 REMARKS
 Exits the event module for program terminatation.
 ****************************************************************************/
 void EVT_exit(void)
 {
     /* Restore signal handlers */
     signal(SIGABRT, SIG_DFL);
     signal(SIGFPE, SIG_DFL);
     signal(SIGINT, SIG_DFL);
 }

 /****************************************************************************
 DESCRIPTION:
 Returns the mask indicating what joystick axes are attached.

 HEADER:
 event.h

 REMARKS:
 This function is used to detect the attached joysticks, and determine
 what axes are present and functioning. This function will re-detect any
 attached joysticks when it is called, so if the user forgot to attach
 the joystick when the application started, you can call this function to
 re-detect any newly attached joysticks.

 SEE ALSO:
 EVT_joySetLowerRight, EVT_joySetCenter, EVT_joyIsPresent
 ****************************************************************************/
 int EVTAPI EVT_joyIsPresent(void)
 {
     /* TODO: Implement joystick code based on DirectX! */
     return 0;
 }

 /****************************************************************************
 DESCRIPTION:
 Polls the joystick for position and button information.

 HEADER:
 event.h

 REMARKS:
 This routine is used to poll analogue joysticks for button and position
 information. It should be called once for each main loop of the user
 application, just before processing all pending events via EVT_getNext.
 All information polled from the joystick will be posted to the event
 queue for later retrieval.

 Note:   Most analogue joysticks will provide readings that change even
 	though the joystick has not moved. Hence if you call this routine
 	you will likely get an EVT_JOYMOVE event every time through your
 	event loop.

 SEE ALSO:
 EVT_getNext, EVT_peekNext, EVT_joySetUpperLeft, EVT_joySetLowerRight,
 EVT_joySetCenter, EVT_joyIsPresent
 ****************************************************************************/
 void EVTAPI EVT_pollJoystick(void)
 {
 }

 /****************************************************************************
 DESCRIPTION:
 Calibrates the joystick upper left position

 HEADER:
 event.h

 REMARKS:
 This function can be used to zero in on better joystick calibration factors,
 which may work better than the default simplistic calibration (which assumes
 the joystick is centered when the event library is initialised).
 To use this function, ask the user to hold the stick in the upper left
 position and then have them press a key or button. and then call this
 function. This function will then read the joystick and update the
 calibration factors.

 Usually, assuming that the stick was centered when the event library was
 initialized, you really only need to call EVT_joySetLowerRight since the
 upper left position is usually always 0,0 on most joysticks. However, the
 safest procedure is to call all three calibration functions.

 SEE ALSO:
 EVT_joySetUpperLeft, EVT_joySetLowerRight, EVT_joyIsPresent
 ****************************************************************************/
 void EVTAPI EVT_joySetUpperLeft(void)
 {
 }

 /****************************************************************************
 DESCRIPTION:
 Calibrates the joystick lower right position

 HEADER:
 event.h

 REMARKS:
 This function can be used to zero in on better joystick calibration factors,
 which may work better than the default simplistic calibration (which assumes
 the joystick is centered when the event library is initialised).
 To use this function, ask the user to hold the stick in the lower right
 position and then have them press a key or button. and then call this
 function. This function will then read the joystick and update the
 calibration factors.

 Usually, assuming that the stick was centered when the event library was
 initialized, you really only need to call EVT_joySetLowerRight since the
 upper left position is usually always 0,0 on most joysticks. However, the
 safest procedure is to call all three calibration functions.

 SEE ALSO:
 EVT_joySetUpperLeft, EVT_joySetCenter, EVT_joyIsPresent
 ****************************************************************************/
 void EVTAPI EVT_joySetLowerRight(void)
 {
 }

 /****************************************************************************
 DESCRIPTION:
 Calibrates the joystick center position

 HEADER:
 event.h

 REMARKS:
 This function can be used to zero in on better joystick calibration factors,
 which may work better than the default simplistic calibration (which assumes
 the joystick is centered when the event library is initialised).
 To use this function, ask the user to hold the stick in the center
 position and then have them press a key or button. and then call this
 function. This function will then read the joystick and update the
 calibration factors.

 Usually, assuming that the stick was centered when the event library was
 initialized, you really only need to call EVT_joySetLowerRight since the
 upper left position is usually always 0,0 on most joysticks. However, the
 safest procedure is to call all three calibration functions.

 SEE ALSO:
 EVT_joySetUpperLeft, EVT_joySetLowerRight, EVT_joySetCenter
 ****************************************************************************/
 void EVTAPI EVT_joySetCenter(void)
 {
 }
	/****************************************************************************
	*
	* SciTech Multi-platform Graphics Library
	*
	* ========================================================================
	*
	* The contents of this file are subject to the SciTech MGL Public
	* License Version 1.0 (the "License"); you may not use this file
	* except in compliance with the License. You may obtain a copy of
	* the License at http://www.scitechsoft.com/mgl-license.txt
	*
	* Software distributed under the License is distributed on an
	* "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
	* implied. See the License for the specific language governing
	* rights and limitations under the License.
	*
	* The Original Code is Copyright (C) 1991-1998 SciTech Software, Inc.
	*
	* The Initial Developer of the Original Code is SciTech Software, Inc.
	* All Rights Reserved.
	*
	* ========================================================================
	*
	* Language: ANSI C
	* Environment: Win32
	*
	* Description: Win32 implementation for the SciTech cross platform
	* event library.
	*
	****************************************************************************/

	/---------------------------- Global Variables ---------------------------/

	static ushort keyUpMsg[256] = {0}; /* Table of key up messages */
	static int rangeX,rangeY; /* Range of mouse coordinates */

	/---------------------------- Implementation -----------------------------/

	/* These are not used under Win32 */
	#define _EVT_disableInt() 1
	#define _EVT_restoreInt(flags) (void)(flags)

	/****************************************************************************
	PARAMETERS:
	scanCode - Scan code to test

	REMARKS:
	This macro determines if a specified key is currently down at the
	time that the call is made.
	****************************************************************************/
	#define _EVT_isKeyDown(scanCode) (keyUpMsg[scanCode] != 0)

	/****************************************************************************
	REMARKS:
	This function is used to return the number of ticks since system
	startup in milliseconds. This should be the same value that is placed into
	the time stamp fields of events, and is used to implement auto mouse down
	events.
	****************************************************************************/
	ulong _EVT_getTicks(void)
	{ return timeGetTime(); }

	/****************************************************************************
	REMARKS:
	Pumps all messages in the message queue from Win32 into our event queue.
	****************************************************************************/
	void _EVT_pumpMessages(void)
	{
	MSG msg;
	MSG charMsg;
	event_t evt;

	/* TODO: Add support for DirectInput! We can't support relative mouse */
	/* movement motion counters without DirectInput ;-(. */
	while (PeekMessage(&msg,NULL,0,0,PM_REMOVE)) {
	memset(&evt,0,sizeof(evt));
	switch (msg.message) {
	case WM_MOUSEMOVE:
	evt.what = EVT_MOUSEMOVE;
	break;
	case WM_LBUTTONDBLCLK:
	evt.what = EVT_MOUSEDOWN;
	evt.message = EVT_LEFTBMASK \| EVT_DBLCLICK;
	break;
	case WM_LBUTTONDOWN:
	evt.what = EVT_MOUSEDOWN;
	evt.message = EVT_LEFTBMASK;
	break;
	case WM_LBUTTONUP:
	evt.what = EVT_MOUSEUP;
	evt.message = EVT_LEFTBMASK;
	break;
	case WM_RBUTTONDBLCLK:
	evt.what = EVT_MOUSEDOWN \| EVT_DBLCLICK;
	evt.message = EVT_RIGHTBMASK;
	break;
	case WM_RBUTTONDOWN:
	evt.what = EVT_MOUSEDOWN;
	evt.message = EVT_RIGHTBMASK;
	break;
	case WM_RBUTTONUP:
	evt.what = EVT_MOUSEUP;
	evt.message = EVT_RIGHTBMASK;
	break;
	case WM_MBUTTONDBLCLK:
	evt.what = EVT_MOUSEDOWN \| EVT_DBLCLICK;
	evt.message = EVT_MIDDLEBMASK;
	break;
	case WM_MBUTTONDOWN:
	evt.what = EVT_MOUSEDOWN;
	evt.message = EVT_MIDDLEBMASK;
	break;
	case WM_MBUTTONUP:
	evt.what = EVT_MOUSEUP;
	evt.message = EVT_MIDDLEBMASK;
	break;
	case WM_KEYDOWN:
	case WM_SYSKEYDOWN:
	if (HIWORD(msg.lParam) & KF_REPEAT) {
	evt.what = EVT_KEYREPEAT;
	}
	else {
	evt.what = EVT_KEYDOWN;
	}
	break;
	case WM_KEYUP:
	case WM_SYSKEYUP:
	evt.what = EVT_KEYUP;
	break;
	}

	/* Convert mouse event modifier flags */
	if (evt.what & EVT_MOUSEEVT) {
	if (_PM_deskX) {
	evt.where_x = ((long)msg.pt.x * rangeX) / _PM_deskX;
	evt.where_y = ((long)msg.pt.y * rangeY) / _PM_deskY;
	}
	else {
	ScreenToClient(_PM_hwndConsole, &msg.pt);
	evt.where_x = msg.pt.x;
	evt.where_y = msg.pt.y;
	}
	if (evt.what == EVT_MOUSEMOVE) {
	/* Save the current mouse position */
	EVT.mx = evt.where_x;
	EVT.my = evt.where_y;
	if (EVT.oldMove != -1) {
	EVT.evtq[EVT.oldMove].where_x = evt.where_x;/* Modify existing one */
	EVT.evtq[EVT.oldMove].where_y = evt.where_y;
	/* EVT.evtq[EVT.oldMove].relative_x += mickeyX; / / TODO! */
	/* EVT.evtq[EVT.oldMove].relative_y += mickeyY; / / TODO! */
	evt.what = 0;
	}
	else {
	EVT.oldMove = EVT.freeHead; /* Save id of this move event */
	/* evt.relative_x = mickeyX; / / TODO! */
	/* evt.relative_y = mickeyY; / / TODO! */
	}
	}
	else
	EVT.oldMove = -1;
	if (msg.wParam & MK_LBUTTON)
	evt.modifiers \|= EVT_LEFTBUT;
	if (msg.wParam & MK_RBUTTON)
	evt.modifiers \|= EVT_RIGHTBUT;
	if (msg.wParam & MK_MBUTTON)
	evt.modifiers \|= EVT_MIDDLEBUT;
	if (msg.wParam & MK_SHIFT)
	evt.modifiers \|= EVT_SHIFTKEY;
	if (msg.wParam & MK_CONTROL)
	evt.modifiers \|= EVT_CTRLSTATE;
	}

	/* Convert keyboard codes */
	TranslateMessage(&msg);
	if (evt.what & EVT_KEYEVT) {
	int scanCode = (msg.lParam >> 16) & 0xFF;
	if (evt.what == EVT_KEYUP) {
	/* Get message for keyup code from table of cached down values */
	evt.message = keyUpMsg[scanCode];
	keyUpMsg[scanCode] = 0;
	}
	else {
	if (PeekMessage(&charMsg,NULL,WM_CHAR,WM_CHAR,PM_REMOVE))
	evt.message = charMsg.wParam;
	if (PeekMessage(&charMsg,NULL,WM_SYSCHAR,WM_SYSCHAR,PM_REMOVE))
	evt.message = charMsg.wParam;
	evt.message \|= ((msg.lParam >> 8) & 0xFF00);
	keyUpMsg[scanCode] = (ushort)evt.message;
	}
	if (evt.what == EVT_KEYREPEAT)
	evt.message \|= (msg.lParam << 16);
	if (HIWORD(msg.lParam) & KF_ALTDOWN)
	evt.modifiers \|= EVT_ALTSTATE;
	if (GetKeyState(VK_SHIFT) & 0x8000U)
	evt.modifiers \|= EVT_SHIFTKEY;
	if (GetKeyState(VK_CONTROL) & 0x8000U)
	evt.modifiers \|= EVT_CTRLSTATE;
	EVT.oldMove = -1;
	}

	if (evt.what != 0) {
	/* Add time stamp and add the event to the queue */
	evt.when = msg.time;
	if (EVT.count < EVENTQSIZE)
	addEvent(&evt);
	}
	DispatchMessage(&msg);
	}
	}

	/****************************************************************************
	REMARKS:
	This macro/function is used to converts the scan codes reported by the
	keyboard to our event libraries normalised format. We only have one scan
	code for the 'A' key, and use shift modifiers to determine if it is a
	Ctrl-F1, Alt-F1 etc. The raw scan codes from the keyboard work this way,
	but the OS gives us 'cooked' scan codes, we have to translate them back
	to the raw format.
	****************************************************************************/
	#define _EVT_maskKeyCode(evt)

	/****************************************************************************
	REMARKS:
	Safely abort the event module upon catching a fatal error.
	****************************************************************************/
	void _EVT_abort(
	int signal)
	{
	(void)signal;
	EVT_exit();
	PM_fatalError("Unhandled exception!");
	}

	/****************************************************************************
	PARAMETERS:
	mouseMove - Callback function to call wheneve the mouse needs to be moved

	REMARKS:
	Initiliase the event handling module. Here we install our mouse handling ISR
	to be called whenever any button's are pressed or released. We also build
	the free list of events in the event queue.

	We use handler number 2 of the mouse libraries interrupt handlers for our
	event handling routines.
	****************************************************************************/
	void EVTAPI EVT_init(
	_EVT_mouseMoveHandler mouseMove)
	{
	/* Initialise the event queue */
	EVT.mouseMove = mouseMove;
	initEventQueue();
	memset(keyUpMsg,0,sizeof(keyUpMsg));

	/* Catch program termination signals so we can clean up properly */
	signal(SIGABRT, _EVT_abort);
	signal(SIGFPE, _EVT_abort);
	signal(SIGINT, _EVT_abort);
	}

	/****************************************************************************
	REMARKS
	Changes the range of coordinates returned by the mouse functions to the
	specified range of values. This is used when changing between graphics
	modes set the range of mouse coordinates for the new display mode.
	****************************************************************************/
	void EVTAPI EVT_setMouseRange(
	int xRes,
	int yRes)
	{
	rangeX = xRes;
	rangeY = yRes;
	}

	/****************************************************************************
	REMARKS
	Modifes the mouse coordinates as necessary if scaling to OS coordinates,
	and sets the OS mouse cursor position.
	****************************************************************************/
	void _EVT_setMousePos(
	int *x,
	int *y)
	{
	/* Scale coordinates up to desktop coordinates first */
	int scaledX = (x _PM_deskX) / rangeX;
	int scaledY = (y _PM_deskY) / rangeY;

	/* Scale coordinates back to screen coordinates again */
	x = (scaledX rangeX) / _PM_deskX;
	y = (scaledY rangeY) / _PM_deskY;
	SetCursorPos(scaledX,scaledY);
	}

	/****************************************************************************
	REMARKS:
	Initiailises the internal event handling modules. The EVT_suspend function
	can be called to suspend event handling (such as when shelling out to DOS),
	and this function can be used to resume it again later.
	****************************************************************************/
	void EVT_resume(void)
	{
	/* Do nothing for Win32 */
	}

	/****************************************************************************
	REMARKS
	Suspends all of our event handling operations. This is also used to
	de-install the event handling code.
	****************************************************************************/
	void EVT_suspend(void)
	{
	/* Do nothing for Win32 */
	}

	/****************************************************************************
	REMARKS
	Exits the event module for program terminatation.
	****************************************************************************/
	void EVT_exit(void)
	{
	/* Restore signal handlers */
	signal(SIGABRT, SIG_DFL);
	signal(SIGFPE, SIG_DFL);
	signal(SIGINT, SIG_DFL);
	}

	/****************************************************************************
	DESCRIPTION:
	Returns the mask indicating what joystick axes are attached.

	HEADER:
	event.h

	REMARKS:
	This function is used to detect the attached joysticks, and determine
	what axes are present and functioning. This function will re-detect any
	attached joysticks when it is called, so if the user forgot to attach
	the joystick when the application started, you can call this function to
	re-detect any newly attached joysticks.

	SEE ALSO:
	EVT_joySetLowerRight, EVT_joySetCenter, EVT_joyIsPresent
	****************************************************************************/
	int EVTAPI EVT_joyIsPresent(void)
	{
	/* TODO: Implement joystick code based on DirectX! */
	return 0;
	}

	/****************************************************************************
	DESCRIPTION:
	Polls the joystick for position and button information.

	HEADER:
	event.h

	REMARKS:
	This routine is used to poll analogue joysticks for button and position
	information. It should be called once for each main loop of the user
	application, just before processing all pending events via EVT_getNext.
	All information polled from the joystick will be posted to the event
	queue for later retrieval.

	Note: Most analogue joysticks will provide readings that change even
	though the joystick has not moved. Hence if you call this routine
	you will likely get an EVT_JOYMOVE event every time through your
	event loop.

	SEE ALSO:
	EVT_getNext, EVT_peekNext, EVT_joySetUpperLeft, EVT_joySetLowerRight,
	EVT_joySetCenter, EVT_joyIsPresent
	****************************************************************************/
	void EVTAPI EVT_pollJoystick(void)
	{
	}

	/****************************************************************************
	DESCRIPTION:
	Calibrates the joystick upper left position

	HEADER:
	event.h

	REMARKS:
	This function can be used to zero in on better joystick calibration factors,
	which may work better than the default simplistic calibration (which assumes
	the joystick is centered when the event library is initialised).
	To use this function, ask the user to hold the stick in the upper left
	position and then have them press a key or button. and then call this
	function. This function will then read the joystick and update the
	calibration factors.

	Usually, assuming that the stick was centered when the event library was
	initialized, you really only need to call EVT_joySetLowerRight since the
	upper left position is usually always 0,0 on most joysticks. However, the
	safest procedure is to call all three calibration functions.

	SEE ALSO:
	EVT_joySetUpperLeft, EVT_joySetLowerRight, EVT_joyIsPresent
	****************************************************************************/
	void EVTAPI EVT_joySetUpperLeft(void)
	{
	}

	/****************************************************************************
	DESCRIPTION:
	Calibrates the joystick lower right position

	HEADER:
	event.h

	REMARKS:
	This function can be used to zero in on better joystick calibration factors,
	which may work better than the default simplistic calibration (which assumes
	the joystick is centered when the event library is initialised).
	To use this function, ask the user to hold the stick in the lower right
	position and then have them press a key or button. and then call this
	function. This function will then read the joystick and update the
	calibration factors.

	Usually, assuming that the stick was centered when the event library was
	initialized, you really only need to call EVT_joySetLowerRight since the
	upper left position is usually always 0,0 on most joysticks. However, the
	safest procedure is to call all three calibration functions.

	SEE ALSO:
	EVT_joySetUpperLeft, EVT_joySetCenter, EVT_joyIsPresent
	****************************************************************************/
	void EVTAPI EVT_joySetLowerRight(void)
	{
	}

	/****************************************************************************
	DESCRIPTION:
	Calibrates the joystick center position

	HEADER:
	event.h

	REMARKS:
	This function can be used to zero in on better joystick calibration factors,
	which may work better than the default simplistic calibration (which assumes
	the joystick is centered when the event library is initialised).
	To use this function, ask the user to hold the stick in the center
	position and then have them press a key or button. and then call this
	function. This function will then read the joystick and update the
	calibration factors.

	Usually, assuming that the stick was centered when the event library was
	initialized, you really only need to call EVT_joySetLowerRight since the
	upper left position is usually always 0,0 on most joysticks. However, the
	safest procedure is to call all three calibration functions.

	SEE ALSO:
	EVT_joySetUpperLeft, EVT_joySetLowerRight, EVT_joySetCenter
	****************************************************************************/
	void EVTAPI EVT_joySetCenter(void)
	{
	}