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.8  Arbitrary line                                                TOS

 Name:          »Arbitrary line«

 Line-A Nummer: $A003

 Binding:       Bindings für draw_line

 Beschreibung:  Diese Line-A Funktion zeichnet eine Line von links 
                oben nach rechts unten. Die folgenden Line-A Variablen 
                werden benutzt:

                 Variable  Bedeutung

                 x1        X-Koordinate des ersten Endpunkts.
                 y1        Y-Koordinate des ersten Endpunkts.
                 x2        X-Koordinate des zweiten Endpunkts.
                 y2        Y-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).
                 ln_mask   Bitmuster für den Linientyp. Das Bitmuster 
                           ist als Punktemuster zu interpretieren.
                 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))
                 lstlin    Soll der letzte Pixel der Linie gezeichnet 
                           werden (1) oder nicht (0).

                Hinweis: Unabhängig von der Reihenfolge der 
                Koordinaten wird die Linie immer von links oben nach 
                rechts unten gezeichnet.

                Für eine horizontale Linie steht die schnellere 
                Funktion $A004 Horizontal line zur Verfügung.

                Das Bindings von TC übergibt Linienmaske, Schreibmodus 
                und Farbe nicht an die draw_line Funktion sonder 
                benutzt separate Funktionen set_fg_bp(), set_ln_mask() 
                und set_wrt_mode() zum Setzen der Parameter in dem 
                Line-A Paramterblock.

 Ergebnis:      Die Funktion liefert kein Ergebnis. Das Feld ln_mask 
                des Line-A Paramterblocks ist durch den 
                Ausgabealgorithmus geshiftet.

 Verfügbar:     Alle TOS-Versionen.

 Querverweis:   Binding   LINEA   Horizontal line