How to configure an emulator to support multiple fascias and screen orientations

From v8.1b onwards, the emulator can be configured to support multiple configurations, where each configuration refers to a separate fascia and screen orientation.

To support multiple configurations, each configuration needs to be defined in its own .ini file. The name of each of these .ini files is then placed into epoc.ini using the configuration keyword.

The easiest way to see how to define multiple configurations is to compare a single configuration definition with a multiple configuration definition.

Example of a single configuration definition

For a single configuration, all keywords and values are defined within the epoc.ini file; for example:

ScreenWidth 208
ScreenHeight 240
ScreenOffsetX 48
ScreenOffsetY 50
LedSize 0
fasciabitmap  c1.bmp
digitizeroffsetx 0
digitizeroffsety 0
digitizerheight 100
digitizerwidth 200
colordepth color16
disabledigitizer false
ledarrangevertically
ledgap 30
ledsize 25
megabytesoffreememory 4
physicalscreenheight 4000
physicalscreenwidth  6000
pointertype pen
virtualkey EStdKeyuparrow  rect 119,317 42,25
virtualkey EStdKeydownarrow rect 122,405 42,25
virtualkey EStdKeyrightarrow  rect 198,362 42,25
virtualkey Estdkeyleftarrow rect 48,362 42,25
virtualkey Estdkeyenter rect 121,362 42,25
NoVersionInfo
windowtitle Single Configuration
keymap leftalt 1 estdkeydevice0

Example of a multiple configuration definition

In a multiple configuration definition, each configuration is defined in its own .ini file instead of in epoc.ini; the names of these files are defined in epoc.ini, and identified by the configuration keyword. For a situation where there are four separate configurations (fro example), you replace the content of your epoc.ini file with:

configuration c1.ini
configuration c2.ini
configuration c3.ini
configuration c4.ini

You now need to define each of the configuration files. In this example, we have the four files: c1.ini, c2.ini, c3.ini and c4.ini. There are two additional keywords that can be used when defining confguration files: OnActivation and EmulatorControl.

OnActivation defines the orientation of the new fascia, and the key to be sent to the window server when this configuration is activated.

EmulatorControl defines the action that the emulator is to take when a specific region of the screen is clicked.

`c1.ini`	ScreenWidth 208 ScreenHeight 240 ScreenOffsetX 48 ScreenOffsetY 50 LedSize 0 fasciabitmap c1.bmp OnActivation 0 EKeyScreenDimension0 digitizeroffsetx 0 digitizeroffsety 0 digitizerheight 100 digitizerwidth 200 colordepth color16 debugmask BOOT disabledigitizer false ledarrangevertically ledgap 30 ledsize 25 physicalscreenheight 4000 physicalscreenwidth 6000 pointertype pen virtualkey EStdKeyuparrow rect 119,317 42,25 virtualkey EStdKeydownarrow rect 122,405 42,25 virtualkey EStdKeyrightarrow rect 198,362 42,25 virtualkey Estdkeyleftarrow rect 48,362 42,25 virtualkey Estdkeyenter rect 121,362 42,25 NoVersionInfo EmulatorControl NextConfig rect 14,500 29,22 EmulatorControl SelectConfig 3 rect 189,500 32,23 windowtitle ONE keymap leftalt 1 estdkeydevice0
`c2.ini`	ScreenWidth 208 ScreenHeight 240 ScreenOffsetX 48 ScreenOffsetY 240 LedSize 0 fasciabitmap c2.bmp OnActivation 270 EKeyScreenDimension1 digitizeroffsetx 0 digitizeroffsety 0 virtualkey EStdKeyuparrow rect 48,552 42,25 virtualkey EStdKeyleftarrow rect 120,507 42,25 virtualkey EStdKeydownarrow rect 199,552 42,25 virtualkey Estdkeyrightarrow rect 122,594 42,25 virtualkey Estdkeyenter rect 121,552 42,25 EmulatorControl NextConfig rect 223,640 29,22 windowtitle TWO
`c3.ini`	ScreenWidth 208 ScreenHeight 240 ScreenOffsetX 48 ScreenOffsetY 50 LedSize 5 fasciabitmap c1.bmp windowtitle THREE OnActivation 180 EKeyScreenDimension2 digitizeroffsetx 0 digitizeroffsety 0 virtualkey EStdKeyuparrow rect 119,317 42,25 virtualkey EStdKeydownarrow rect 122,405 42,25 virtualkey EStdKeyrightarrow rect 198,362 42,25 virtualkey Estdkeyleftarrow rect 48,362 42,25 virtualkey Estdkeyenter rect 121,362 42,25 EmulatorControl NextConfig rect 14,500 29,22 EmulatorControl SelectConfig 1 rect 189,500 32,23
`c4.ini`	ScreenWidth 208 ScreenHeight 240 ScreenOffsetX 48 ScreenOffsetY 50 LedSize 5 fasciabitmap c1.bmp windowtitle FOUR OnActivation 90 EKeyScreenDimension1 digitizeroffsetx 0 digitizeroffsety 0 virtualkey EStdKeyuparrow rect 119,317 42,25 virtualkey EStdKeydownarrow rect 122,405 42,25 virtualkey EStdKeyrightarrow rect 198,362 42,25 virtualkey Estdkeyleftarrow rect 48,362 42,25 virtualkey Estdkeyenter rect 121,362 42,25 NoVersionInfo EmulatorControl NextConfig rect 14,500 29,22 EmulatorControl SelectConfig 2 rect 189,500 32,23 keymap leftalt 1 estdkeydevice0