1

/* $Id$ */

     2

     3

/** @file osk_gui.cpp The On Screen Keyboard GUI */

     4

     5

#include "stdafx.h"

     6

#include "openttd.h"

     7

     8

#include "textbuf_gui.h"

     9

#include "window_gui.h"

    10

#include "string_func.h"

    11

#include "strings_func.h"

    12

#include "debug.h"

    13

#include "window_func.h"

    14

#include "gfx_func.h"

    15

#include "querystring_gui.h"

    16

    17

#include "table/sprites.h"

    18

#include "table/strings.h"

    19

    20

enum OskWidgets {

    21

	OSK_WIDGET_TEXT = 3,

    22

	OSK_WIDGET_CANCEL = 5,

    23

	OSK_WIDGET_OK,

    24

	OSK_WIDGET_BACKSPACE,

    25

	OSK_WIDGET_SPECIAL,

    26

	OSK_WIDGET_CAPS,

    27

	OSK_WIDGET_SHIFT,

    28

	OSK_WIDGET_SPACE,

    29

	OSK_WIDGET_LEFT,

    30

	OSK_WIDGET_RIGHT,

    31

	OSK_WIDGET_LETTERS

    32

};

    33

    34

char _keyboard_opt[2][OSK_KEYBOARD_ENTRIES * 4 + 1];

    35

static WChar _keyboard[2][OSK_KEYBOARD_ENTRIES];

    36

    37

enum {

    38

	KEYS_NONE,

    39

	KEYS_SHIFT,

    40

	KEYS_CAPS

    41

};

    42

static byte _keystate = KEYS_NONE;

    43

    44

struct OskWindow : public Window {

    45

	StringID caption;      ///< the caption for this window.

    46

	QueryString *qs;       ///< text-input

    47

	int text_btn;          ///< widget number of parent's text field

    48

	int ok_btn;            ///< widget number of parent's ok button (=0 when ok shouldn't be passed on)

    49

	int cancel_btn;        ///< widget number of parent's cancel button (=0 when cancel shouldn't be passed on; text will be reverted to original)

    50

	Textbuf *text;         ///< pointer to parent's textbuffer (to update caret position)

    51

	char orig_str_buf[64]; ///< Original string.

    52

    53

	OskWindow(const WindowDesc *desc, QueryStringBaseWindow *parent, int button, int cancel, int ok) : Window(desc)

    54

	{

    55

		this->parent = parent;

    56

		assert(parent != NULL);

    57

    58

		this->caption = (parent->widget[button].data != STR_NULL) ? parent->widget[button].data : parent->caption;

    59

    60

		this->qs         = parent;

    61

		this->text_btn   = button;

    62

		this->cancel_btn = cancel;

    63

		this->ok_btn     = ok;

    64

		this->text       = &parent->text;

    65

    66

		/* make a copy in case we need to reset later */

    67

		strcpy(this->orig_str_buf, this->qs->text.buf);

    68

    69

		SetBit(_no_scroll, SCROLL_EDIT);

    70

		/* Not needed by default. */

    71

		this->DisableWidget(OSK_WIDGET_SPECIAL);

    72

    73

		this->FindWindowPlacementAndResize(desc);

    74

	}

    75

    76

	/**

    77

	 * Only show valid characters; do not show characters that would

    78

	 * only insert a space when we have a spacebar to do that or

    79

	 * characters that are not allowed to be entered.

    80

	 */

    81

	void ChangeOskDiabledState(bool shift)

    82

	{

    83

		for (uint i = 0; i < OSK_KEYBOARD_ENTRIES; i++) {

    84

			this->SetWidgetDisabledState(OSK_WIDGET_LETTERS + i,

    85

					!IsValidChar(_keyboard[shift][i], this->qs->afilter) || _keyboard[shift][i] == ' ');

    86

		}

    87

		this->SetWidgetDisabledState(OSK_WIDGET_SPACE, !IsValidChar(' ', this->qs->afilter));

    88

	}

    89

    90

	virtual void OnPaint()

    91

