vt.s
Original bytes preserved. This is a browser-readable view.
; =====================================================================
; Shared Chapter 11 virtual-terminal library.
;
; Public services required by NOTES:
; VT_CLEAR()
; VT_WRITE(line,column,string)
; VT_VIEW() -> 00 Q, 01 MENU, 02 BRK
;
; Chosen low-level VT_WRITE ABI (implementation HOW):
; $8 line, conceptual 1..24
; $9 starting column, conceptual 1..32
; $10/$11 source pointer
; $12 SRC_ROM or SRC_RAM
; $13 byte length of string
; return $0 = 00 complete, 01 clipped/not stored
;
; The backing surface VT_BASE is private to this module. Consumers pass their
; own strings and never inspect or modify the surface directly.
; =====================================================================
VT_CLEAR:
PRE IX,VT_BASE
LDW $20,768
LD $0,&H20
VTC_LOOP:
STI $0,(IX+$SX)
SBW $20,$SY
JR NZ,VTC_LOOP
RTN
VT_WRITE:
; Empty request is complete regardless of coordinates.
AN $13,$13
JR NZ,VTW_LINE
LD $0,0
RTN
VTW_LINE:
LD $14,$8
SBC $14,1
JP C,VTW_BADLN
SBC $14,25
JP NC,VTW_BADLN
LD $14,$9
LD $22,0
VTW_LOOP:
; Fetch one requested source character and advance the caller's source pointer.
LD $15,$12
SBC $15,SRC_RAM
JR Z,VTW_RAM
PRE IZ,$10
LD $16,(IZ+$SX)
JR VTW_GOT
VTW_RAM:
PRE IX,$10
LD $16,(IX+$SX)
VTW_GOT:
ADW $10,$SY
; Column outside 1..32 clips this character but never wraps.
LD $15,$14
SBC $15,1
JR C,VTW_CLIP
SBC $15,33
JR NC,VTW_CLIP
; address = VT_BASE + (line-1)*32 + (column-1)
LDW $2,0
LD $2,$8
SB $2,$SY
BIUW $2
BIUW $2
BIUW $2
BIUW $2
BIUW $2
LDW $4,0
LD $4,$14
SB $4,$SY
ADW $2,$4
LDW $4,VT_BASE
ADW $2,$4
PRE IX,$2
ST $16,(IX+$SX)
JR VTW_NEXT
VTW_CLIP:
LD $22,1
VTW_NEXT:
AD $14,$SY
SB $13,$SY
JP NZ,VTW_LOOP
LD $0,$22
RTN
VTW_BADLN:
LD $0,1
RTN
; Convenience wrappers remain private implementation helpers.
VT_WROM:
LD $12,SRC_ROM
JP VT_WRITE
VT_WRAM:
LD $12,SRC_RAM
JP VT_WRITE
; Input $2 word, $8 line, $9 column. Writes minimal unsigned decimal text.
VT_PUTDEC:
CAL DEC16_BUF
LDW $10,NUM_BUF
LD $12,SRC_RAM
JP VT_WRITE
; ---------------------------------------------------------------------
; Viewer. Every invocation begins at virtual line 1.
; ---------------------------------------------------------------------
VT_VIEW:
PRE IX,VT_TOP
LD $0,1
ST $0,(IX+$SX)
VTV_REDRAW:
CAL VT_DRAW
VTV_WAIT:
CAL KEY_WAIT
SBC $17,2
JP Z,VTV_BRK
LD $12,$0
SBC $12,KEYQ
JP Z,VTV_Q
LD $12,$0
SBC $12,KEYQLC
JP Z,VTV_Q
LD $12,$0
SBC $12,KEYMENU
JP Z,VTV_MENU
LD $12,$0
SBC $12,KEYUP
JR Z,VTV_UP
LD $12,$0
SBC $12,KEYDN
JR Z,VTV_DOWN
JP VTV_WAIT
VTV_UP:
PRE IX,VT_TOP
LD $0,(IX+$SX)
SBC $0,1
JP Z,VTV_WAIT
SB $0,$SY
ST $0,(IX+$SX)
JP VTV_REDRAW
VTV_DOWN:
PRE IX,VT_TOP
LD $0,(IX+$SX)
SBC $0,21
JP Z,VTV_WAIT
AD $0,$SY
ST $0,(IX+$SX)
JP VTV_REDRAW
VTV_Q:
LD $0,0
RTN
VTV_MENU:
LD $0,1
RTN
VTV_BRK:
LD $0,2
RTN
; Draw four consecutive virtual lines, then physical-only overlays.
VT_DRAW:
PRE IX,VT_TOP
LD $8,(IX+$SX)
LD $6,&H00
CAL VT_DROW
PRE IX,VT_TOP
LD $8,(IX+$SX)
AD $8,$SY
LD $6,&H20
CAL VT_DROW
PRE IX,VT_TOP
LD $8,(IX+$SX)
AD $8,$SY
AD $8,$SY
LD $6,&H40
CAL VT_DROW
PRE IX,VT_TOP
LD $8,(IX+$SX)
AD $8,$SY
AD $8,$SY
AD $8,$SY
LD $6,&H60
CAL VT_DROW
; Upper-left overlay: VT
LD $6,&H00
LD $16,&H56
CAL PUTC
LD $16,&H54
CAL PUTC
; Lower-right overlay: zero-padded top virtual line, 01..21.
PRE IX,VT_TOP
LD $14,(IX+$SX)
LD $6,&H7E
SBC $14,20
JR C,VTD_LT20
LD $16,&H32
CAL PUTC
SB $14,20
JR VTD_ONE
VTD_LT20:
SBC $14,10
JR C,VTD_LT10
LD $16,&H31
CAL PUTC
SB $14,10
JR VTD_ONE
VTD_LT10:
LD $16,&H30
CAL PUTC
VTD_ONE:
LD $16,$14
AD $16,&H30
CAL PUTC
CAL CUR_OFF
RTN
; Input $8 virtual line (1..24), $6 physical row start.
VT_DROW:
LDW $2,0
LD $2,$8
SB $2,$SY
BIUW $2
BIUW $2
BIUW $2
BIUW $2
BIUW $2
LDW $4,VT_BASE
ADW $2,$4
PRE IX,VT_DPTR
STW $2,(IX+$SX)
PRE IX,VT_DIDX
LD $0,0
ST $0,(IX+$SX)
VTD_LOOP:
PRE IX,VT_DPTR
LDW $2,(IX+$SX)
PRE IX,$2
LD $16,(IX+$SX)
CAL PUTC
PRE IX,VT_DPTR
LDW $2,(IX+$SX)
ADW $2,$SY
STW $2,(IX+$SX)
PRE IX,VT_DIDX
LD $0,(IX+$SX)
AD $0,$SY
ST $0,(IX+$SX)
SBC $0,32
JR NZ,VTD_LOOP
RTN