# Emulator appearance

## Contents

- Overview
- Emulator configuration file
- Colour

## Overview

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.

## Emulator configuration file

The description of the settings is divided into the following areas:

- screen size and position
- LEDs

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.

##### Screen size and position

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.

##### LEDs

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

## Colour

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`

##### Details

`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`.
- the color display mode settings for the Emulator are set in the `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.