	{

    92

		bool shift = HasBit(_keystate, KEYS_CAPS) ^ HasBit(_keystate, KEYS_SHIFT);

    93

    94

		this->LowerWidget(OSK_WIDGET_TEXT);

    95

		this->SetWidgetLoweredState(OSK_WIDGET_SHIFT, HasBit(_keystate, KEYS_SHIFT));

    96

		this->SetWidgetLoweredState(OSK_WIDGET_CAPS, HasBit(_keystate, KEYS_CAPS));

    97

    98

		this->ChangeOskDiabledState(shift);

    99

   100

		SetDParam(0, this->caption);

   101

		this->DrawWidgets();

   102

   103

		for (uint i = 0; i < OSK_KEYBOARD_ENTRIES; i++) {

   104

			DrawCharCentered(_keyboard[shift][i],

   105

				this->widget[OSK_WIDGET_LETTERS + i].left + 8,

   106

				this->widget[OSK_WIDGET_LETTERS + i].top + 3,

   107

				TC_BLACK);

   108

		}

   109

   110

		this->qs->DrawEditBox(this, OSK_WIDGET_TEXT);

   111

	}

   112

   113

	virtual void OnClick(Point pt, int widget)

   114

	{

   115

		/* clicked a letter */

   116

		if (widget >= OSK_WIDGET_LETTERS) {

   117

			bool shift = HasBit(_keystate, KEYS_CAPS) ^ HasBit(_keystate, KEYS_SHIFT);

   118

   119

			WChar c = _keyboard[shift][widget - OSK_WIDGET_LETTERS];

   120

   121

			if (!IsValidChar(c, this->qs->afilter)) return;

   122

   123

			if (InsertTextBufferChar(&this->qs->text, c)) this->InvalidateWidget(OSK_WIDGET_TEXT);

   124

   125

			if (HasBit(_keystate, KEYS_SHIFT)) {

   126

				ToggleBit(_keystate, KEYS_SHIFT);

   127

				this->widget[OSK_WIDGET_SHIFT].color = HasBit(_keystate, KEYS_SHIFT) ? 15 : 14;

   128

				this->SetDirty();

   129

			}

   130

			return;

   131

		}

   132

   133

		bool delete_this = false;

   134

   135

		switch (widget) {

   136

			case OSK_WIDGET_BACKSPACE:

   137

				if (DeleteTextBufferChar(&this->qs->text, WKC_BACKSPACE)) this->InvalidateWidget(OSK_WIDGET_TEXT);

   138

				break;

   139

   140

			case OSK_WIDGET_SPECIAL:

   141

				/*

   142

				 * Anything device specific can go here.

   143

				 * The button itself is hidden by default, and when you need it you

   144

				 * can not hide it in the create event.

   145

				 */

   146

				break;

   147

   148

			case OSK_WIDGET_CAPS:

   149

				ToggleBit(_keystate, KEYS_CAPS);

   150

				this->SetDirty();

   151

				break;

   152

   153

			case OSK_WIDGET_SHIFT:

   154

				ToggleBit(_keystate, KEYS_SHIFT);

   155

				this->SetDirty();

   156

				break;

   157

   158

			case OSK_WIDGET_SPACE:

   159

				if (InsertTextBufferChar(&this->qs->text, ' ')) this->InvalidateWidget(OSK_WIDGET_TEXT);

   160

				break;

   161

   162

			case OSK_WIDGET_LEFT:

   163

				if (MoveTextBufferPos(&this->qs->text, WKC_LEFT)) this->InvalidateWidget(OSK_WIDGET_TEXT);

   164

				break;

   165

   166

			case OSK_WIDGET_RIGHT:

   167

				if (MoveTextBufferPos(&this->qs->text, WKC_RIGHT)) this->InvalidateWidget(OSK_WIDGET_TEXT);

   168

				break;

   169

   170

			case OSK_WIDGET_OK:

   171

				if (this->qs->orig == NULL || strcmp(this->qs->text.buf, this->qs->orig) != 0) {

   172

					/* pass information by simulating a button press on parent window */

   173

					if (this->ok_btn != 0) {

   174

						this->parent->OnClick(pt, this->ok_btn);

   175

						/* Window gets deleted when the parent window removes itself. */

   176

						return;

   177

					}

   178

				}

   179

				delete_this = true;

   180

				break;

   181

   182

			case OSK_WIDGET_CANCEL:

   183

				if (this->cancel_btn != 0) { // pass a cancel event to the parent window

   184

					this->parent->OnClick(pt, this->cancel_btn);

   185

					/* Window gets deleted when the parent window removes itself. */

   186

					return;

   187

				} else { // or reset to original string

   188

					strcpy(qs->text.buf, this->orig_str_buf);

   189

					UpdateTextBufferSize(&qs->text);

   190

					MoveTextBufferPos(&qs->text, WKC_END);

   191

					delete_this = true;

   192

				}

   193

				break;

   194

		}

   195

		/* make sure that the parent window's textbox also gets updated */

   196

		if (this->parent != NULL) this->parent->InvalidateWidget(this->text_btn);

   197

		if (delete_this) delete this;

   198

	}

