retroforth/source/interfaces/native/x86/display.retro
crc 95afc6391f retro/native: use .retro suffix for driver sources
FossilOrigin-Name: 3a25995e909bee4a46f3f1a6310837ca9d32ad5f88fe2716d573d98227374e58
2019-06-28 16:49:21 +00:00

89 lines
2.4 KiB
Text

# VGA Text Display
This implements a text display driver for a standard VGA display
on x86 hardware. The exposed words will be in a `vga:` prefix.
First, define the memory region and screen dimensions. Adjust
these if your system is non-standard.
~~~
0xB8000 'VGA-BASE const
#80 'COLUMNS const
#25 'ROWS const
~~~
The VGA display uses a couple of control registers. I name
the ones I care about here.
~~~
0x3D4 'VGA-CURSOR const
0x3D5 'VGA-DATA const
~~~
Next, a couple of variables to track the cursor position.
~~~
'vga:Row var
'vga:Column var
~~~
~~~
:vga:update-cursor
@vga:Row COLUMNS * @vga:Column + dup
0x0F VGA-CURSOR pio:out-byte
0xFF and VGA-DATA pio:out-byte
0x0E VGA-CURSOR pio:out-byte
#8 shift 0xFF and VGA-DATA pio:out-byte ;
:vga:move-cursor (rc-)
!vga:Column !vga:Row vga:update-cursor ;
{{
'vga:Display d:create
COLUMNS ROWS * n:inc allot
:starting-address VGA-BASE COLUMNS #2 * + ;
:characters ROWS n:dec COLUMNS * ;
:save-byte dup ram:fetch-byte buffer:add #2 + ;
:save [ save-byte ] times drop ;
:all-but-top
[ &vga:Display buffer:set
starting-address characters save ] buffer:preserve ;
:move-up
VGA-BASE &vga:Display
[ over ram:store-byte #2 + ] s:for-each drop ;
:last-line VGA-BASE ROWS n:dec COLUMNS * #2 * + ;
:erase ASCII:SPACE over ram:store-byte #2 + ;
:erase-last-line last-line COLUMNS [ erase ] times drop ;
:scroll all-but-top move-up erase-last-line ;
:position ROWS n:dec #0 vga:move-cursor ;
:scroll? @vga:Row ROWS eq? ;
---reveal---
:vga:wrap scroll? [ scroll position ] if vga:update-cursor ;
}}
{{
:position (-a)
@vga:Row COLUMNS * #2 * @vga:Column #2 * + VGA-BASE + ;
:next
&vga:Column v:inc
@vga:Column COLUMNS gt? [ &vga:Row v:inc #0 !vga:Column ] if
vga:wrap ;
---reveal---
:vga:c:put (c-)
#10 [ #0 !vga:Column &vga:Row v:inc vga:wrap ] case
#13 [ #0 !vga:Column &vga:Row v:inc vga:wrap ] case
#8 [ &vga:Column v:dec #32 vga:c:put &vga:Column v:dec vga:update-cursor ] case
position ram:store-byte next ;
}}
:clear (-)
#0 #0 vga:move-cursor
VGA-BASE COLUMNS ROWS * [ ASCII:SPACE over ram:store-byte #2 + ] times drop
#0 #0 vga:move-cursor ;
:vga:initialize #1793 &c:put #2 + store &vga:c:put &c:put #3 + store ;
~~~