Mercurial > sdl-ios-xcode
annotate 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 |
rev | line source |
---|---|
0 | 1 <!DOCTYPE HTML PUBLIC "-//Norman Walsh//DTD DocBook HTML 1.0//EN"> |
1840
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
2 <HTML> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
3 <HEAD><TITLE>Simple DirectMedia Layer Introduction</TITLE></HEAD> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
4 <BODY BGCOLOR="#FFF8DC" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" ALINK="#ff0000"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
5 <DIV CLASS="NAVHEADER"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
6 <HR ALIGN="LEFT" WIDTH="100%"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
7 </DIV> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
8 <DIV CLASS="PREFACE"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
9 <H2><A NAME="AEN8">Simple DirectMedia Layer Introduction</A></H2> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
10 <P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
11 This library is designed to make it easy to write games that run on many |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
12 different platforms using the various native high-performance media interfaces, |
0 | 13 (for video, audio, etc) and presenting a single source-code level API to |
14 your application. This is a fairly low level API, but using this, completely | |
1840
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
15 portable applications can be written with a great deal of flexibility. |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
16 </P><P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
17 An introduction to SDL can be found online at: |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
18 <A HREF="http://www.libsdl.org/intro.php" TARGET="_top"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
19 http://www.libsdl.org/intro.php</A> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
20 </P><P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
21 Tutorials on a variety of topics can be found online at: |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
22 <A HREF="http://www.libsdl.org/tutorials.php" TARGET="_top"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
23 http://www.libsdl.org/tutorials.php</A> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
24 </P><P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
25 Documentation in Wiki form can be found online at: |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
26 <A HREF="http://www.libsdl.org/cgi/docwiki.cgi/" TARGET="_top"> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
27 http://www.libsdl.org/cgi/docwiki.cgi/</A> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
28 </P><P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
29 Enjoy! |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
30 </P><P> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
31 Sam Lantinga |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
32 <TT CLASS="EMAIL"><<A HREF="mailto:slouken@libsdl.org"><A HREF="mailto:slouken@libsdl.org" TARGET="_top" >slouken@libsdl.org</A></A>></TT> |
c6a447c98584
Updated docs for SDL 1.2.10 release
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
33 </P> <P> |
0 | 34 <br><br><HR> |
35 <H1>Table of Contents</H1> | |
36 <UL> | |
37 <LI><A HREF="html/index.html">Full Table of Contents</A></LI> | |
38 <LI><A HREF="html/guide.html">The SDL Guide</A></LI> | |
39 <LI><A HREF="html/reference.html">The SDL Reference</A></LI> | |
40 <UL> | |
41 <LI><A HREF="html/general.html">Initialization</A></LI> | |
42 <LI><A HREF="html/video.html">Video</A></LI> | |
43 <LI><A HREF="html/wm.html">Window Manager</A></LI> | |
44 <LI><A HREF="html/event.html">Event Handling</A></LI> | |
45 <LI><A HREF="html/joystick.html">Joystick</A></LI> | |
46 <LI><A HREF="html/audio.html">Audio</A></LI> | |
47 <LI><A HREF="html/cdrom.html">CDROM</A></LI> | |
48 <LI><A HREF="html/thread.html">Threads</A></LI> | |
49 <LI><A HREF="html/time.html">Timers</A></LI> | |
50 </UL> | |
51 </UL> | |
52 </DIV | |
53 ></BODY | |
54 ></HTML | |
55 > |