Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



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