Showing changes from revision #0 to #1:
Added | Removed | Changed
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 |
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.