Mode specification is always through a single 32bit word value known as a mode specifier. This allows it to be supplied in many of the places that a mode number was used in earlier interfaces. This mode specifier can represent a number of ways of describing a mode. The following mode specifier formats are defined:

Mode number Sprite mode word Sprite pointer Mode selector

These can be distinguished by the following algorithm:

If the mode specifier is < 256: This is a mode number, and shadow bank selection. The mode number is in the low 7 bits, and shadow bank selection is given in bit 7. If the mode number is not recognised Service_ModeExtension is issued to determine the mode's parameters. Modes up to 7 are supported from the BBC onwards. Shadow modes are supported from the Master onwards (although they are less reliable from RISC OS 3.6 onwards) If the mode specifier has bit 0 set, this is a sprite mode word: Sprite mode words are given in the sprite header, but may also be supplied to many of the mode functions (except for display selection). They only contain the DPI (and thus eigenfactors), and type of data within the sprite. No resolution information is available. Sprite mode words are supported from RISC OS 3.5 onwards. If the mode specifier has bit 0 and 1 clear, this is a pointer to data, whose meaning is differentiated by the value of the first word. If the first word has bit 0 clear, the data is a sprite (the mode specifier is a sprite pointer): Sprite pointers allow information about the width and height to be included in the information, and allow the use of palette data as well. These types of mode specification are usually only used with ColourTrans_*operations. Sprite pointers are supported from RISC OS 3 onwards. If the first word has bit 0 set, the data is a mode selector: Mode selectors expose the base specifications for the mode and modifications to mode variables. Mode selectors allow for extended formats, but only a single format is currently defined. Mode selectors are supported from RISC OS 3.5 onwards. If the value has bit 0 clear and bit 1 set, this is an invalid mode specification.

Mode numbers may be extended through the Service_ModeExtension interface. This allows new numbered modes to be defined, either completely or based on other modes.

Sprite mode words allow some of the parameters of the mode to be determined, but because they do not include resolution information they cannot be selected. Sprite mode words are only supported from RISC OS 3.5 onwards.

The sprite mode word format has undergone a few revisions. The current definition of the sprite mode word is:

Set (indicator that this is a new format sprite, together with set bits in bits 27-31) Horizontal dots per inch, should be 180, 90, 45, 23/22, 11 Vertical dots per inch, should be 180, 90, 45, 23/22, 11

Sprite type : Old format mode word (mode is a standard number) 1 bpp 2 bpp 4 bpp 8 bpp 15 bpp in 16bit values 24 bpp in 32bit values CMYK 24 bpp compact format (allocated but not used) JPEG data (allocated but not used) Reserved

Alpha channel data present. May not be set for type 0 sprites Binary mask data present

For sprite types 1-4, the palette is only supported from RISC OS 3.6 onwards.

Although the DPI value should be the values defined above, values outside these may be supported. Certain interfaces, such as PlotSpriteTransformed, may use this information to render the sprites to the correct size for the display. Other interfaces, such as OS_ReadModeVariable and PlotSpriteScaled, may quantise these DPI values to the closest eigenfactor.

CMYK format sprites are supported from Select 2 onwards. JPEG data has been supported by third party extensions.

Sprite types 0 to 6 supported, but does not support palettes on types 1-4. Supports palettes on sprite types 1-4. Sprite types 0-6 and 7 (CMHK) supported. Supports alpha channel data in addition to the types supported by Select 2. Sprite types 0-6 supported. Adds support for sprite type 9 (JPEG) to those supported by RISC OS 3.5.

A mode selector is a word-aligned structure that defines the properties of a mode. This includes its resolution, numbers of colours, frame rate and other mode variables.

A mode selector has the following format:

mode selector flags:

1 (this differentiates it from a sprite pointer) mode specifier format (0 for this format) other flags (reserved - must be zero)

x-resolution (in pixels) y-resolution (in pixels) colour data format and depth: 1 bpp 2 bpp 4 bpp 8 bpp 15 bpp in 16 bit values 24 bpp in 32 bit values frame rate (in Hz); -1 => use highest rate available pairs of [mode variable index, value] words; there may be any number of these, including zero -1 (terminator)

Mode variables may be given in any order, although it is recommended that they be supplied in ascending order. Repeating a variable definition has undefined behaviour.

To allow modes to be described within a string specification, a mode string is able to be supplied to various interfaces. Mode strings must be converted to a mode specifier before they can be used with many interfaces. OS_ScreenMode allows these mode strings to be converted to and from mode specifiers.

The mode string takes the form of a space or comma separated list of parameters. Each parameter is a sequence of alphabetic characters defining the parmeter, followed by a number sequence and possible qualifiers.

The mode string parameters have the following format:

X resolution in pixels Y resolution in pixels Number of colours (# = 2, 4, 16, 64, 256, 32T, 32K, 16M) Number of greys (# = 4, 16, 256) Teletext mode, with specified number of colours (# as C) X eigen factor (# = 0, 1, 2, 3) Y eigen factor (# = 0, 1, 2, 3) Frame rate in Hz Teletext display width in characters Teletext display height in characters

Up to RISC OS Select 3, the X and Y resolution must be values from 100-9999. From Select 3 inwards, any value other than 0 may be supplied, although support for resolutions above 16384 may not be reliable.

Teletext mode selection and character width/height is supported from RISC OS Select 3 onwards.

Selection of modes with 64 colours results in an old-style VIDC 1 mode selection of a 256 colour mode with 192 derived colours. Prior to Select 3, selection of 'C256' would result in a the old-style VIDC 1 mode being selected.

The OS_ScreenMode interface for converting and selecting mode strings is supported from RISC OS Select 3 onwards.

*WimpMode supports selecting mode strings from RISC OS 3.5 onwards.

Supports mode string specifications X, Y, C, G, EX, EY and F, but only through '*WimpMode'. Supports specifications for T, TX and TY in addition to those supported by RISC OS 3.5. C256 will select a full 256 colour palette, whilst C64 will support a VIDC 1 palette. OS_ScreenMode mode string processing supported. Supports specifications for T, TX and TY in line with RISC OS Select 3. C64 will emulate old VIDC 1 palettes. OS_ScreenMode mode string processing supported.