qdosmsq:traps:trap_3:blkp [QDOS Internals]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== IOW_BLKP etc ======


These SMSQ/E traps draw blocks using GD2 colours.
^Trap^Value of D0.B^Action^
|IOW_BLKP|$5C|Draw palette colour block|
|IOW_BLKT|$5D|Draw true colour block|
|IOW_BLKN|$5E|Draw native colour block|

^Call Parameters^^Return Parameters^^
|D0.B|See above|D0.L|Error return|
|D1.L| |D1.L|Corrupted?|
|D3.W|Timeout |D3.L|Preserved.|
|A0.L|Channel ID |A0.L|Preserved.|
|A1.L|Pointer to block definition.|A1.L|Corrupted?|
|A2.L|Pointer to colour definition|A2.L|Preserved?|

===== Errors =====

|ERR_NC|Not complete.|
|ERR_NO|Channel not open.|
|ERR_OR|Block outside window|


===== Notes =====
  * All registers not shown above are not used on entry and are probably preserved on exit.
  * A1.L points to a set of four words in the usual form:
    * X-size
    * Y-size
    * X-origin (relative to window origin)
    * Y-origin (relative to window origin)
  * A2.L points to three long words:
    * Stipple colour 1
    * Stipple colour 2
    * Stipple code (-1 to 3)

===== Example =====
The example below shows the use of this trap call to print a block. It is assumed that A0 contains the window's channel ID.

<code>
blck    moveq   #iow_blkt,d0    ; $5D
        lea     bk,a1           ; Block definition
        lea     cl,a2           ; Colour definition
        moveq   #-1,d3          ; Timeout
        trap    #3              ; Draw block
        tst.l   d0              ; OK? . .
        bne     error           ; . . no!

bk      dc.w    100,48          ; Size
        dc.w    10,10           ; Position in window

bk      dc.l    $B66D6D00       ; Brick (1st stipple colour)
        dc.l    $00FFFF00       ; Cyan  (2nd stipple colour)
        dc.l    3               ; Stipple code
</code>