Indirections🔤 Text VDUCPC 464/664/6128

TXT OUT ACTION

&BDD9

Gib ein Zeichen oder einen Steuercode aus.

Original (SOFT 968): „Output a character or control code.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

  • Gib ein Zeichen auf dem Bildschirm aus oder befolge einen Steuercode (Zeichen #00..#1F). Arbeitet auf dem aktuell ausgewählten Stream (außer wie unten angegeben).

🧮 Register auf einen Blick

EingabeA
Ausgabekeine
verändertAFBCDEHL

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

➡️ Einsprungbedingungen

  • A enthält das Zeichen oder den Code.

⬅️ Rücksprungbedingungen

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

📝 Hinweise aus dem Handbuch

  • Diese Indirektion wird von TXT OUTPUT aufgerufen, um die Arbeit des Druckens von Zeichen oder der Befolgung der Steuercodes zu erledigen. Sie wird bereitgestellt, um dem Benutzer zu ermöglichen, die Methode zum Umgang mit Zeichen und Steuercodes zu ändern oder um dem Benutzer zu ermöglichen, die Ausgabe umzuleiten (zum Beispiel zum Drucker). TXT OUTPUT bewahrt lediglich die Register um den Aufruf von TXT OUT ACTION auf.
  • Steuercodes können bis zu 9 Parameter annehmen. Dies sind die Zeichen, die nach dem anfänglichen Steuercode gesendet werden. Die gesendeten Zeichen werden in einem Puffer gespeichert, bis genügend empfangen wurden, um alle erforderlichen Parameter zu bilden. Der Steuercode-Puffer ist nur lang genug, um 9 Parameterzeichen aufzunehmen.
  • Es gibt nur einen Steuercode-Puffer, der von allen Streams gemeinsam genutzt wird. Es ist daher möglich, unvorhersehbare Ergebnisse zu erhalten, wenn der Ausgabestream während des Sendens einer Steuercodesequenz geändert wird.
  • 🔀Wenn der VDU deaktiviert ist, werden keine Zeichen auf dem Bildschirm gedruckt. In der V1.1-Firmware werden Steuercodes, die in der Steuercodetabelle speziell markiert sind, nicht befolgt, wenn der VDU deaktiviert ist. Andere Steuercodes und alle Steuercodes in der V1.0-Firmware werden befolgt.
  • Wenn der Grafikzeichen-Schreibmodus aktiviert ist, werden alle Zeichen und Steuercodes mit dem Graphics VDU gedruckt (siehe GRA WR CHAR) und nicht befolgt. Normalerweise werden Zeichen durch den Text VDU geschrieben (siehe TXT WR CHAR).
  • Diese Indirektion wird eingerichtet, wenn TXT INITIALISE oder TXT 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

TXT OUTPUT &BB5ATXT WR CHAR &BB5D
💡 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.
← TXT UNWRITE &BDD6GRA PLOT &BDDC →