6.10 Filled rectangle

Name:

»Filled rectangle«

Line-A Nummer:

$A005

Binding:

Bindings für filled_rect

Beschreibung:

Diese Line-A Funktion zeichnet ein ausgefülltes Rechteck durch Aufrufe der Horizontal line Funktion. Zusätzlich besteht die Möglichkeit, das Zeichnen des Rechtecks nur in einem zusätzlich übergebenen Clip-Bereich zuzulassen. Die folgenden Line-A Variablen werden benutzt:

Variable

Bedeutung

X-Koordinate der linken oberen Ecke des Rechtecks.

Y-Koordinate der linken oberen Ecke des Rechtecks.

X-Koordinate der rechten unteren Ecke des Rechtecks.

Y-Koordinate der rechten unteren Ecke des Rechtecks.

fg_bp_1

Bitwert der ersten Plane für die Farbe, mit der gefüllt werden soll.

fg_bp_2

Bitwert der zweiten Plane (nur niedrige oder mittlere Auflösung).

fg_bp_3

Bitwert der dritten Plane (nur niedrige Auflösung).

fg_bp_4

Bitwert der vierten Plane (nur niedrige Auflösung).

patptr

Zeiger auf ein Feld mit 16 Bit Linienmustern.

patmsk

Anzahl Linienmuster - 1. In Abhängigkeit von der y-Koordinate wird nun aus dem Feld mit den Linienmustern eines ausgewählt. Der Index des verwendeten Linienmusters läßt sich durch (y mod (patmsk + 1)) berechnen. Durch die Angabe mehrerer Linienmuster und mehrmaliges Aufrufen dieser Funktion für aufeinanderfolgende Zeilen lassen sich leicht auch komplexe Muster zeichnen.

wrt_mode

Schreibmodes, es sind die folgenden Modie möglich:

REPLACE 0	Replace
TRANS 1	Transparent (OR)
XOR 2	Inverse (XOR)
INVERS 3	Inverse Transparent (XOR mit not(LN_MASK))

clip

1 wenn Clipping gewünscht wird, 0 sonst.

xmn_clip

X-Koordinate der linken oberen Ecke des Clipping Bereichs, wenn Clipping eingeschaltet ist.

ymn_clip

Y-Koordinate der linken oberen Ecke des Clipping Bereichs, wenn Clipping eingeschaltet ist.

xmx_clip

X-Koordinate der rechten unteren Ecke des Clipping Bereichs, wenn Clipping eingeschaltet ist.

ymx_clip

Y-Koordinate der rechten unteren Ecke des Clipping Bereichs, wenn Clipping eingeschaltet ist.

Das Binding von TC übergibt Linienmuster, Schreibmodus und Farbe nicht an die filled_rect() Funktion, sondern benutzt separate Funktionen set_fg_bp(), set_wrt_mode(), set_pattern() und set_clipping() zum Setzen der Parameter in dem Line-A Parameterblock.

Ergebnis:

Die Funktion liefert kein Ergebnis

Verfügbar:

Alle TOS-Versionen.

Querverweis:

Binding Horizontal line

6.10.1 Bindings für filled_rect

Pure-C:

void filled_rect( int16_t x1, int16_t y1, int16_t x2, int16_t y2 );

Assembler:

; Register retten
movem.l   D0-D2/A0-A2,-(A7)
; Zeiger Parameterblock LINEA
move.l    pParamblk,A0
; linke obere Ecke, X-Koordinate in LINEA.x1
move.w    x1,(38,A0)
; linke obere Ecke, Y-Koordinate in LINEA.y1
move.w    y1,(40,A0)
; rechte untere Ecke, X-Koordinate in LINEA.x2
move.w    x2,(42,A0)
; rechte untere Ecke, Y-Koordinate in LINEA.x2
move.w    y2,(44,A0)
; Bit für erste Plane in LINEA.fg_bp_1
move.w    colbit0,(24,A0)
; Bit für erste Plane in LINEA.fg_bp_2
move.w    colbit1,(26,A0)
; Bit für erste Plane in LINEA.fg_bp_3
move.w    colbit2,(28,A0)
; Bit für erste Plane in LINEA.fg_bp_4
move.w    colbit3,(30,A0)
; Writemode in LINEA.wrt_mode
move.w    wmode,(36,A0)
; Linienmuster in LINEA.patptr
move.w    patptr,(46,A0)
; Anzahl Muster in LINEA.patmsk
move.w    patmsk,(50,A0)
; Clipmode in LINEA.clip
move.w    mode,(54,A0)
; linke obere Clip-Ecke, X-Koordinate in LINEA.xmn_clip
move.w    cx1,(56,A0)
; linke obere Clip-Ecke, Y-Koordinate in LINEA.ymn_clip
move.w    cy1,(58,A0)
; rechte untere Clip-Ecke, X-Koordinate in LINEA.xmx_clip
move.w    cx2,(60,A0)
; rechte untere Clip-Ecke, Y-Koordinate in LINEA.ymx_clip
move.w    cy2,(62,A0)
; Line-A Opcode
dc.w      $A005
; Register restaurieren
movem.l   (A7)+,D0-D2/A0-A2

Line-A

Horizontal line

Filled polygon