VGA-Mode 03h
Part 4: of the asm-8086/88 Series
December 21, 2024 - Tommy Dräger
In the 8086-era DOS environment, text display typically relied on the BIOS and the graphics adapter’s built-in character generator rather than any sophisticated font rendering system. The fonts were firmly tied to specific text modes implemented by adapters such as CGA, EGA, or VGA. One of the most common modes was text mode 03h, which presented an 80×25 text grid.
In one of our previous deep dives, we explored the infamous VGA-Mode 13h and how to integrate hardware timers to produce simple beeps with the PC-Speaker. This time, we’ll change the appearance of an ASCII character — in this case 'A'—by redefining its pixel data. In our next part you will also understand where this is actually heading for.
ASCII and the DOS Character Set
ASCII (American Standard Code for Information Interchange) is originally a 7-bit code that defines characters (letters, digits, punctuation) in the range 0–127. In DOS, the standard extended ASCII set (often called Code Page 437) added an additional 128 characters (128–255), including box-drawing characters, symbols, and other glyphs used frequently in the DOS world.
Text Mode 03h (80×25)
One of the typical display modes used in 8086 DOS for text output is Mode 03h. In Mode 03h, the screen is divided into 80 columns and 25 rows of text characters. Each position on the screen is one text cell which holds one character plus attributes (like foreground and background colors, blinking, etc.).
-
With the earliest CGA (Color Graphics Adapter), each text cell was typically an 8×8 pixel matrix (though some adapters might effectively use 8×14 or 9×14 for EGA, and 9×16 for VGA).
-
For standard VGA in 80×25 text mode, each character cell is often 9 pixels wide and 16 pixels tall (though the actual glyph itself might only occupy 8 pixels in width, with the 9th column used for spacing or other features).
If you consider the typical VGA text mode of 9×16 character cells in 80×25, the total screen resolution in terms of raw pixels is 720×400 (80 columns × 9 pixels wide, 25 rows × 16 pixels tall). In Mode 03h, each character is stored in video RAM (at ES:DI B800h:0000h) with a Byte for the character Index (00h - FFh) and another byte for defining foreground color and background color (0-F for the Background and 0-F for the Foreground).
How to?
There are times you might want to go beyond the default text-mode look. Maybe you want to display your own symbols, or get creative with ASCII graphics. In DOS and other low-level environments, you have an awesome ability to poke the BIOS or VGA memory directly to define what each character’s pixels look like. We will use the BIOS' interrupt 10h with AL = 11h to load our custom font. Let's break it down step by step:
Step By Step
First let's clone our startup enviroment again so that you can follow along:
git clone [email protected]:MilesTails01/i8086_boilercode.gitAfter downloading you need to unpack DOSBOX.zip and TOOLS.zip
cd \bin
tar -xf TOOLS.zip
tar -xf DOSBOX.zipbuild.bat // Compile, Link and Start the source
debug.bat // Starts AFDEBUG and loads the compiled exe
start.bat // Start the program without rebuilding itRemove anything that is not needed. Keep the code simple and start with the minimum
; #################################
; # ASCII.ASM #
; #################################
; #################################
; # STACK #
; #################################
STACK SEGMENT PARA STACK
db 256 dup(0)
STACK ENDS
; #################################
; # DATA #
; #################################
DATA SEGMENT PARA 'DATA'
DATA ENDS
; #################################
; # CODE #
; #################################
CODE SEGMENT PARA 'CODE'
ASSUME cs:CODE, ds:DATA, ss:STACK
mov ax, DATA
mov ds, ax
mov ax, STACK
mov ss, ax
mov sp, 256
CODE ENDSStep 1
Let's define our character pixel data first. 0 will become the background color and 1 will become the foreground color. Keep in mind in normal 80x25 Mode the dimension for a character are 9x16. We will define 14 rows each row containing 8bit cause (keep in mind to make the 9th bit 0 cause db is limited to 1 byte). This character will be striped block if you wonder what it will look like later.
CHAR_DATA db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010bStep 2
Let's define a print function to fill the whole screen with the character A
PRINT PROC NEAR
mov ax, 0B800h ; VGA text mode memory segment
mov es, ax
mov di, 0 ; Start at the top-left of the screen
mov cx, 2000 ; 80x25 screen = 2000 characters
mov al, 'A' ; ASCII code for 'A'
mov ah, 19h ; Attribute byte (blue on white)
rep stosw ; Fill screen with 'A'
ret
PRINT ENDPStep 3
Now the important part: We will use interupt 10h (Bios Interupt) with AH set to 11h. I wrote the definition of the parameter for AX, BX, CX, DX and BP in the comments.
REPLACE_ASCII PROC NEAR
; mov ax, 03h ; Set video mode to text mode (80x25, color)
; int 10h ; 9x16 font size
;
; mov ax, 1112h ; Force 8x8 font size for character cells
; xor bl, bl ; RAM block
; int 10h
; Change text mode character (int 10h)
; AH = 11h
; BH = Number of bytes per character
; CX = Number of characters to change
; DX = Starting character to change
; ES:BP = Offset of character data
push ds
pop es ; make sure es = ds
lea bp, CHAR_DATA ; Pointer to custom font data
mov ax, 1100h ; Load user-defined font
mov bh, 0Eh ; Number of bytes per character
xor bl,bl ; RAM block
mov cx, 01h ; Number of characters to replace = 1 for now
mov dx, 41h ; Starting character to change (41h = 'A' in ASCII)
int 10h ; Call BIOS to load the font
ret
REPLACE_ASCII ENDPStep 4
Optional: If you like you can print the current ASCII table in the middle of the screen ;)
ASCIIPRINT PROC NEAR
mov ax, 0B800h ; VGA text mode memory segment
mov es, ax
xor di, di ; Reset offset
mov cx, 5 ; Total number of characters (0-255)
mov ah, 4Fh ; Attribute byte (red on white)
mov dl, 10 ; Padding on the left (adjust as needed)
mov dh, 60 ; Total width of the centered line (adjust as needed)
mov di, 1620 ; Row (10 x 80 + padding) * 2, starting with left padding
PrintLoop:
stosw ; Store the character (AL) and attribute (AH)
inc al ; Move to the next ASCII character
dec dh ; Decrement width counter
jnz PrintLoop ; Continue until row width is filled
add di, 40 ; Move to the next row with padding ((80 - 60) * 2)
mov dh, 60 ; Reset row width
loop PrintLoop ; Repeat for all 256 characters
ret
ASCIIPRINT ENDPResult
Every character of A got replaced with the new striped block. This Glyph will come in very handy in a later article.
Complete Code
; #################################
; # ASCII.ASM #
; #################################
; #################################
; # STACK #
; #################################
STACK SEGMENT PARA STACK
db 256 dup(0)
STACK ENDS
; #################################
; # DATA #
; #################################
DATA SEGMENT PARA 'DATA'
CHAR_DATA db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
db 010101010b
DATA ENDS
; #################################
; # CODE #
; #################################
CODE SEGMENT PARA 'CODE'
ASSUME cs:CODE, ds:DATA, ss:STACK
mov ax, DATA
mov ds, ax
mov ax, STACK
mov ss, ax
mov sp, 256
; #################################
; # MAIN #
; #################################
call REPLACE_ASCII
call PRINT
call ASCIIPRINT
ret
; =============================
; | FUNCTIONS |
; =============================
PUBLIC REPLACE_ASCII
REPLACE_ASCII PROC NEAR
; mov ax, 03h ; Set video mode to text mode (80x25, color)
; int 10h ; 9x16 font size
;
; mov ax, 1112h ; Force 8x8 font size for character cells
; xor bl, bl ; RAM block
; int 10h
; Change text mode character (int 10h)
; AH = 11h
; BH = Number of bytes per character
; CX = Number of characters to change
; DX = Starting character to change
; ES:BP = Offset of character data
push ds
pop es ; make sure es = ds
lea bp, CHAR_DATA ; Pointer to custom font data
mov ax, 1100h ; Load user-defined font
mov bh, 0Eh ; Number of bytes per character
xor bl,bl ; RAM block
mov cx, 01h ; Number of characters to replace = 1 for now
mov dx, 41h ; Starting character to change (41h = 'A' in ASCII)
int 10h ; Call BIOS to load the font
ret
REPLACE_ASCII ENDP
PRINT PROC NEAR
mov ax, 0B800h ; VGA text mode memory segment
mov es, ax
mov di, 0 ; Start at the top-left of the screen
mov cx, 2000 ; 80x25 screen = 2000 characters
mov al, 'A' ; ASCII code for 'A'
mov ah, 19h ; Attribute byte (blue on white)
rep stosw ; Fill screen with 'A'
ret
PRINT ENDP
ASCIIPRINT PROC NEAR
mov ax, 0B800h ; VGA text mode memory segment
mov es, ax
xor di, di ; Reset offset
mov cx, 5 ; Total number of characters (0-255)
mov ah, 4Fh ; Attribute byte (red on white)
mov dl, 10 ; Padding on the left (adjust as needed)
mov dh, 60 ; Total width of the centered line (adjust as needed)
mov di, 1620 ; Row (10 x 80 + padding) * 2, starting with left padding
PrintLoop:
stosw ; Store the character (AL) and attribute (AH)
inc al ; Move to the next ASCII character
dec dh ; Decrement width counter
jnz PrintLoop ; Continue until row width is filled
add di, 40 ; Move to the next row with padding ((80 - 60) * 2)
mov dh, 60 ; Reset row width
loop PrintLoop ; Repeat for all 256 characters
ret
ASCIIPRINT ENDP
CODE ENDS
END