Mercurial > sdl-ios-xcode
view src/events/SDL_mouse_c.h @ 2268:4baee598306d
Date: Thu, 05 Jul 2007 14:02:33 -0700
From: Sam Lantinga
Subject: SDL 1.3 keyboard plan
After lots of discussion with Christian, this is what we came up with:
> So, to sum up...
> SDLK_* become the physical keys, starting at > (1<<21)
> We create a macro SDLK_INDEX(X)
> We have two functions SDL_GetLayoutKey(SDLKey) and SDL_GetKeyName()
> SDL_GetLayoutKey maps to UCS4 for printable characters, and SDLK* for
non-printable characters
> and does so based on the OS's current keyboard layout
> SDL_GetKeyName() handles both SDLK_* and UCS4, converting UCS4 to UTF-8 and
converting SDLK_* into our names, which are UTF-8 for printable characters.
> WASD folks use SDLK_*, and 'I' folks use SDL_GetLayoutKey(SDLK_*)
Here is the patch he came up with, and his e-mail about it:
Date: Fri, 17 Aug 2007 19:50:28 +0200
From: Christian Walther
Subject: Re: SDL 1.3 keyboard plan
> Sounds great, go ahead and send me a patch.
Here goes! Thanks for having a look. Don't hesitate to comment if
anything does not conform to your ideas.
One caveat: Committing this now may break compilability of some video
drivers - specifically, if they use any of the SDLK_* codes that were
obsoleted and moved into SDL_compat.h. I only tried Cocoa (which did
break, but is already fixed) and X11 (which didn't, but then its key
handling is #iffed out). If that's a problem, it may need to go into
a branch.
-Christian
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Sun, 19 Aug 2007 14:52:52 +0000 |
parents | 003c1b5b07da |
children | 44e49d3fa6cf 64f346a83ed3 |
line wrap: on
line source
/* SDL - Simple DirectMedia Layer Copyright (C) 1997-2006 Sam Lantinga This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Sam Lantinga slouken@libsdl.org */ #include "SDL_config.h" #ifndef _SDL_mouse_c_h #define _SDL_mouse_c_h typedef struct SDL_Mouse SDL_Mouse; struct SDL_Cursor { SDL_Mouse *mouse; SDL_Cursor *next; void *driverdata; }; struct SDL_Mouse { /* Create a cursor from a surface */ SDL_Cursor *(*CreateCursor) (SDL_Surface * surface, int hot_x, int hot_y); /* Show the specified cursor, or hide if cursor is NULL */ int (*ShowCursor) (SDL_Cursor * cursor); /* This is called when a mouse motion event occurs */ void (*MoveCursor) (SDL_Cursor * cursor); /* Free a window manager cursor */ void (*FreeCursor) (SDL_Cursor * cursor); /* Warp the mouse to (x,y) */ void (*WarpMouse) (SDL_Mouse * mouse, SDL_WindowID windowID, int x, int y); /* Free the mouse when it's time */ void (*FreeMouse) (SDL_Mouse * mouse); /* Data common to all mice */ SDL_WindowID focus; int x; int y; int xdelta; int ydelta; Uint8 buttonstate; SDL_bool relative_mode; SDL_bool flush_motion; SDL_Cursor *cursors; SDL_Cursor *def_cursor; SDL_Cursor *cur_cursor; SDL_bool cursor_shown; void *driverdata; }; /* Initialize the mouse subsystem */ extern int SDL_MouseInit(void); /* Get the mouse at an index */ extern SDL_Mouse *SDL_GetMouse(int index); /* Add a mouse, possibly reattaching at a particular index (or -1), returning the index of the mouse, or -1 if there was an error. */ extern int SDL_AddMouse(const SDL_Mouse * mouse, int index); /* Remove a mouse at an index, clearing the slot for later */ extern void SDL_DelMouse(int index); /* Clear the button state of a mouse at an index */ extern void SDL_ResetMouse(int index); /* Set the mouse focus window */ extern void SDL_SetMouseFocus(int index, SDL_WindowID windowID); /* Send a mouse motion event for a mouse at an index */ extern int SDL_SendMouseMotion(int index, int relative, int x, int y); /* Send a mouse button event for a mouse at an index */ extern int SDL_SendMouseButton(int index, Uint8 state, Uint8 button); /* Send a mouse wheel event for a mouse at an index */ extern int SDL_SendMouseWheel(int index, int x, int y); /* Shutdown the mouse subsystem */ extern void SDL_MouseQuit(void); #endif /* _SDL_mouse_c_h */ /* vi: set ts=4 sw=4 expandtab: */