Hauptsprungleiste📈 Graphics VDUEintrag Nr. 196CPC 664/6128

GRA SET LINE MASK

&BD4C

Setzt die Linienmaske zum Zeichnen von Pixeln von Linien.

Original (SOFT 968): „Set the line mask for plotting pixels of lines.“

🔀Wie der Aufruf die Routine erreicht

Dein Programm            RAM-Sprungleiste            Low Kernel (RAM/ROM)        unteres ROM
─────────────            ────────────────            ────────────────────        ───────────
CALL &BD4C  ───────▶  &BD4C: RST 1 ─────────▶  &0008 LOW JUMP:           GRA SET LINE MASK
                         DW Low Address            ROM-Zustand merken,  ───▶  (Routine)
                         (Bit 15 = oberes ROM aus)  unteres ROM an                  │
     ◀──────────────────────────────────────────  ROM-Zustand zurück  ◀──── RET ──┘

📖Beschreibung

⚙️ Wirkung

  • Setzt die Linienmaske, die festlegt, wie Pixel auf Linien gezeichnet werden sollen. Wo ein Bit in der Maske gesetzt ist, wird das Pixel im Vordergrund gezeichnet (in Grafik-Stift-Tinte unter Verwendung des Grafik-Schreibmodus). Wo ein Pixel in der Maske nicht gesetzt ist, wird das Pixel entweder in der Grafik-Papier-Tinte unter Verwendung des Grafik-Schreibmodus gezeichnet oder überhaupt nicht gezeichnet, abhängig vom Grafik-Hintergrund-Schreibmodus.

🧮 Register auf einen Blick

EingabeA
Ausgabekeine
verändertkeine

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

➡️ Einsprungbedingungen

  • A enthält die zu verwendende Linienmaske.

⬅️ Rücksprungbedingungen

  • Alle Register und Flags bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • 🔀Diese Routine ist in der Firmware V1.0 nicht verfügbar.
  • Die Linienmaske wird beginnend mit Bit 7 bis Bit 0 und dann wieder beginnend mit Bit
  • 7 verwendet. Aufeinanderfolgende Linien verwenden die Maske so, wie sie beim Ende der vorherigen Linie hinterlassen wurde; die Maske wird zwischen Linien nicht zurückgesetzt.
  • Die Linienmaske legt fest, wie Pixel gezeichnet werden sollen. Das bedeutet, dass dieselbe Maske in den verschiedenen Bildschirmmodi deutlich unterschiedliche Effekte erzielt.
  • Die Maske wird auf die Linie angewendet, die von links nach rechts oder von unten nach oben verläuft, abhängig vom Winkel der Linie, unabhängig davon, in welcher Reihenfolge die Endpunkte der Linie angegeben sind.
  • Wenn das erste Pixel der Linie nicht gezeichnet wird, wird die Linienmaske zuerst auf das zweite Pixel der Linie angewendet. Für das fehlende erste Pixel wird sie nicht weitergeschaltet.
  • Die Standard-Zeilenmaske ist #FF, die die gesamte Linie im Vordergrund zeichnet.

🔀 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 DEFAULT &BD43GRA LINE &BDE2GRA LINE ABSOLUTE &BBF6GRA LINE RELATIVE &BBF9GRA SET BACK &BD46
💡 Quellen
Amstrad SOFT 968 „CPC 464/664/6128 Firmware“, Abschnitt 15 (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 SET FIRST &BD49GRA FROM USER &BD4F →