DirectInput to CEGUI utf32 - Revision history

Capek: because references rule

2011-03-06T01:37:52Z

because references rule

Kulik at 15:57, 28 February 2011

2011-02-28T15:57:24Z

Capek: Robot: Adding Category:Uncategorised

2011-02-26T16:48:03Z

Robot: Adding Category:Uncategorised

Capek: Robot: Cosmetic changes

2011-02-26T15:06:30Z

Robot: Cosmetic changes

stephb7 at 00:50, 28 January 2006

2006-01-28T00:50:58Z

stephb7 at 13:18, 16 January 2006

2006-01-16T13:18:32Z

stephb7 at 13:05, 16 January 2006

2006-01-16T13:05:40Z

stephb7 at 13:04, 16 January 2006

2006-01-16T13:04:16Z

Show changes

stephb7 at 12:49, 16 January 2006

2006-01-16T12:49:57Z

New page

This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function. It converts both simple characters as well as characters composed of a dead key as well as a single character. The value of zero is returned if a character could not be converted.

CEGUI::utf32 keycodeToUTF32( unsigned int scanCode)
{
CEGUI::utf32 utf = 0;

BYTE keyboardState[256];
unsigned char ucBuffer[3];
static WCHAR deadKey = '\0';

// Retrieve the keyboard layout in order to perform the necessary convertions
HKL hklKeyboardLayout = GetKeyboardLayout(0); // 0 means current thread
// This seemingly cannot fail
// If this value is cached then the application must respond to WM_INPUTLANGCHANGE

// Retrieve the keyboard state
// Handles CAPS-lock and SHIFT states
if (GetKeyboardState(keyboardState) == FALSE)
return utf;

/* 0. Convert virtual-key code into a scan code
1. Convert scan code into a virtual-key code
Does not distinguish between left- and right-hand keys.
2. Convert virtual-key code into an unshifted character value
in the low order word of the return value. Dead keys (diacritics)
are indicated by setting the top bit of the return value.
3. Windows NT/2000/XP: Convert scan code into a virtual-key
Distinguishes between left- and right-hand keys.*/
UINT virtualKey = MapVirtualKeyEx(scanCode, 3, hklKeyboardLayout);
if (virtualKey == 0) // No translation possible
return utf;

/* Parameter 5:
0. No menu is active
1. A menu is active
Return values:
Negative. Returned a dead key
0. No translation available
1. A translation exists
2. Dead-key could not be combined with character */
int ascii = ToAsciiEx(virtualKey, scanCode, keyboardState, (LPWORD) ucBuffer, 0, hklKeyboardLayout);
if(deadKey != '\0' && ascii == 1)
{
// A dead key is stored and we have just converted a character key
// Combine the two into a single character
WCHAR wcBuffer[3];
WCHAR out[3];
wcBuffer[0] = ucBuffer[0];
wcBuffer[1] = deadKey;
wcBuffer[2] = '\0';
if( FoldStringW(MAP_PRECOMPOSED, (LPWSTR) wcBuffer, 3, (LPWSTR) out, 3) )
utf = out[0];
else
{
// FoldStringW failed
DWORD dw = GetLastError();
switch(dw)
{
case ERROR_INSUFFICIENT_BUFFER:
case ERROR_INVALID_FLAGS:
case ERROR_INVALID_PARAMETER:
break;
}
}
deadKey = '\0';
}
else if (ascii == 1)
{
// We have a single character
utf = ucBuffer[0];
deadKey = '\0';
}
else
{
// Convert a non-combining diacritical mark into a combining diacritical mark
// Combining versions range from 0x300 to 0x36F; only 5 (for French) have been mapped below
// http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm
switch(ucBuffer[0])
{
case 0x5E: // Circumflex accent: â
deadKey = 0x302;
break;
case 0x60: // Grave accent: à
deadKey = 0x300;
break;
case 0xA8: // Diaeresis: ü
deadKey = 0x308;
break;
case 0xB4: // Acute accent: é
deadKey = 0x301;
break;
case 0xB8: // Cedilla: ç
deadKey = 0x327;
break;
default:
deadKey = ucBuffer[0];
}
}

return utf;
}

@@ Line 8: / Line 8: @@
 <source lang="cpp">
-  CEGUI::Font* guiFont = CEGUI::FontManager::getSingletonPtr()->createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);
+  CEGUI::Font* guiFont = CEGUI::FontManager::getSingleton().createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);
   guiFont->defineFontGlyphs(0x0020, 0x0323); // Latin character set
   mGUISystem->setDefaultFont(guiFont);

