Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File6.9  Horizontal line                                               TOS

 Name:          »Horizontal line«

 Line-A Nummer: $A004

 Binding:       Bindings für horizontal_line

 Beschreibung:  Diese Line-A Funktion zeichnet eine horizontale Line. 
                Die folgenden Line-A Variablen werden benutzt:

                 Variable   Bedeutung

                 x1         X-Koordinate des ersten Endpunkts.
                 y1         Y-Koordinate der Linie.
                 x2         X-Koordinate des zweiten Endpunkts.
                 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))
                 multifill  0 gibt an, das nur die erste Farbebene 
                            gezeichnet werden soll, ein Wert >0 daß 
                            alle Farbebenen gezeichnet werden sollen.

                Hinweis: Diese Funktion wird intern für die 
                Flächenfüllroutinen benutzt.

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

 Ergebnis:      Die Funktion liefert kein Ergebnis.

 Verfügbar:     Alle TOS-Versionen.

 Querverweis:   Binding   LINEA   Filled rectangle