Hauptsprungleiste🔤 Text VDUEintrag Nr. 32CPC 464/664/6128

TXT RD CHAR

&BB60

Liest ein Zeichen vom Bildschirm.

Original (SOFT 968): „Read a character from the screen.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

  • Liest ein Zeichen vom Bildschirm an der Cursorposition des aktuell ausgewählten Streams.

🧮 Register auf einen Blick

Eingabekeine
AusgabeACarry
verändertF

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

➡️ Einsprungbedingungen

  • Keine Bedingungen.

⬅️ Rücksprungbedingungen

  • Wenn ein erkennbares Zeichen gefunden wurde:
  • Carry gesetzt.
  • A enthält das gelesene Zeichen.
  • Wenn kein erkennbares Zeichen gefunden wurde:
  • Carry gelöscht.
  • A enthält null.
  • Immer:
  • Andere Flags verändert.
  • Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • 🔀In der V1.1-Firmware wird die Cursorposition vor dem Lesen des Zeichens auf legal (innerhalb des Fensters) gezwungen. Dies kann dazu führen, dass der Bildschirm rollt. Dasselbe gilt nicht in der V1.0-Firmware, wo die Cursorposition nicht auf legal gezwungen wird und Maßnahmen ergriffen werden müssen, um zu vermeiden, Zeichen von außerhalb des Fensters zu lesen.
  • Das Lesen wird durchgeführt, indem die auf dem Bildschirm gefundene Matrix mit den Matrizen verglichen wird, die zur Zeichenerzeugung verwendet werden. Infolgedessen kann das Ändern einer Zeichenmatrix, das Ändern der Stift- oder Papierfarben oder das Ändern des Bildschirms (z. B. das Zeichnen einer Linie durch ein Zeichen) das Zeichen unlesbar machen.
  • Um das Zeichen tatsächlich vom Bildschirm zu lesen, wird die TXT UNWRITE-Indirektion aufgerufen.
  • Es werden besondere Vorsichtsmaßnahmen gegen die Erzeugung von inversem Leerzeichen (Zeichen #8F) getroffen. Zunächst wird das Zeichen gelesen unter der Annahme, dass der Hintergrund des Zeichens in der aktuellen Papierfarbe geschrieben wurde und jede andere Farbe als Vordergrund behandelt wird. Wenn dies kein erkennbares Zeichen erzeugt oder ein inverses Leerzeichen erzeugt, wird ein weiterer Versuch unternommen, indem angenommen wird, dass der Vordergrund des Zeichens in der aktuellen Stiftfarbe geschrieben wurde und jede andere Farbe als Hintergrund behandelt wird.
  • Die Zeichen werden beginnend mit #00 und endend mit #FF abgetastet.

🔀 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

TXT UNWRITE &BDD6TXT WR CHAR &BB5D
💡 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.
← TXT WR CHAR &BB5DTXT SET GRAPHIC &BB63 →