How to configure an emulator with multiple screens

From v8.1b onwards, the emulator can be configured to support Symbian OS phones with multiple screens. To do this, the epoc.ini file should be divided into sections, each of which contains screen-specific properties that apply to a particular emulator window. Each section (apart from the first one) is preceded by the line _NewScreen_.

The screen-specific properties are:

• ScreenWidth

• ScreenHeight

• PhysicalScreenWidth

• PhysicalScreenHeight

• ScreenOffsetX

• ScreenOffsetY

• ColorDepth

• FasciaBitmap

Screen-specific properties can be repeated in each section. If not, or if any are omitted altogether, the default value for that property is used. Non screen-specific properties on the other hand, should not occur more than once, and they can occur anywhere in the file.

For example, the following epoc.ini file configures an emulator with two screens. The MegabytesOfFreeMemory value is not screen-specific, so it only occurs once, and its position in the file is irrelevant.

MegabytesOfFreeMemory   16
ScreenWidth 640
ScreenHeight 240
FasciaBitmap epoc.bmp
_NewScreen_
ScreenWidth 320
ScreenHeight 120
FasciaBitmap console.bmp