   199

   200

	virtual void OnMouseLoop()

   201

	{

   202

		this->qs->HandleEditBox(this, OSK_WIDGET_TEXT);

   203

		/* make the caret of the parent window also blink */

   204

		this->parent->InvalidateWidget(this->text_btn);

   205

	}

   206

   207

	virtual void OnInvalidateData(int)

   208

	{

   209

		this->InvalidateWidget(OSK_WIDGET_TEXT);

   210

	}

   211

};

   212

   213

static const Widget _osk_widgets[] = {

   214

{      WWT_EMPTY, RESIZE_NONE,     0,     0,     0,     0,     0, 0x0,               STR_NULL},

   215

{    WWT_CAPTION, RESIZE_NONE,    14,     0,   255,     0,    13, STR_012D,          STR_NULL},

   216

{      WWT_PANEL, RESIZE_NONE,    14,     0,   255,    14,    29, 0x0,               STR_NULL},

   217

{    WWT_EDITBOX, RESIZE_NONE,    14,     2,   253,    16,    27, 0x0,               STR_NULL},

   218

   219

{      WWT_PANEL, RESIZE_NONE,    14,     0,   255,    30,   139, 0x0,               STR_NULL},

   220

   221

{    WWT_TEXTBTN, RESIZE_NONE,    14,     3,   108,    35,    46, STR_012E_CANCEL,   STR_NULL},

   222

{    WWT_TEXTBTN, RESIZE_NONE,    14,   111,   216,    35,    46, STR_012F_OK,       STR_NULL},

   223

{ WWT_PUSHIMGBTN, RESIZE_NONE,    14,   219,   252,    35,    46, SPR_OSK_BACKSPACE, STR_NULL},

   224

   225

{ WWT_PUSHIMGBTN, RESIZE_NONE,    14,     3,    27,    67,    82, SPR_OSK_SPECIAL,   STR_NULL},

   226

{     WWT_IMGBTN, RESIZE_NONE,    14,     3,    36,    85,   100, SPR_OSK_CAPS,      STR_NULL},

   227

{     WWT_IMGBTN, RESIZE_NONE,    14,     3,    27,   103,   118, SPR_OSK_SHIFT,     STR_NULL},

   228

   229

{ WWT_PUSHTXTBTN, RESIZE_NONE,    14,    75,   189,   121,   136, STR_EMPTY,         STR_NULL},

   230

   231

{ WWT_PUSHIMGBTN, RESIZE_NONE,    14,   219,   234,   121,   136, SPR_OSK_LEFT,      STR_NULL},

   232

{ WWT_PUSHIMGBTN, RESIZE_NONE,    14,   237,   252,   121,   136, SPR_OSK_RIGHT,     STR_NULL},

   233

   234

{    WWT_PUSHBTN, RESIZE_NONE,    14,     3,    18,    49,    64, 0x0,    STR_NULL},

   235

{    WWT_PUSHBTN, RESIZE_NONE,    14,    21,    36,    49,    64, 0x0,    STR_NULL},

   236

{    WWT_PUSHBTN, RESIZE_NONE,    14,    39,    54,    49,    64, 0x0,    STR_NULL},

   237

{    WWT_PUSHBTN, RESIZE_NONE,    14,    57,    72,    49,    64, 0x0,    STR_NULL},

   238

{    WWT_PUSHBTN, RESIZE_NONE,    14,    75,    90,    49,    64, 0x0,    STR_NULL},

   239

{    WWT_PUSHBTN, RESIZE_NONE,    14,    93,   108,    49,    64, 0x0,    STR_NULL},

   240

{    WWT_PUSHBTN, RESIZE_NONE,    14,   111,   126,    49,    64, 0x0,    STR_NULL},

   241

{    WWT_PUSHBTN, RESIZE_NONE,    14,   129,   144,    49,    64, 0x0,    STR_NULL},

   242

{    WWT_PUSHBTN, RESIZE_NONE,    14,   147,   162,    49,    64, 0x0,    STR_NULL},

   243

{    WWT_PUSHBTN, RESIZE_NONE,    14,   165,   180,    49,    64, 0x0,    STR_NULL},

   244

{    WWT_PUSHBTN, RESIZE_NONE,    14,   183,   198,    49,    64, 0x0,    STR_NULL},

   245

{    WWT_PUSHBTN, RESIZE_NONE,    14,   201,   216,    49,    64, 0x0,    STR_NULL},

   246

{    WWT_PUSHBTN, RESIZE_NONE,    14,   219,   234,    49,    64, 0x0,    STR_NULL},

   247

{    WWT_PUSHBTN, RESIZE_NONE,    14,   237,   252,    49,    64, 0x0,    STR_NULL},

   248

   249

{    WWT_PUSHBTN, RESIZE_NONE,    14,    30,    45,    67,    82, 0x0,    STR_NULL},

   250

{    WWT_PUSHBTN, RESIZE_NONE,    14,    48,    63,    67,    82, 0x0,    STR_NULL},

   251

{    WWT_PUSHBTN, RESIZE_NONE,    14,    66,    81,    67,    82, 0x0,    STR_NULL},

   252

{    WWT_PUSHBTN, RESIZE_NONE,    14,    84,    99,    67,    82, 0x0,    STR_NULL},

   253

{    WWT_PUSHBTN, RESIZE_NONE,    14,   102,   117,    67,    82, 0x0,    STR_NULL},

   254

{    WWT_PUSHBTN, RESIZE_NONE,    14,   120,   135,    67,    82, 0x0,    STR_NULL},

   255

{    WWT_PUSHBTN, RESIZE_NONE,    14,   138,   153,    67,    82, 0x0,    STR_NULL},

   256

{    WWT_PUSHBTN, RESIZE_NONE,    14,   156,   171,    67,    82, 0x0,    STR_NULL},

   257

{    WWT_PUSHBTN, RESIZE_NONE,    14,   174,   189,    67,    82, 0x0,    STR_NULL},

   258

{    WWT_PUSHBTN, RESIZE_NONE,    14,   192,   207,    67,    82, 0x0,    STR_NULL},

   259

{    WWT_PUSHBTN, RESIZE_NONE,    14,   210,   225,    67,    82, 0x0,    STR_NULL},

   260

{    WWT_PUSHBTN, RESIZE_NONE,    14,   228,   243,    67,    82, 0x0,    STR_NULL},

   261

   262

{    WWT_PUSHBTN, RESIZE_NONE,    14,    39,    54,    85,   100, 0x0,    STR_NULL},

   263

{    WWT_PUSHBTN, RESIZE_NONE,    14,    57,    72,    85,   100, 0x0,    STR_NULL},

   264

{    WWT_PUSHBTN, RESIZE_NONE,    14,    75,    90,    85,   100, 0x0,    STR_NULL},

   265

{    WWT_PUSHBTN, RESIZE_NONE,    14,    93,   108,    85,   100, 0x0,    STR_NULL},

   266

{    WWT_PUSHBTN, RESIZE_NONE,    14,   111,   126,    85,   100, 0x0,    STR_NULL},

   267

{    WWT_PUSHBTN, RESIZE_NONE,    14,   129,   144,    85,   100, 0x0,    STR_NULL},

   268

{    WWT_PUSHBTN, RESIZE_NONE,    14,   147,   162,    85,   100, 0x0,    STR_NULL},

   269

{    WWT_PUSHBTN, RESIZE_NONE,    14,   165,   180,    85,   100, 0x0,    STR_NULL},

   270

{    WWT_PUSHBTN, RESIZE_NONE,    14,   183,   198,    85,   100, 0x0,    STR_NULL},

   271

{    WWT_PUSHBTN, RESIZE_NONE,    14,   201,   216,    85,   100, 0x0,    STR_NULL},

   272

{    WWT_PUSHBTN, RESIZE_NONE,    14,   219,   234,    85,   100, 0x0,    STR_NULL},

   273

{    WWT_PUSHBTN, RESIZE_NONE,    14,   237,   252,    85,   100, 0x0,    STR_NULL},

   274

   275

{    WWT_PUSHBTN, RESIZE_NONE,    14,    30,    45,   103,   118, 0x0,    STR_NULL},

   276

{    WWT_PUSHBTN, RESIZE_NONE,    14,    48,    63,   103,   118, 0x0,    STR_NULL},

   277

{    WWT_PUSHBTN, RESIZE_NONE,    14,    66,    81,   103,   118, 0x0,    STR_NULL},

   278

{    WWT_PUSHBTN, RESIZE_NONE,    14,    84,    99,   103,   118, 0x0,    STR_NULL},

   279

{    WWT_PUSHBTN, RESIZE_NONE,    14,   102,   117,   103,   118, 0x0,    STR_NULL},

   280

{    WWT_PUSHBTN, RESIZE_NONE,    14,   120,   135,   103,   118, 0x0,    STR_NULL},

   281

{    WWT_PUSHBTN, RESIZE_NONE,    14,   138,   153,   103,   118, 0x0,    STR_NULL},

   282

{    WWT_PUSHBTN, RESIZE_NONE,    14,   156,   171,   103,   118, 0x0,    STR_NULL},

   283

{    WWT_PUSHBTN, RESIZE_NONE,    14,   174,   189,   103,   118, 0x0,    STR_NULL},

   284

{    WWT_PUSHBTN, RESIZE_NONE,    14,   192,   207,   103,   118, 0x0,    STR_NULL},

   285

{    WWT_PUSHBTN, RESIZE_NONE,    14,   210,   225,   103,   118, 0x0,    STR_NULL},

   286

{    WWT_PUSHBTN, RESIZE_NONE,    14,   228,   243,   103,   118, 0x0,    STR_NULL},

   287

   288

{   WIDGETS_END},

   289

};

   290

   291

