OS_ScreenMode 14 (changes)
Showing changes from revision #3 to #4:
Added | Removed | Changed
OS SWI Calls
» OS_ScreenMode
» OS_ScreenMode 14
OS_ScreenMode 14
(SWI &65)
| Entry | |
|---|---|
| R0 | 14 |
| R1 | Pointer to Mode Selector Block |
| R2 | Pointer to Mode String to fill in |
| R3 | Size of string buffer (bytes) |
| Exit | |
|---|---|
| R0 | Error, or preserved |
| R3 | Less than zero: Negative size of buffer required |
| Zero: String has been filled in | |
| - | All other registers preserved |
Use
The purpose of this call is to convert a mode selector block to a mode string.
To determine the size of the required buffer, call once with R3 set to zero, and then allocate -R3 bytes to store the string.
Notes
Note that converting a mode selector block to a string and then back to a selector may result in the loss of some information; mode strings are not capable of representing the full set of values that can be specified in mode selectors.
See also OS_ScreenMode 13 to convert a mode string to a mode selector block.
This call is available in RISC OS Select and RISC OS 5.21+
See also
Other languages documentation
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.