h6. [[WindowManager]] h6(. » [[WindowManager SWI Calls|SWI Calls]] h6((. » Wimp_PlotIcon h2. Wimp_PlotIcon (extended API) h5. (SWI &400E2) In RISC OS 6 only: |_<. Entry | | |<^. R1 |[[Icon Block|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|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 | h4. 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. h4. See also * [[Wimp_PlotIcon]]