WSINI.INI

Parameter

Description

AUTOCLEAR value

When an RWindow is manipulated by an application, this argument determines whether the invalid region will be cleared to its background colour (as set by either variant of RWindow::SetBackgroundColor()) before being redrawn.

The possible values are:

0 — the background will not be cleared, even if a background colour has been set. This is for use in debugging only.

1 — the default. The background will be cleared if a background colour has been set, but not if no background colour has been set.

LOG string

Used to specify the type of logging which is required. Loads one of the three logging DLLs, as specified by string. Possible values are:

FL — log to file

SR — log to the serial port (MARM only)

WN — log to another WIN32 window (WINS only)

LOGENABLE

If specified, enables logging from boot-up

LOGP filespec

Use this keyword to specify a fully qualified file name for the output log file.

NOBLANKSCREEN

Version 5.1 Only

Sets that the screen is not cleared at boot up or whenever no window is visible in a part of the screen. This feature is available only in ER5U.

Without the keyword set, the Root Window clears the screen at boot up and also whenever no other window is visible in part of the screen.

POINTER value

Withdrawn 6.0

Sets when the window server will generate pointer events. It has two possible values:

0 — The window server generates pointer events only when the pen is touching the digitiser. This is equivalent to pressing a mouse button. The window server generates drag events but not move events. This is the default value and is used for pen input.

1 — The window server generates pointer events whether or not a mouse button is pressed, i.e. it generates pointer move events as well as drag events. This is used for mouse or trackball input.

REBOOT value

Specifies the shell reboot mode. The following values are defined:

0 — the shell tries to reboot as soon as it exits (the default).

1 — the shell tries to reboot only when there are no clients.

2 — when the session finishes, kill the whole machine, even if other apps are running — for use during development only!

SCR_ROTATION<integer rotations>

Specify a list of screen rotations. This is introduced in ER5U.

The integer value is a positive integer which corresponds to a particular screen size mode.

The rotations value is a comma separated list which specifies, in degrees, the rotation values available for the given screen size.

E.g. SCR_ROTATION2 90,270.

SHELLCMD string

Specifies the command line argument to pass when starting the shell; similar to DOS box command parameters under Microsoft Windows.

Defaults to an empty string.

STARTUP string

Specifies the name of the shell to use. Defaults to shell.

WINDOWMODE COLOR<value >

or

WINDOWMODE GRAY<value>

This argument is used to set the default display mode. On the Emulator, it may be used to reflect the fact that different hardware may require different default display modes.

If this argument is omitted, or if the requested display mode value is not supported by the device, the machine's lowest display mode is used. An exception to this is that EGray2 will only be used if no other display modes are supported. The lowest display mode is the one which supports the fewest greys/colours. Note that all greyscale display modes are considered to be lower than any colour display mode.

For a colour display mode, value can be of the following: —

• 16 for EColor16,

• 256 for EColor256,

• 4K for EColor4K,

• 64K for EColor64K,

• 16M for EColor16M.

For instance, specifying WINDOWMODE COLOR256 gives a default display mode of 256 colours.

For a greyscale display mode, value can be one of the following: —

• 2 for EGray2,

• 4 for EGray4,

• 16 for EGray16,

• 256 for EGray256.

For instance, specifying WINDOWMODE GRAY16 gives a default display mode of 16 greys.

SIZE_MODE

Sets the screen mode enforcement. It is read when the system is booted. If it is not set then a value of 0 (ESizeEnforcementNone) is used.

See also: TScreenModeEnforcement, CWsScreenDevice::ScreenModeEnforcement(), CWsScreenDevice::SetScreenModeEnforcement()

SCR_WIDTH<n> width

Sets the screen width in pixels for a particular screen mode. The screen mode is set by n and width is the width in pixels.

e.g. SCR_WIDTH2 240 sets a width of 240 pixels for the screen size mode 2.

SCR_HEIGHT<n> height

Sets the screen height in pixels for a particular screen mode. The screen mode is set by n and height is the height in pixels.

SCR_TWIPS_WIDTH<n> width

Sets the screen width in twips for a particular screen mode. The screen mode is set by n and width is the width in twips.

SCR_TWIPS_HEIGHT<n> height

Sets the screen height in twips for a particular screen mode. The screen mode is set by n and height is the height in twips.