|
|
|
|
|
|
The appearance of the Emulator may be customised by editing two configuration files. The main Emulator configuration file controls screen size, position, and LEDs. The Emulator can also be configured to be in colour or black and white through another configuration file.
The description of the settings is divided into the following areas:
Any setting not specified in a configuration file is given the value listed in the Default column.
For example, the generic configuration file epoc.ini, has the settings:
ScreenOffsetX 99
ScreenOffsetY 40
which sets the position of the Emulator screen to non-default values.
|
Item |
Description |
Default |
|
ScreenHeight |
Height of the screen in pixels. |
240 |
|
ScreenWidth |
Width of the screen in pixels. |
640 |
|
PhysicalScreenHeight |
Height of the screen in twips. |
2858 |
|
PhysicalScreenWidth |
Width of the screen in twips. |
7620 |
|
ScreenOffsetX |
Horizontal offset of the Emulator screen from the top-left of the window in pixels |
90 |
|
ScreenOffsetY |
Vertical offset of the Emulator screen from the top-left of the window in pixels |
51 |
The twips settings allow the GDI’s twips-to-pixels mapping functions to be changed according the size of the physical screen on the emulated model. The default values correspond to 0.21mm pixel size or 121 pixels per inch.
The Emulator simulates two hardware LEDs. The following settings determine the appearance of these LEDs.
|
Item |
Description |
Default |
|
LedArrangeVertically |
Arrange LEDs vertically. This is the default. |
|
|
LedArrangeHorizontally |
Arrange LEDs horizontally. |
|
|
LedGap |
Gap between LEDs in pixels. |
5 |
|
LedOffsetX |
Horizontal offset of LEDs from the top-left corner of the window in pixels. |
36 |
|
LedOffsetY |
Vertical offset of LEDs from the top-left corner of the window in pixels. |
45 |
|
LedSize |
Diameter of LEDs in pixels. |
14 |
A batch file instcol.bat, installed in \epoc32\tools\, can be used to switch between colour and greyscale versions of the Emulator.
For colour, type:
INSTCOL CL
For greyscale, type:
INSTCOL BW
instcol.bat installs the appropriate versions of .aif and .mbm files, and of wsini.ini.
.aif and .mbm files are used to store the icons which represent an application when it is embedded or appears in the System screen or on the Extras bar. The Emulator is supplied with two sets of .aif and .mbm files. Greyscale and colour .aif files are supplied as *.abw and *.acl respectively and .mbm files are supplied as *.mbw and *.mcl.wsini.ini configuration file for the window server — the EPOC component that manages the screen, keyboard and pointer. For details of this file, see the "Window server configuration" topic in the EPOC C++ SDK System Documentation. Colour and greyscale versions of wsini.ini files are supplied.
|
|
|
|
|
|