Indirections📈 Graphics VDUCPC 464/664/6128

GRA LINE

&BDE2

Eine Linie zeichnen.

Original (SOFT 968): „Draw a line.“

🔀Wie der Aufruf die Routine erreicht

Firmware-Routine (z. B. TXT OUTPUT)          Indirection im RAM              Standardroutine im ROM
──────────────────────────────────           ──────────────────              ───────────────────────
… CALL &BDE2 ───────────────────▶  &BDE2: JP xxxx  ─────────▶  GRA LINE
                                              ▲
                     eigenes Programm kann die 3 Bytes überschreiben (JP meine_routine)
                     → die Firmware benutzt ab sofort die eigene Routine

📖Beschreibung

⚙️ Wirkung

  • Zeichnet eine Linie zwischen der aktuellen Grafikposition und dem angegebenen Endpunkt unter Verwendung des aktuellen Grafikschreibmodus. Punkte auf der Linie, die außerhalb des aktuellen Grafikfensters liegen, werden nicht gezeichnet. Die aktuelle Grafikposition wird immer zum angegebenen Endpunkt verschoben.

🧮 Register auf einen Blick

EingabeDEHL
Ausgabekeine
verändertAFBCDEHL

Automatisch aus den Bedingungen abgeleitet – bei Fallunterscheidungen („wenn … dann“) gilt der Volltext unten.

➡️ Einsprungbedingungen

  • DE enthält die Benutzer-X-Koordinate des Endpunkts.
  • HL enthält die Benutzer-Y-Koordinate des Endpunkts.

⬅️ Rücksprungbedingungen

  • AF, BC, DE und HL verändert.
  • Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • Die Position des Endpunkts wird in Benutzerkoordinaten angegeben, d. h. relativ zum Benutzerursprung.
  • Diese Indirektion wird von GRA LINE RELATIVE und GRA LINE ABSOLUTE verwendet, um die angeforderte Linie zu zeichnen. Sie wird bereitgestellt, damit der Benutzer die Methode zum Linienzeichnen ändern kann (zum Beispiel die Ausgabe an einen X-Y-Plotter). GRA LINE RELATIVE rechnet von relativen in Benutzerkoordinaten um und ruft dann die Indirektion auf; GRA LINE ABSOLUTE ruft die Indirektion sofort auf.
  • Die Linie wird in horizontale oder vertikale Abschnitte aufgeteilt, die separat gezeichnet werden (siehe SCR HORIZONTAL und SCR VERTICAL). Die Indirektion SCR WRITE wird
  • aufgerufen, um die Punkte in diesen Abschnitten zu schreiben. Das bedeutet, dass die Linie unter Verwendung des aktuellen Grafikschreibmodus gezeichnet wird.
  • 🔀In der Firmware V1.0 wird die Linie in der aktuellen Stiftfarbe gezeichnet. In der Firmware V1.l bestimmt jedoch die Einstellung der Linienmaske, wie Pixel auf der Linie gezeichnet werden. Die Linienmaske ist bit-signifikant und wird wiederholt in der Reihenfolge Bit 7, Bit 6 bis hinunter zu Bit 0 für jedes Pixel in der Linie verwendet. Wenn das Bit eins ist, wird das Pixel in der Grafikstiftfarbe gezeichnet. Wenn das Bit null ist, hängt die ausgeführte Aktion vom Grafik-Hintergrundschreibmodus ab. Wenn der Hintergrundmodus undurchsichtig ist, wird das Pixel in der Grafikpapierfarbe gezeichnet. Wenn der Hintergrundmodus transparent ist, wird das Pixel nicht gezeichnet.
  • nicht gezeichnet, wenn der Erstpunkt-Zeichenmodus auf falsch gesetzt ist.
  • Diese Indirektion wird eingerichtet, wenn GRA INITIALISE oder GRA RESET aufgerufen wird.

🔀 markiert: Unterschiede zwischen Firmware V1.0 (464) und V1.1 (664/6128).

🧪Beispielprogramm – ausführen, ändern, Schritt für Schritt

Das Programm liegt bei &4000 und würde auf dem echten CPC mit CALL &4000 aus BASIC gestartet. Hier läuft es im Z80-Emulator; die Firmware ist nachgebildet.
bereit
🐞 Im großen Debugger öffnen
0
1
2
3
Rand
Modus 1 · Basis &C000 · Versatz &0000
Tastenpuffer: leer
Gedrückt gehaltene Tasten (für KM TEST KEY / KM GET JOYSTICK) per Klick umschalten; die Zahl ist die Tastennummer.
Register & Flags
AF
&FFFF
BC
&0000
DE
&0000
HL
&0000
IX
&FFFF
IY
&FFFF
SP
&C000
PC
&0000
S
1
Z
1
Y
1
H
1
X
1
P/V
1
N
1
C
1
Z80-Takte: 0 TCPC-Zeit: 0 µsROMs: unten aus, oben ausRAM-Konfig: &C0
Nächste Befehle (Disassembler)
0000HLE ▸ RESET ENTRY
0002RET
0003NOP
0004NOP
0005NOP
0006NOP
0007NOP
0008HLE ▸ LOW JUMP
Firmware
Firmware jetzt
▶ RESET ENTRY · Details
Letzte Falle: –
Letzte Firmware-Aufrufe
noch keine
Weitere Anzeigen: Speicher, Stapel, Ton, Dateien, Drucker, Kernel
Speicher
400000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
401000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
402000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
403000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
404000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
405000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
406000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
407000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
PCSP(HL)(DE)Leseansicht mit aktueller ROM-/Bank-Einblendung
Stapel
C0000000← SP
C0020000
C0040000
C0060000
C0080000
C00A0000
C00C0000
C00E0000
Ton (Sound Manager)
Kanal A
still
4 von 4 Plätzen frei
Kanal B
still
4 von 4 Plätzen frei
Kanal C
still
4 von 4 Plätzen frei
Dateien (simuliertes Laufwerk)
DateiTypLängeLaden
HALLO.TXTASCII33–
ZAHLEN.BINbinär6&5000
MUSTER.DATbinär16&6000
Eingabe: keine · Ausgabe: keine
Drucker
(noch nichts gedruckt)
Kernel: Zeit & Ereignisse
Zeit (KL TIME PLEASE): 0 × 1/300 s = 0.00 s · Interrupts: 0
keine Ereignisblöcke angemeldet

🔗Verwandte Einträge

GRA LINE ABSOLUTE &BBF6GRA LINE RELATIVE &BBF9GRA SET BACK &BD46GRA SET FIRST &BD49GRA SET LINE MASK &BD4CSCR HORIZONTAL &BC5FSCR VERTICAL &BC62
💡 Quellen
Amstrad SOFT 968 „CPC 464/664/6128 Firmware“, Abschnitt 16 (Beschreibung, übersetzt); Adresse und Name abgeglichen mit Taylor/Defoe „The Amstrad CPC Firmware Guide“. Simulation: eigene Nachbildung (HLE) – Laufzeiten der Firmware selbst werden nicht nachgebildet.
← GRA TEST &BDDFSCR READ &BDE5 →