Some languages (such as Chinese) have on-screen helpers and various keyboard layout functions to help with text input.
This feature is supported by Scaleform as well.
When building the engine from source, make sure that ENABLE_GFX_IME
definition is set in ConfigScaleform.h
This will link in the Scaleform IME support library.
Scaleform IME support library is only available for Windows.
For EaaS users, the engine is shipped as pre-compiled binaries. These binaries have Scaleform IME support.
At this point, IME support is available in the binaries, but it's not necessarily active.
You can edit game.cfg
for your project and set the CVar: sys_ime=1
Note: IME support is never available in the Sandbox, it can only be used in the game launcher.
To check that IME support is available, use the GameSDK sample project's main menu in the game launcher.
By going to "Multiplayer" and then "Host Server" menu, you have some text fields to enter text.
Depending on the current language setting of the OS, you will be presented with various options.
For example, with input language set to Chinese it should look similar to the below screenshot:
In the GameSDK/Libs/UI/FlashAssets/cryflash
folder will be a file LanguageBar.as
that wraps the language bar functionality.
This allows you to easily implement support for this feature in other Flash files.
The default UI framework will activate the language bar when a text field is being written to.
Note: The IME candidate-list file has been created to import from the SDK's default font library (HUD_Font_LocFont.gfx
).
From this file it will read the Font_Body
ActionScript symbol to render glyphs.
For additional information on font importing and exporting read also UI Localization