Wimp_PlotIcon_extended
WindowManager
» SWI Calls
» Wimp_PlotIcon
Wimp_PlotIcon (extended API)
(SWI &400E2)
In RISC OS 6 only:
| Entry | |
|---|---|
| R1 | Icon Block |
| R2 | “KSAT” (&5441534B) |
| R3 | Flags: |
| b0: R6 is bg colour & R7 is sprite area, else R6 is window handle | |
| b1: pointer is over the icon | |
| R4 | X offset |
| R5 | Y offset |
| R6 | Window background colour or -1 |
| or window handle (see flags b0) | |
| R7 | Sprite area (if flags b0) |
| Exit | |
|---|---|
| R0 | Corrupt |
| R2 | 0 – to confirm API presence |
In RISC OS 4.3x (and 4.4x assumed) and only when outside the redraw loop:
| Entry | |
|---|---|
| R1 | Icon Block |
| R2 | “TASK” (&4B534154) |
| R4 | X offset |
| R5 | Y offset and Flags: |
| b0: R6 is bg colour & R7 is sprite area, else R6 is window handle | |
| b1: pointer is over the icon | |
| R6 | Window background colour or -1 |
| or window handle (see flags b0) | |
| R7 | Sprite area (if flags b0) |
| Exit | |
|---|---|
| R0 | Corrupt |
| R2 | 0 – to confirm API presence |
Use
The extended API form of Wimp_PlotIcon allows window handle, background colour and sprite area to be specified.
Note that the RO4 version is highly bugged and should be avoided.
As there are two magic values for R2, one of which is a common constant, R2 should be set to zero when the extended API is not intended.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.