@@ Line 1: / Line 1: @@
 This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function. It converts both simple characters as well as characters composed of a dead key as well as a single character, simplifying multi-lingual support. The value of zero is returned if a character could not be converted.
@@ Line 5: / Line 7: @@
 By default CEGUI only loads a portion of the character set specified in a font. The following code loads the entire Latin character set:
   CEGUI::Font* guiFont = CEGUI::FontManager::getSingletonPtr()->createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);
   guiFont->defineFontGlyphs(0x0020, 0x0323); // Latin character set
   mGUISystem->setDefaultFont(guiFont);
 The Character Map (charmap.exe) tool is very useful when trying to figure out the range of characters needed.
+<source lang="cpp">
   CEGUI::utf32 keycodeToUTF32( unsigned int scanCode)
+  {
@@ Line 109: / Line 113: @@
   	return utf;
+  }
-[[Category:Uncategorised]]
+[[Category:HowTo]]

← Older revision		Revision as of 16:48, 26 February 2011
Line 109:		Line 109:
	return utf;		return utf;
	}		}
		+
		+	[[Category:Uncategorised]]

@@ Line 1: / Line 1: @@
-This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function.  It converts both simple characters as well as characters composed of a dead key as well as a single character, simplifying multi-lingual support.  The value of zero is returned if a character could not be converted.
+This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function. It converts both simple characters as well as characters composed of a dead key as well as a single character, simplifying multi-lingual support. The value of zero is returned if a character could not be converted.
-Some characters are composed by two keystrokes; a dead key followed by a simple key.  An example with the French (Canada) keyboard is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e.  In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic.  The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F.  This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages.  The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm
+Some characters are composed by two keystrokes; a dead key followed by a simple key. An example with the French (Canada) keyboard is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e. In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic. The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F. This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages. The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm
-By default CEGUI only loads a portion of the character set specified in a font.  The following code loads the entire Latin character set:
+By default CEGUI only loads a portion of the character set specified in a font. The following code loads the entire Latin character set:
   CEGUI::Font* guiFont = CEGUI::FontManager::getSingletonPtr()->createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);

@@ Line 6: / Line 6: @@
   CEGUI::Font* guiFont = CEGUI::FontManager::getSingletonPtr()->createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);
-  guiFont->defineFontGlyphs(0x0021, 0x0323);
+  guiFont->defineFontGlyphs(0x0020, 0x0323); // Latin character set
   mGUISystem->setDefaultFont(guiFont);

← Older revision		Revision as of 13:18, 16 January 2006
Line 2:		Line 2:

	Some characters are composed by two keystrokes; a dead key followed by a simple key. An example with the French (Canada) keyboard is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e. In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic. The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F. This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages. The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm		Some characters are composed by two keystrokes; a dead key followed by a simple key. An example with the French (Canada) keyboard is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e. In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic. The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F. This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages. The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm
		+
		+	By default CEGUI only loads a portion of the character set specified in a font. The following code loads the entire Latin character set:
		+
		+	CEGUI::Font* guiFont = CEGUI::FontManager::getSingletonPtr()->createFont("Arial", "c:/windows/fonts/arial.ttf", 16, CEGUI::Default);
		+	guiFont->defineFontGlyphs(0x0021, 0x0323);
		+	mGUISystem->setDefaultFont(guiFont);
		+
		+	The Character Map (charmap.exe) tool is very useful when trying to figure out the range of characters needed.

← Older revision		Revision as of 13:05, 16 January 2006
Line 1:		Line 1:
	This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function. It converts both simple characters as well as characters composed of a dead key as well as a single character, simplifying multi-lingual support. The value of zero is returned if a character could not be converted.		This function converts DirectInput's scan codes into a utf32 character value compatible with the injectChar() function. It converts both simple characters as well as characters composed of a dead key as well as a single character, simplifying multi-lingual support. The value of zero is returned if a character could not be converted.

−	Some characters are composed by two keystrokes; a dead key followed by a simple key. An example is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e. In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic. The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F. This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages. The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm	+	Some characters are composed by two keystrokes; a dead key followed by a simple key. An example with the French (Canada) keyboard is the letter è, which is composed of the dead key (diacritic) ALT-[ followed by the letter e. In order to correctly generate the letter è the dead key must be converted from a standalone diacritic to a combining diacritic. The unicode character set specifies the combining diacritics in the range of 0x300 to 0x36F. This current implementation only supports 5 diacritic, making the following code compatible with both English and French languages. The list of combining diacritics can be obtained from http://www.fileformat.info/info/unicode/block/combining_diacritical_marks/images.htm