Mercurial > sdl-ios-xcode
view docs/index.html @ 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 | c6a447c98584 |
| children |
line wrap: on
line source
<!DOCTYPE HTML PUBLIC "-//Norman Walsh//DTD DocBook HTML 1.0//EN"> <HTML> <HEAD><TITLE>Simple DirectMedia Layer Introduction</TITLE></HEAD> <BODY BGCOLOR="#FFF8DC" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" ALINK="#ff0000"> <DIV CLASS="NAVHEADER"> <HR ALIGN="LEFT" WIDTH="100%"> </DIV> <DIV CLASS="PREFACE"> <H2><A NAME="AEN8">Simple DirectMedia Layer Introduction</A></H2> <P> This library is designed to make it easy to write games that run on many different platforms using the various native high-performance media interfaces, (for video, audio, etc) and presenting a single source-code level API to your application. This is a fairly low level API, but using this, completely portable applications can be written with a great deal of flexibility. </P><P> An introduction to SDL can be found online at: <A HREF="http://www.libsdl.org/intro.php" TARGET="_top"> http://www.libsdl.org/intro.php</A> </P><P> Tutorials on a variety of topics can be found online at: <A HREF="http://www.libsdl.org/tutorials.php" TARGET="_top"> http://www.libsdl.org/tutorials.php</A> </P><P> Documentation in Wiki form can be found online at: <A HREF="http://www.libsdl.org/cgi/docwiki.cgi/" TARGET="_top"> http://www.libsdl.org/cgi/docwiki.cgi/</A> </P><P> Enjoy! </P><P> Sam Lantinga <TT CLASS="EMAIL"><<A HREF="mailto:slouken@libsdl.org"><A HREF="mailto:slouken@libsdl.org" TARGET="_top" >slouken@libsdl.org</A></A>></TT> </P> <P> <br><br><HR> <H1>Table of Contents</H1> <UL> <LI><A HREF="html/index.html">Full Table of Contents</A></LI> <LI><A HREF="html/guide.html">The SDL Guide</A></LI> <LI><A HREF="html/reference.html">The SDL Reference</A></LI> <UL> <LI><A HREF="html/general.html">Initialization</A></LI> <LI><A HREF="html/video.html">Video</A></LI> <LI><A HREF="html/wm.html">Window Manager</A></LI> <LI><A HREF="html/event.html">Event Handling</A></LI> <LI><A HREF="html/joystick.html">Joystick</A></LI> <LI><A HREF="html/audio.html">Audio</A></LI> <LI><A HREF="html/cdrom.html">CDROM</A></LI> <LI><A HREF="html/thread.html">Threads</A></LI> <LI><A HREF="html/time.html">Timers</A></LI> </UL> </UL> </DIV ></BODY ></HTML >