comparison Xcode-iPhoneOS/Demos/src/keyboard.c @ 3277:20326ba2bda2

This name inconsistency has been bugging me for a while...
author Sam Lantinga <slouken@libsdl.org>
date Sat, 19 Sep 2009 07:32:36 +0000
parents
children 64ce267332c6
comparison
equal deleted inserted replaced
3276:720d176be107 3277:20326ba2bda2
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_SetRenderDrawColor(bg_color.r, bg_color.g, bg_color.b,
178 bg_color.unused);
179 SDL_RenderFill(&rect);
180 }
181
182 /* moves backwards one character, erasing the last one put down */
183 void
184 backspace(void)
185 {
186 int x, y;
187 if (numChars > 0) {
188 getPositionForCharNumber(numChars, &x, &y);
189 drawBlank(x, y);
190 numChars--;
191 getPositionForCharNumber(numChars, &x, &y);
192 drawBlank(x, y);
193 drawCursor();
194 }
195 }
196
197 /* this function loads our font into an SDL_Texture and returns the SDL_TextureID */
198 SDL_TextureID
199 loadFont(void)
200 {
201
202 SDL_Surface *surface = SDL_LoadBMP("kromasky_16x16.bmp");
203
204 if (!surface) {
205 printf("Error loading bitmap: %s\n", SDL_GetError());
206 return 0;
207 } else {
208 /* set the transparent color for the bitmap font (hot pink) */
209 SDL_SetColorKey(surface, 1, SDL_MapRGB(surface->format, 238, 0, 252));
210 /* now we convert the surface to our desired pixel format */
211 int format = SDL_PIXELFORMAT_ABGR8888; /* desired texture format */
212 Uint32 Rmask, Gmask, Bmask, Amask; /* masks for desired format */
213 int bpp; /* bits per pixel for desired format */
214 SDL_PixelFormatEnumToMasks(format, &bpp, &Rmask, &Gmask, &Bmask,
215 &Amask);
216 SDL_Surface *converted =
217 SDL_CreateRGBSurface(0, surface->w, surface->h, bpp, Rmask, Gmask,
218 Bmask, Amask);
219 SDL_BlitSurface(surface, NULL, converted, NULL);
220 /* create our texture */
221 textureID =
222 SDL_CreateTextureFromSurface(SDL_PIXELFORMAT_ABGR8888, converted);
223 if (textureID == 0) {
224 printf("texture creation failed: %s\n", SDL_GetError());
225 } else {
226 /* set blend mode for our texture */
227 SDL_SetTextureBlendMode(textureID, SDL_BLENDMODE_BLEND);
228 }
229 SDL_FreeSurface(surface);
230 SDL_FreeSurface(converted);
231 return textureID;
232 }
233 }
234
235 int
236 main(int argc, char *argv[])
237 {
238
239 int index; /* index of last key we pushed in the bitmap font */
240 SDL_Event event; /* last event received */
241 SDLMod mod; /* key modifiers of last key we pushed */
242 SDL_scancode scancode; /* scancode of last key we pushed */
243
244 if (SDL_Init(SDL_INIT_VIDEO) < 0) {
245 printf("Error initializing SDL: %s", SDL_GetError());
246 }
247 /* create window */
248 SDL_WindowID windowID =
249 SDL_CreateWindow("iPhone keyboard test", 0, 0, SCREEN_WIDTH,
250 SCREEN_HEIGHT, 0);
251 /* create renderer */
252 SDL_CreateRenderer(windowID, 0, 0);
253
254 /* load up our font */
255 loadFont();
256
257 /* draw the background, we'll just paint over it */
258 SDL_SetRenderDrawColor(bg_color.r, bg_color.g, bg_color.b,
259 bg_color.unused);
260 SDL_RenderFill(NULL);
261 SDL_RenderPresent();
262
263 int done = 0;
264 /* loop till we get SDL_Quit */
265 while (SDL_WaitEvent(&event)) {
266 switch (event.type) {
267 case SDL_QUIT:
268 done = 1;
269 break;
270 case SDL_KEYDOWN:
271 index = keyToIndex(event.key.keysym);
272 scancode = event.key.keysym.scancode;
273 mod = event.key.keysym.mod;
274 if (scancode == SDL_SCANCODE_DELETE) {
275 /* if user hit delete, delete the last character */
276 backspace();
277 lastCharWasColon = 0;
278 } else if (lastCharWasColon && scancode == SDL_SCANCODE_0
279 && (mod & KMOD_SHIFT)) {
280 /* if our last key was a colon and this one is a close paren, the make a hoppy face */
281 backspace();
282 drawIndex(32); /* index for happy face */
283 numChars++;
284 drawCursor();
285 lastCharWasColon = 0;
286 } else if (index != -1) {
287 /* if we aren't doing a happy face, then just draw the normal character */
288 drawIndex(index);
289 numChars++;
290 drawCursor();
291 lastCharWasColon =
292 (event.key.keysym.scancode == SDL_SCANCODE_SEMICOLON
293 && (event.key.keysym.mod & KMOD_SHIFT));
294 }
295 /* check if the key was a colon */
296 /* draw our updates to the screen */
297 SDL_RenderPresent();
298 break;
299 #ifdef __IPHONEOS__
300 case SDL_MOUSEBUTTONUP:
301 /* mouse up toggles onscreen keyboard visibility
302 this function is available ONLY on iPhone OS
303 */
304 SDL_iPhoneKeyboardToggle(windowID);
305 break;
306 #endif
307 }
308 }
309 cleanup();
310 return 0;
311 }
312
313 /* clean up after ourselves like a good kiddy */
314 void
315 cleanup(void)
316 {
317 SDL_DestroyTexture(textureID);
318 SDL_Quit();
319 }