SOURCE VIEWER

vt.s

Original bytes preserved. This is a browser-readable view.

DOWNLOAD ORIGINAL ↓

; =====================================================================
; 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