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

TXT VALIDATE

&BB87

Überprüfen, ob eine Cursorposition innerhalb des Fensters liegt.

Original (SOFT 968): „Check if a cursor position is within the window.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Überprüfe eine Bildschirmposition, um festzustellen, ob sie innerhalb des aktuellen Fensters liegt. Wenn nicht, dann bestimme die Position, an der ein Zeichen ausgegeben würde, nachdem die Regeln zum Erzwingen der Bildschirmposition innerhalb des Fensters angewendet wurden.

🧮 Register auf einen Blick

EingabeHL

AusgabeBCarryHL

verändertABF

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

➡️ Einsprungbedingungen

H enthält die logische Spalte der zu überprüfenden Position.
L enthält die logische Zeile der zu überprüfenden Position.

⬅️ Rücksprungbedingungen

Wenn das Drucken an der Position kein Rollen des Fensters verursachen würde:
Carry gesetzt.
B verändert.
Wenn das Drucken an der Position ein Aufwärtsrollen des Fensters verursachen würde:
Carry gelöscht.
B enthält #FF.
Wenn das Drucken an der Position ein Abwärtsrollen des Fensters verursachen würde:
Carry gelöscht.
B enthält #00.
Immer:
H enthält die logische Spalte, an der ein Zeichen ausgegeben würde.
L enthält die logische Zeile, an der ein Zeichen ausgegeben würde.
A und andere Flags verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Die Position auf dem Bildschirm wird in logischen Koordinaten angegeben. D. h. Zeile 1, Spalte 1 ist die obere linke Ecke des Fensters.
Bevor ein Zeichen geschrieben oder der Cursorfleck auf den Bildschirm gesetzt wird, validiert Text VDU die aktuelle Position, führt ein eventuell erforderliches Rollen durch und schreibt dann an die entsprechende Position.
folgendermaßen:
1/ Wenn die Position rechts vom rechten Rand des Fensters liegt, wird sie zum linken Rand des Fensters in der nächsten Zeile verschoben.
2/ Wenn die Position links vom linken Rand des Fensters liegt, wird sie zum rechten Rand des Fensters in der vorherigen Zeile verschoben.
3/ Wenn die Position nun über dem oberen Rand des Fensters liegt, wird sie zum oberen Rand des Fensters verschoben und das Fenster muss nach unten gerollt werden.
4/ Wenn die Position nun unter dem unteren Rand des Fensters liegt, wird sie zum unteren Rand des Fensters verschoben und das Fenster muss nach oben gerollt werden.

🧪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 VALIDATE (&BB87) – Beispiel für VisualZ80
; Aufruf aus BASIC: CALL &4000
        org &4000
        ld h,45         ; Spalte 45 liegt in Modus 1 (40 Spalten) außerhalb
        ld l,3
        call &bb87      ; TXT VALIDATE
        push hl
        push af
        ld hl,t
        call text
        pop af
        call flagc      ; Carry = 1: kein Rollen nötig
        ld a," "
        call &bb5a
        pop hl
        call hex16      ; korrigierte Position (Spalte 1, Zeile 4)
        call crlf
        ret
t:      db "Carry/Position: ",0
; --- Hilfsroutinen (Ausgabe über die Firmware) ---
crlf:   ld a,13         ; Zeilenumbruch (CR + LF)
        call &bb5a
        ld a,10
        jp &bb5a
flagc:  ld a,"0"        ; Carry-Flag als 0/1 ausgeben
        adc a,0
        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

SCR HW ROLL &BC4D SCR SW ROLL &BC50 TXT GET CURSOR &BB78

💡 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 CUR OFF &BB84 TXT PLACE CURSOR &BB8A →