2 * Copyright (C) Volition, Inc. 1999. All rights reserved.
4 * All source code herein is the property of Volition, Inc. You may not sell
5 * or otherwise commercially exploit the source or things you created based on
10 * $Logfile: /Freespace2/code/Ui/INPUTBOX.cpp $
15 * Code to implement input boxes
18 * Revision 1.2 2002/06/09 04:41:29 relnev
19 * added copyright header
21 * Revision 1.1.1.1 2002/05/03 03:28:11 root
25 * 8 9/07/99 4:01p Dave
26 * Fixed up a string.tbl paroblem (self destruct message). Make sure IPX
27 * does everything properly (setting up address when binding). Remove
28 * black rectangle background from UI_INPUTBOX.
30 * 7 7/15/99 7:14p Jefff
32 * 6 6/25/99 11:59a Dave
33 * Multi options screen.
35 * 5 2/11/99 3:08p Dave
36 * PXO refresh button. Very preliminary squad war support.
38 * 4 12/02/98 5:47p Dave
39 * Put in interface xstr code. Converted barracks screen to new format.
41 * 3 10/13/98 9:29a Dave
42 * Started neatening up freespace.h. Many variables renamed and
43 * reorganized. Added AlphaColors.[h,cpp]
45 * 2 10/07/98 10:54a Dave
48 * 1 10/07/98 10:51a Dave
50 * 43 5/14/98 6:29p Hoffoss
51 * Fixed some warnings a release rebuild all turned up.
53 * 42 4/14/98 5:06p Dave
54 * Don't load or send invalid pilot pics. Fixed chatbox graphic errors.
55 * Made chatbox display team icons in a team vs. team game. Fixed up pause
56 * and endgame sequencing issues.
58 * 41 4/12/98 5:31p Lawrance
59 * use timer_get_milliseconds() instead of gettime()
61 * 40 4/10/98 5:36p Dave
62 * Put in user notification of illegal values in multi host options
63 * screen. Fixed server respawn ship class problem.
65 * 39 4/09/98 3:10p Mike
66 * Fix shockingly stupid typo.
68 * 38 4/09/98 2:46p Mike
69 * Fix bug preventing first letter in pilot name being capitalized.
71 * 37 4/09/98 12:12p Mike
72 * Separate versioning for demo and full versions.
75 * 36 4/06/98 5:14p Hoffoss
76 * Added some needed asserts.
78 * 35 4/06/98 4:25p Allender
79 * Fix strncpy bug in inputbox
81 * 34 4/06/98 3:58p Frank
82 * added initialization to try and fix a bug.
84 * 33 4/01/98 10:26a Hoffoss
85 * Changed input box code to not draw a cursor if the input box is
88 * 32 3/27/98 4:01p Hoffoss
89 * Fixed bug where input box text wsn't being null terminated! Bad!
91 * 31 3/27/98 3:04p Mitri
92 * Fixed bug in set_text(). 'length' is the number of characters allowed,
93 * EXCLUDING the null terminator.
95 * 30 3/27/98 11:20a Hoffoss
96 * Changed input to use bright white text instead of bright green.
98 * 29 3/10/98 11:29a Hoffoss
99 * Make first_time ignored and text not disappear after a return is
102 * 28 2/26/98 4:21p Dave
103 * More robust multiplayer voice.
105 * 27 1/23/98 5:43p Dave
106 * Finished bringing standalone up to speed. Coded in new host options
109 * 26 1/20/98 10:36a Hoffoss
110 * Fixed optimized warnings.
112 * 25 1/17/98 5:51p Dave
113 * Bug fixes for bugs generated by multiplayer testing.
115 * 24 1/16/98 7:57p Lawrance
116 * support animating input box cursor
118 * 23 1/15/98 5:12p Hoffoss
119 * Fixed inputbox so clicking on it gives it focus.
121 * 22 1/15/98 5:10p Allender
122 * ton of interface changes. chatbox in multiplayer now behaves
123 * differently than before. It's always active in any screen that uses
124 * it. Only non-printatble characters will get passed back out from
127 * 21 1/14/98 6:43p Hoffoss
128 * Massive changes to UI code. A lot cleaner and better now. Did all
129 * this to get the new UI_DOT_SLIDER to work properly, which the old code
130 * wasn't flexible enough to handle.
132 * 20 1/05/98 1:15p John
133 * Made inputbox skip the initial "selected" phase when you first tab to
136 * 19 12/22/97 5:08p Hoffoss
137 * Changed inputbox class to be able to accept only certain keys, changed
138 * pilot screens to utilize this feature. Added to assert with pilot file
141 * 18 12/11/97 8:15p Dave
142 * Put in network options screen. Xed out olf protocol selection screen.
144 * 17 12/08/97 6:22p Lawrance
145 * blink cursor on inputbox
147 * 16 12/06/97 4:27p Dave
148 * Another load of interface and multiplayer bug fixes.
150 * 15 11/25/97 3:51p Hoffoss
151 * Changed edit background rect position slightly.
153 * 14 10/24/97 10:58p Hoffoss
154 * Made some changes to the UI code to do some things I need it to do.
156 * 13 10/09/97 11:05a Allender
157 * ignore controled and alted keys in input box
159 * 12 10/01/97 4:39p Lawrance
160 * null out text when free'ed
162 * 11 9/09/97 3:39p Sandeep
163 * warning level 4 bugs
165 * 10 8/21/97 12:13p Dave
166 * Made it possible for input box to ignore esc to lose focus.
168 * 9 8/19/97 1:28p Dave
169 * Made it possible to limit characters by pixel width.
171 * 8 8/15/97 8:21p Dave
172 * Modified UI_INPUTBOX so that it is possible to draw it invisibly. That
173 * is, only the text is displayed.
175 * 7 8/11/97 9:48p Lawrance
176 * reset clip after drawing
178 * 6 7/01/97 2:10p Dave
179 * Fixed bug which caused the box to stop responding after user called
180 * set_text(...) with a 0 length string.
182 * 5 6/12/97 12:39p John
183 * made ui use freespace colors
185 * 4 6/11/97 1:13p John
186 * Started fixing all the text colors in the game.
188 * 3 12/03/96 3:46p Lawrance
189 * added ability to set contents of input box
191 * 2 11/15/96 11:43a John
193 * 1 11/15/96 8:21a John
203 #include "alphacolors.h"
206 #define INPUTBOX_PASSWD_CHAR '*' // the password protected char
208 // Retuen true if c is a letter, else return false.
209 int is_letter(char c)
211 return ((c >= 'a') && (c <= 'z')) || ((c >= 'A') && (c <= 'Z'));
214 // if the passed key is keypad number, return the ascii value, otherwise -1
215 int keypad_to_ascii(int c)
219 return key_to_ascii(KEY_0);
222 return key_to_ascii(KEY_1);
225 return key_to_ascii(KEY_2);
228 return key_to_ascii(KEY_3);
231 return key_to_ascii(KEY_4);
234 return key_to_ascii(KEY_5);
237 return key_to_ascii(KEY_6);
240 return key_to_ascii(KEY_7);
243 return key_to_ascii(KEY_8);
246 return key_to_ascii(KEY_9);
249 return key_to_ascii(KEY_PERIOD);
257 // insert character c into string s at position p.
258 void strcins(char *s, int p, char c)
261 for (n=strlen(s)-p; n>=0; n-- )
262 *(s+p+n+1) = *(s+p+n); // Move everything over
263 *(s+p) = c; // then insert the character
266 // delete n character from string s starting at position p
268 void strndel(char *s, int p, int n)
270 for (; (*(s+p) = *(s+p+n)) != '\0'; s++ )
271 *(s+p+n) = '\0'; // Delete and zero fill
274 void UI_INPUTBOX::init_cursor()
276 cursor_first_frame = bm_load_animation("cursor1", &cursor_nframes, &cursor_fps);
277 if ( cursor_first_frame < 0 ) {
278 Warning(LOCATION,"Cannot load input box cursor: cursor1.ani\n");
281 cursor_elapsed_time=0;
282 cursor_current_frame=0;
285 void UI_INPUTBOX::create(UI_WINDOW *wnd, int _x, int _y, int _w, int _text_len, char *_text, int _flags, int pixel_lim, color *clr)
289 Assert(_text_len >= 0);
290 Assert((int) strlen(_text) <= _text_len);
291 gr_set_font(wnd->f_id);
292 gr_get_string_size( &tw, &th, "*" );
294 // check to see if the user passed in a text color otherwise use the default green color
298 text_color = &CBRIGHT;
301 base_create( wnd, UI_KIND_INPUTBOX, _x, _y, _w, th+4 );
302 text = (char *) malloc( _text_len + 1);
304 // input boxes no longer use background
305 _flags |= UI_INPUTBOX_FLAG_NO_BACK;
307 // if its in "password" mode, allocate a second string
309 if (_flags & UI_INPUTBOX_FLAG_PASSWD) {
310 passwd_text = (char *) malloc(_text_len + 1);
311 memset(passwd_text, INPUTBOX_PASSWD_CHAR, strlen(_text));
312 passwd_text[strlen(_text)] = 0;
320 if ( _text_len > 0 ) {
321 strncpy( text, _text, _text_len );
324 position = strlen(_text);
325 oldposition = position;
331 pixel_limit = pixel_lim;
334 invalid_chars = NULL;
337 void UI_INPUTBOX::set_valid_chars(char *vchars)
339 // free up any existing string
340 if(valid_chars != NULL){
345 valid_chars = strdup(vchars);
348 void UI_INPUTBOX::set_invalid_chars(char *ichars)
350 // free up any existing string
351 if(invalid_chars != NULL){
353 invalid_chars = NULL;
356 invalid_chars = strdup(ichars);
359 void UI_INPUTBOX::destroy()
366 // free any valid chars
367 if(valid_chars != NULL){
372 // free any invalid chars
373 if(invalid_chars != NULL){
375 invalid_chars = NULL;
378 if ((flags & UI_INPUTBOX_FLAG_PASSWD) && passwd_text) {
383 UI_GADGET::destroy();
386 void UI_INPUTBOX::draw()
388 int invis, w1, h1, tw, th;
397 invis = flags & UI_INPUTBOX_FLAG_INVIS;
399 gr_set_font(my_wnd->f_id);
401 if (!invis && !(flags & UI_INPUTBOX_FLAG_NO_BACK)) {
402 // draw the entire text box region
403 ui_draw_sunken_border( x-2, y-2, x+w+1, y+h+1 );
404 gr_set_color_fast( &CBLACK );
405 gr_rect( 0, 0, w, h );
408 gr_set_clip( x + 1, y + 1, w1 + 1, h1 + 1 );
410 gr_set_clip( x - 1, y - 1, w1 + 1, h1 + 1 );
413 if (flags & UI_INPUTBOX_FLAG_PASSWD){
414 gr_get_string_size(&tw, &th, passwd_text);
416 gr_get_string_size(&tw, &th, text);
419 // If first_time is set, that means this input box got
420 // focus, but nothing is typed yet, so all the text is
421 // selected, if you type a character it will replace the
422 // text, if you type an arrow it will unselect it.
423 // So it needs to be colored differently to show this.
424 if (!disabled_flag && !(flags & UI_INPUTBOX_FLAG_NO_BACK)) {
425 // if ( (my_wnd->selected_gadget == this) && first_time ) {
426 // gr_set_color_fast( text_color );
429 gr_set_color_fast( &CBLACK );
432 // color the background behind the text
433 gr_rect( 0, 0, tw + 1, th );
436 if ( (my_wnd->selected_gadget == this) || disabled_flag ) {
437 gr_set_color_fast(text_color);
439 gr_set_color_fast(&CWHITE);
442 // coords of where to draw the text
445 if(flags & UI_INPUTBOX_FLAG_TEXT_CEN){
446 // if we fit within the text area, draw it centered
448 text_x += (w1 - tw)/2;
453 if (flags & UI_INPUTBOX_FLAG_PASSWD){
454 gr_string(text_x, text_y, passwd_text);
456 gr_string(text_x, text_y, text);
460 if (!disabled_flag) {
461 if (my_wnd->selected_gadget == this) {
462 if (cursor_first_frame == -1) {
463 gr_set_color_fast(text_color);
464 ui_vline(1, h1, text_x + tw + 4);
465 ui_vline(1, h1, text_x + tw + 5);
467 // draw animating cursor
468 int time_delta = timer_get_milliseconds() - cursor_elapsed_time;
470 if ( (time_delta / 1000.0f) > (1.0f / cursor_fps) ) {
472 cursor_elapsed_time += time_delta;
473 cursor_current_frame++;
474 if (cursor_current_frame >= cursor_nframes) {
475 cursor_current_frame = 0;
479 // draw current frame
480 gr_set_bitmap(cursor_first_frame + cursor_current_frame);
481 gr_bitmap(text_x + tw + 4, 1);
489 int UI_INPUTBOX::validate_input(int chr)
491 if (chr < 32) { // weed out control characters
495 // if we're disallowing letters altogether
496 if((flags & UI_INPUTBOX_FLAG_NO_LETTERS) && isalpha(chr)){
500 // if we're disallowing numbers altogether
501 if((flags & UI_INPUTBOX_FLAG_NO_NUMERALS) && isdigit(chr)){
505 // otherwise allow numbers and alpha chars by
506 if (isdigit(chr) || isalpha(chr)){
510 // if we have specified no valid or invalid chars, accept everything
511 if(!valid_chars && !invalid_chars){
515 // otherwise compare against the valid chars list
516 if((valid_chars) && strchr(valid_chars, chr)){
520 // otherwise compare against the invalid chars list0
521 if((invalid_chars) && !strchr(invalid_chars,chr)){
528 void UI_INPUTBOX::process(int focus)
530 int ascii, clear_lastkey, key, key_used, key_check;
532 // check if mouse is pressed
533 if (B1_PRESSED && is_mouse_on()) {
541 if (my_wnd->selected_gadget == this)
548 oldposition = position;
550 clear_lastkey = (flags & UI_INPUTBOX_FLAG_KEYTHRU) ? 0 : 1;
553 key = my_wnd->keypress;
564 if (flags & UI_INPUTBOX_FLAG_PASSWD) {
565 passwd_text[position] = 0;
587 if (flags & UI_INPUTBOX_FLAG_ESC_CLR){
598 if (flags & UI_INPUTBOX_FLAG_ESC_FOC) {
606 // MWA -- determine if alt or ctrl held down on this key and don't process if it is. We
607 // need to be able to pass these keys back to the top level. (And anyway -- ctrl-a shouldn't
608 // print out an A in the input window
609 if ( key & (KEY_ALTED | KEY_CTRLED) ) {
614 // get an ascii char from the input if possible
615 key_check = keypad_to_ascii(key);
617 key_check = key_to_ascii(key);
620 ascii = validate_input(key_check);
621 if ((ascii > 0) && (ascii < 255)) {
622 if (flags & UI_INPUTBOX_FLAG_LETTER_FIRST) {
623 if ((position == 0) && !is_letter((char) ascii))
628 // if (should_reset) {
638 if ( position < length ) {
639 text[position] = (char) ascii;
640 text[position + 1] = 0;
642 if (flags & UI_INPUTBOX_FLAG_PASSWD) {
643 passwd_text[position] = (char) INPUTBOX_PASSWD_CHAR;
644 passwd_text[position + 1] = 0;
649 // check to see if we should limit by pixel width
650 if (pixel_limit > -1) {
653 if (flags & UI_INPUTBOX_FLAG_PASSWD) {
654 gr_get_string_size(&w, NULL, passwd_text);
657 gr_get_string_size(&w, NULL, text);
660 if (w > pixel_limit) {
665 if (flags & UI_INPUTBOX_FLAG_PASSWD) {
666 passwd_text[position] = 0;
679 if (clear_lastkey || (key_used && (flags & UI_INPUTBOX_FLAG_EAT_USED)) )
680 my_wnd->last_keypress=0;
687 int UI_INPUTBOX::changed()
692 int UI_INPUTBOX::pressed()
697 void UI_INPUTBOX::get_text(char *out)
699 strncpy(out, text, length);
703 void UI_INPUTBOX::set_text(char *in)
707 in_length = strlen(in);
708 if (in_length > length)
709 Assert(0); // tried to force text into an input box that won't fit into allocated memory
713 if (flags & UI_INPUTBOX_FLAG_PASSWD) {
714 memset(passwd_text, INPUTBOX_PASSWD_CHAR, strlen(text));
715 passwd_text[strlen(text)] = 0;
718 position = in_length; // fixes the zero-length-I-don't-think-so bug