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

TXT GET MATRIX

&BBA5

Ermittle die Adresse einer Zeichenmatrix.

Original (SOFT 968): „Get the address of a character matrix.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Berechne einen Zeiger auf die Matrix für ein Zeichen und bestimme, ob es eine benutzerdefinierte Matrix ist.

🧮 Register auf einen Blick

EingabeA

AusgabeCarryHL

verändertAF

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

➡️ Einsprungbedingungen

A enthält das Zeichen, dessen Matrix gefunden werden soll.

⬅️ Rücksprungbedingungen

Wenn die Matrix in der benutzerdefinierten Matrixtabelle ist:
Carry gesetzt.
Wenn die Matrix im unteren ROM ist:
Carry gelöscht.
Immer:
HL enthält die Adresse der Matrix.
A und andere Flags verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Die Matrix kann sich im RAM oder im ROM befinden. Der Text VDU geht davon aus, dass die entsprechenden ROMs aktiviert oder deaktiviert sind, wenn er diese Routine aufruft, um die Matrix für ein Zeichen zu erhalten. (Das untere ROM ist eingeschaltet, das obere ROM ist normalerweise ausgeschaltet).
Die Matrix wird als ein 8 Byte langer bitsignifikanter Vektor gespeichert. Das erste Byte beschreibt die oberste Zeile des Zeichens und das letzte Byte die unterste Zeile. Bit 7 eines Bytes bezieht sich auf das linkeste Pixel einer Zeile und Bit 0 auf das rechteste Pixel. Wenn ein Bit in der Matrix gesetzt ist, sollte das Pixel mit der Stiftfarbe geschrieben werden. Wenn das Bit nicht gesetzt ist, sollte das Pixel entweder mit der Papierfarbe geschrieben oder unverändert gelassen werden (abhängig vom Zeichenschreibmodus).

🧪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

; TXT GET MATRIX (&BBA5) – Beispiel für VisualZ80
; Aufruf aus BASIC: CALL &4000
        org &4000
        ld a,"A"
        call &bba5      ; TXT GET MATRIX: HL = Adresse der 8 Bytes
        push hl
        ld hl,t
        call text
        pop hl
        call hex16      ; &3A08 im unteren ROM (Carry 0)
        call crlf
        ret
t:      db "Matrix von A: &",0
; --- Hilfsroutinen (Ausgabe über die Firmware) ---
crlf:   ld a,13         ; Zeilenumbruch (CR + LF)
        call &bb5a
        ld a,10
        jp &bb5a
hex16:  ld a,h          ; HL als vier Hex-Ziffern ausgeben
        call hex8
        ld a,l
        jr hex8
hex8:   push af         ; A als zwei Hex-Ziffern ausgeben
        rrca
        rrca
        rrca
        rrca
        call nibble
        pop af
nibble: and &0f         ; unteres Halbbyte als Ziffer 0-9/A-F
        add a,"0"
        cp "9"+1
        jr c,ziffer
        add a,7
ziffer: jp &bb5a        ; TXT OUTPUT
text:   ld a,(hl)       ; nullterminierten Text ab HL ausgeben
        or a
        ret z
        call &bb5a      ; TXT OUTPUT
        inc hl
        jr text

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.

&FFFF

&0000

&FFFF

&C000

&0000

P/V

Z80-Takte: 0 TCPC-Zeit: 0 µsROMs: unten aus, oben ausRAM-Konfig: &C0

Nächste Befehle (Disassembler)

0000ED FEHLE ▸ RESET ENTRY

0002C9RET

000300NOP

000400NOP

000500NOP

000600NOP

000700NOP

0008ED FEHLE ▸ 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)

Datei	Typ	Länge	Laden
HALLO.TXT	ASCII	33	–
ZAHLEN.BIN	binär	6	&5000
MUSTER.DAT	binär	16	&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 SET MATRIX &BBA8

💡 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 GET BACK &BBA2 TXT SET MATRIX &BBA8 →