static const WindowDesc _osk_desc = {

   292

	WDP_CENTER, WDP_CENTER, 256, 140, 256, 140,

   293

	WC_OSK, WC_NONE,

   294

	WDF_STD_TOOLTIPS | WDF_STD_BTN | WDF_DEF_WIDGET | WDF_UNCLICK_BUTTONS,

   295

	_osk_widgets,

   296

};

   297

   298

/**

   299

 * Retrieve keyboard layout from language string or (if set) config file.

   300

 * Also check for invalid characters.

   301

 */

   302

void GetKeyboardLayout()

   303

{

   304

	char keyboard[2][OSK_KEYBOARD_ENTRIES * 4 + 1];

   305

	char errormark[2][OSK_KEYBOARD_ENTRIES + 1]; // used for marking invalid chars

   306

	bool has_error = false; // true when an invalid char is detected

   307

   308

	if (StrEmpty(_keyboard_opt[0])) {

   309

		GetString(keyboard[0], STR_OSK_KEYBOARD_LAYOUT, lastof(keyboard[0]));

   310

	} else {

   311

		strncpy(keyboard[0], _keyboard_opt[0], lengthof(keyboard[0]));

   312

	}

   313

   314

	if (StrEmpty(_keyboard_opt[1])) {

   315

		GetString(keyboard[1], STR_OSK_KEYBOARD_LAYOUT_CAPS, lastof(keyboard[1]));

   316

	} else {

   317

		strncpy(keyboard[1], _keyboard_opt[1], lengthof(keyboard[1]));

   318

	}

   319

   320

	for (uint j = 0; j < 2; j++) {

   321

		const char *kbd = keyboard[j];

   322

		bool ended = false;

   323

		for (uint i = 0; i < OSK_KEYBOARD_ENTRIES; i++) {

   324

			_keyboard[j][i] = Utf8Consume(&kbd);

   325

   326

			/* Be lenient when the last characters are missing (is quite normal) */

   327

			if (_keyboard[j][i] == '\0' || ended) {

   328

				ended = true;

   329

				_keyboard[j][i] = ' ';

   330

				continue;

   331

			}

   332

   333

			if (IsPrintable(_keyboard[j][i])) {

   334

				errormark[j][i] = ' ';

   335

			} else {

   336

				has_error = true;

   337

				errormark[j][i] = '^';

   338

				_keyboard[j][i] = ' ';

   339

			}

   340

		}

   341

	}

   342

   343

	if (has_error) {

   344

		ShowInfoF("The keyboard layout you selected contains invalid chars. Please check those chars marked with ^.");

   345

		ShowInfoF("Normal keyboard:  %s", keyboard[0]);

   346

		ShowInfoF("                  %s", errormark[0]);

   347

		ShowInfoF("Caps Lock:        %s", keyboard[1]);

   348

		ShowInfoF("                  %s", errormark[1]);

   349

	}

   350

}

   351

   352

/**

   353

 * Show the on-screen keyboard (osk) associated with a given textbox

   354

 * @param parent pointer to the Window where this keyboard originated from

   355

 * @param q      querystr_d pointer to the query string of the parent, which is

   356

 *               shared for both windows

   357

 * @param button widget number of parent's textbox

   358

 * @param cancel widget number of parent's cancel button (0 if cancel events

   359

 *               should not be passed)

   360

 * @param ok     widget number of parent's ok button  (0 if ok events should not

   361

 *               be passed)

   362

 */

   363

void ShowOnScreenKeyboard(QueryStringBaseWindow *parent, int button, int cancel, int ok)

   364

{

   365

	DeleteWindowById(WC_OSK, 0);

   366

   367

	GetKeyboardLayout();

   368

	new OskWindow(&_osk_desc, parent, button, cancel, ok);

   369

}