Mercurial > sdl-ios-xcode

comparison XCodeiPhoneOS/Demos/src/keyboard.c @ 2765:f55c87ae336b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Final merge of Google Summer of Code 2008 work... Bring SDL to iPhone and iPod Touch by Holmes Futrell, mentored by Sam Lantinga
author Sam Lantinga <slouken@libsdl.org>
date Sat, 04 Oct 2008 06:46:59 +0000
parents
children 9dde605c7540
comparison
equal deleted inserted replaced
2764:4868c0df2e83 2765:f55c87ae336b
1 /*
2 * keyboard.c
3 * written by Holmes Futrell
4 * use however you want
5 */
6
7 #import "SDL.h"
8 #import "common.h"
9
10 #define GLYPH_SIZE_IMAGE 16 /* size of glyphs (characters) in the bitmap font file */
11 #define GLYPH_SIZE_SCREEN 32 /* size of glyphs (characters) as shown on the screen */
12
13 static SDL_TextureID textureID; /* texture where we'll hold our font */
14
15 /* iPhone SDL addition keyboard related function definitions */
16 extern DECLSPEC int SDLCALL SDL_iPhoneKeyboardShow(SDL_WindowID windowID);
17 extern DECLSPEC int SDLCALL SDL_iPhoneKeyboardHide(SDL_WindowID windowID);
18 extern DECLSPEC SDL_bool SDLCALL SDL_iPhoneKeyboardIsShown(SDL_WindowID
19 windowID);
20 extern DECLSPEC int SDLCALL SDL_iPhoneKeyboardToggle(SDL_WindowID windowID);
21
22 /* function declarations */
23 void cleanup(void);
24 void drawBlank(int x, int y);
25
26 static int numChars = 0; /* number of characters we've typed so far */
27 static SDL_bool lastCharWasColon = 0; /* we use this to detect sequences such as :) */
28 static SDL_Color bg_color = { 50, 50, 100, 255 }; /* color of background */
29
30 /* this structure maps a scancode to an index in our bitmap font.
31 it also contains data about under which modifiers the mapping is valid
32 (for example, we don't want shift + 1 to produce the character '1',
33 but rather the character '!')
34 */
35 typedef struct
36 {
37 SDL_scancode scancode; /* scancode of the key we want to map */
38 int allow_no_mod; /* is the map valid if the key has no modifiers? */
39 SDLMod mod; /* what modifiers are allowed for the mapping */
40 int index; /* what index in the font does the scancode map to */
41 } fontMapping;
42
43 #define TABLE_SIZE 51 /* size of our table which maps keys and modifiers to font indices */
44
45 /* Below is the table that defines the mapping between scancodes and modifiers to indices in the
46 bitmap font. As an example, then line '{ SDL_SCANCODE_A, 1, KMOD_SHIFT, 33 }' means, map
47 the key A (which has scancode SDL_SCANCODE_A) to index 33 in the font (which is a picture of an A),
48 The '1' means that the mapping is valid even if there are no modifiers, and KMOD_SHIFT means the
49 mapping is also valid if the user is holding shift.
50 */
51 fontMapping map[TABLE_SIZE] = {
52
53 {SDL_SCANCODE_A, 1, KMOD_SHIFT, 33}, /* A */
54 {SDL_SCANCODE_B, 1, KMOD_SHIFT, 34}, /* B */
55 {SDL_SCANCODE_C, 1, KMOD_SHIFT, 35}, /* C */
56 {SDL_SCANCODE_D, 1, KMOD_SHIFT, 36}, /* D */
57 {SDL_SCANCODE_E, 1, KMOD_SHIFT, 37}, /* E */
58 {SDL_SCANCODE_F, 1, KMOD_SHIFT, 38}, /* F */
59 {SDL_SCANCODE_G, 1, KMOD_SHIFT, 39}, /* G */
60 {SDL_SCANCODE_H, 1, KMOD_SHIFT, 40}, /* H */
61 {SDL_SCANCODE_I, 1, KMOD_SHIFT, 41}, /* I */
62 {SDL_SCANCODE_J, 1, KMOD_SHIFT, 42}, /* J */
63 {SDL_SCANCODE_K, 1, KMOD_SHIFT, 43}, /* K */
64 {SDL_SCANCODE_L, 1, KMOD_SHIFT, 44}, /* L */
65 {SDL_SCANCODE_M, 1, KMOD_SHIFT, 45}, /* M */
66 {SDL_SCANCODE_N, 1, KMOD_SHIFT, 46}, /* N */
67 {SDL_SCANCODE_O, 1, KMOD_SHIFT, 47}, /* O */
68 {SDL_SCANCODE_P, 1, KMOD_SHIFT, 48}, /* P */
69 {SDL_SCANCODE_Q, 1, KMOD_SHIFT, 49}, /* Q */
70 {SDL_SCANCODE_R, 1, KMOD_SHIFT, 50}, /* R */
71 {SDL_SCANCODE_S, 1, KMOD_SHIFT, 51}, /* S */
72 {SDL_SCANCODE_T, 1, KMOD_SHIFT, 52}, /* T */
73 {SDL_SCANCODE_U, 1, KMOD_SHIFT, 53}, /* U */
74 {SDL_SCANCODE_V, 1, KMOD_SHIFT, 54}, /* V */
75 {SDL_SCANCODE_W, 1, KMOD_SHIFT, 55}, /* W */
76 {SDL_SCANCODE_X, 1, KMOD_SHIFT, 56}, /* X */
77 {SDL_SCANCODE_Y, 1, KMOD_SHIFT, 57}, /* Y */
78 {SDL_SCANCODE_Z, 1, KMOD_SHIFT, 58}, /* Z */
79 {SDL_SCANCODE_0, 1, 0, 16}, /* 0 */
80 {SDL_SCANCODE_1, 1, 0, 17}, /* 1 */
81 {SDL_SCANCODE_2, 1, 0, 18}, /* 2 */
82 {SDL_SCANCODE_3, 1, 0, 19}, /* 3 */
83 {SDL_SCANCODE_4, 1, 0, 20}, /* 4 */
84 {SDL_SCANCODE_5, 1, 0, 21}, /* 5 */
85 {SDL_SCANCODE_6, 1, 0, 22}, /* 6 */
86 {SDL_SCANCODE_7, 1, 0, 23}, /* 7 */
87 {SDL_SCANCODE_8, 1, 0, 24}, /* 8 */
88 {SDL_SCANCODE_9, 1, 0, 25}, /* 9 */
89 {SDL_SCANCODE_SPACE, 1, 0, 0}, /*' ' */
90 {SDL_SCANCODE_1, 0, KMOD_SHIFT, 1}, /* ! */
91 {SDL_SCANCODE_SLASH, 0, KMOD_SHIFT, 31}, /* ? */
92 {SDL_SCANCODE_SLASH, 1, 0, 15}, /* / */
93 {SDL_SCANCODE_COMMA, 1, 0, 12}, /* , */
94 {SDL_SCANCODE_SEMICOLON, 1, 0, 27}, /* ; */
95 {SDL_SCANCODE_SEMICOLON, 0, KMOD_SHIFT, 26}, /* : */
96 {SDL_SCANCODE_PERIOD, 1, 0, 14}, /* . */
97 {SDL_SCANCODE_MINUS, 1, 0, 13}, /* - */
98 {SDL_SCANCODE_EQUALS, 0, KMOD_SHIFT, 11}, /* = */
99 {SDL_SCANCODE_APOSTROPHE, 1, 0, 7}, /* ' */
100 {SDL_SCANCODE_APOSTROPHE, 0, KMOD_SHIFT, 2}, /* " */
101 {SDL_SCANCODE_5, 0, KMOD_SHIFT, 5}, /* % */
102
103 };
104
105 /*
106 This function maps an SDL_keysym to an index in the bitmap font.
107 It does so by scanning through the font mapping table one entry
108 at a time.
109
110 If a match is found (scancode and allowed modifiers), the proper
111 index is returned.
112
113 If there is no entry for the key, -1 is returned
114 */
115 int
116 keyToIndex(SDL_keysym key)
117 {
118 int i, index = -1;
119 for (i = 0; i < TABLE_SIZE; i++) {
120 fontMapping compare = map[i];
121 if (key.scancode == compare.scancode) {
122 /* if this entry is valid with no key mod and we have no keymod, or if
123 the key's modifiers are allowed modifiers for that mapping */
124 if ((compare.allow_no_mod && key.mod == 0)
125 || (key.mod & compare.mod)) {
126 index = compare.index;
127 break;
128 }
129 }
130 }
131 return index;
132 }
133
134 /*
135 This function returns and x,y position for a given character number.
136 It is used for positioning each character of text
137 */
138 void
139 getPositionForCharNumber(int n, int *x, int *y)
140 {
141 int x_padding = 16; /* padding space on left and right side of screen */
142 int y_padding = 32; /* padding space at top of screen */
143 /* figure out the number of characters that can fit horizontally across the screen */
144 int max_x_chars = (SCREEN_WIDTH - 2 * x_padding) / GLYPH_SIZE_SCREEN;
145 int line_separation = 5; /* pixels between each line */
146 *x = (n % max_x_chars) * GLYPH_SIZE_SCREEN + x_padding;
147 *y = (n / max_x_chars) * (GLYPH_SIZE_SCREEN + line_separation) +
148 y_padding;
149 }
150
151 void
152 drawIndex(int index)
153 {
154 int x, y;
155 getPositionForCharNumber(numChars, &x, &y);
156 SDL_Rect srcRect =
157 { GLYPH_SIZE_IMAGE * index, 0, GLYPH_SIZE_IMAGE, GLYPH_SIZE_IMAGE };
158 SDL_Rect dstRect = { x, y, GLYPH_SIZE_SCREEN, GLYPH_SIZE_SCREEN };
159 drawBlank(x, y);
160 SDL_RenderCopy(textureID, &srcRect, &dstRect);
161 }
162
163 /* draws the cursor icon at the current end position of the text */
164 void
165 drawCursor(void)
166 {
167 drawIndex(29); /* cursor is at index 29 in the bitmap font */
168 }
169
170 /* paints over a glyph sized region with the background color
171 in effect it erases the area
172 */
173 void
174 drawBlank(int x, int y)
175 {
176 SDL_Rect rect = { x, y, GLYPH_SIZE_SCREEN, GLYPH_SIZE_SCREEN };
177 SDL_RenderFill(bg_color.r, bg_color.g, bg_color.b, bg_color.unused,
178 &rect);
179 }
180
181 /* moves backwards one character, erasing the last one put down */
182 void
183 backspace(void)
184 {
185 int x, y;
186 if (numChars > 0) {
187 getPositionForCharNumber(numChars, &x, &y);
188 drawBlank(x, y);
189 numChars--;
190 getPositionForCharNumber(numChars, &x, &y);
191 drawBlank(x, y);
192 drawCursor();
193 }
194 }
195
196 /* this function loads our font into an SDL_Texture and returns the SDL_TextureID */
197 SDL_TextureID
198 loadFont(void)
199 {
200
201 SDL_Surface *surface = SDL_LoadBMP("kromasky_16x16.bmp");
202
203 if (!surface) {
204 printf("Error loading bitmap: %s\n", SDL_GetError());
205 return 0;
206 } else {
207 /* set the transparent color for the bitmap font (hot pink) */
208 SDL_SetColorKey(surface, 1, SDL_MapRGB(surface->format, 238, 0, 252));
209 /* now we convert the surface to our desired pixel format */
210 int format = SDL_PIXELFORMAT_ABGR8888; /* desired texture format */
211 Uint32 Rmask, Gmask, Bmask, Amask; /* masks for desired format */
212 int bpp; /* bits per pixel for desired format */
213 SDL_PixelFormatEnumToMasks(format, &bpp, &Rmask, &Gmask, &Bmask,
214 &Amask);
215 SDL_Surface *converted =
216 SDL_CreateRGBSurface(0, surface->w, surface->h, bpp, Rmask, Gmask,
217 Bmask, Amask);
218 SDL_BlitSurface(surface, NULL, converted, NULL);
219 /* create our texture */
220 textureID =
221 SDL_CreateTextureFromSurface(SDL_PIXELFORMAT_ABGR8888, converted);
222 if (textureID == 0) {
223 printf("texture creation failed: %s\n", SDL_GetError());
224 } else {
225 /* set blend mode for our texture */
226 SDL_SetTextureBlendMode(textureID, SDL_TEXTUREBLENDMODE_BLEND);
227 }
228 SDL_FreeSurface(surface);
229 SDL_FreeSurface(converted);
230 return textureID;
231 }
232 }
233
234 int
235 main(int argc, char *argv[])
236 {
237
238 int index; /* index of last key we pushed in the bitmap font */
239 SDL_Event event; /* last event received */
240 SDLMod mod; /* key modifiers of last key we pushed */
241 SDL_scancode scancode; /* scancode of last key we pushed */
242
243 if (SDL_Init(SDL_INIT_VIDEO) < 0) {
244 printf("Error initializing SDL: %s", SDL_GetError());
245 }
246 /* create window */
247 SDL_WindowID windowID =
248 SDL_CreateWindow("iPhone keyboard test", 0, 0, SCREEN_WIDTH,
249 SCREEN_HEIGHT, 0);
250 /* create renderer */
251 SDL_CreateRenderer(windowID, 0, 0);
252
253 /* load up our font */
254 loadFont();
255
256 /* draw the background, we'll just paint over it */
257 SDL_RenderFill(bg_color.r, bg_color.g, bg_color.b, bg_color.unused, NULL);
258 SDL_RenderPresent();
259
260 int done = 0;
261 /* loop till we get SDL_Quit */
262 while (SDL_WaitEvent(&event)) {
263 switch (event.type) {
264 case SDL_QUIT:
265 done = 1;
266 break;
267 case SDL_KEYDOWN:
268 index = keyToIndex(event.key.keysym);
269 scancode = event.key.keysym.scancode;
270 mod = event.key.keysym.mod;
271 if (scancode == SDL_SCANCODE_DELETE) {
272 /* if user hit delete, delete the last character */
273 backspace();
274 lastCharWasColon = 0;
275 } else if (lastCharWasColon && scancode == SDL_SCANCODE_0
276 && (mod & KMOD_SHIFT)) {
277 /* if our last key was a colon and this one is a close paren, the make a hoppy face */
278 backspace();
279 drawIndex(32); /* index for happy face */
280 numChars++;
281 drawCursor();
282 lastCharWasColon = 0;
283 } else if (index != -1) {
284 /* if we aren't doing a happy face, then just draw the normal character */
285 drawIndex(index);
286 numChars++;
287 drawCursor();
288 lastCharWasColon =
289 (event.key.keysym.scancode == SDL_SCANCODE_SEMICOLON
290 && (event.key.keysym.mod & KMOD_SHIFT));
291 }
292 /* check if the key was a colon */
293 /* draw our updates to the screen */
294 SDL_RenderPresent();
295 break;
296 #ifdef __IPHONEOS__
297 case SDL_MOUSEBUTTONUP:
298 /* mouse up toggles onscreen keyboard visibility
299 this function is available ONLY on iPhone OS
300 */
301 SDL_iPhoneKeyboardToggle(windowID);
302 break;
303 #endif
304 }
305 }
306 cleanup();
307 return 0;
308 }
309
310 /* clean up after ourselves like a good kiddy */
311 void
312 cleanup(void)
313 {
314 SDL_DestroyTexture(textureID);
315 SDL_Quit();
316 }