source: xtideuniversalbios/trunk/Assembly_Library/Inc/Display.inc@ 48

Last change on this file since 48 was 48, checked in by Tomi Tilli, 14 years ago

Changes to Assembly Library:
Added functions to clear Menu Title and Information areas.
Implemented automatic line change when writing Menu Title and Information areas.
CGA snow related functions have been moved to CgaSnow.asm.
Keyboard input functions no longer produce beep for backspace.
File size: 8.4 KB
Line 
1; File name : Display.inc
2; Project name : AssemblyLibrary
3; Created date : 25.6.2010
4; Last update : 6.10.2010
5; Author : Tomi Tilli
6; Description : Defines for display library.
7%ifndef DISPLAY_INC
8%define DISPLAY_INC
9
10;--------------------------------------------------------------------
11; Display Library users need to use this macro since it will provide
12; compatibility with future library versions.
13;
14; CALL_DISPLAY_LIBRARY
15; Parameters:
16; %1: Function to call (functionName from DISPLAY_LIB)
17; Registers: Depends on function to call
18; Returns:
19; Depends on function to call
20; Corrupts registers:
21; AX (unless used as a return register), DI
22;--------------------------------------------------------------------
23%macro CALL_DISPLAY_LIBRARY 1
24 %ifidn %1, PushDisplayContext
25 call DisplayContext_Push
26 %elifidn %1, PopDisplayContext
27 call DisplayContext_Pop
28 %elifidn %1, PrepareOffScreenBufferInESBXtoESDI
29 call DisplayContext_PrepareOffScreenBufferInESBXtoESDI
30 %else
31 mov di, DISPLAY_LIB.%1
32 call Display_FunctionFromDI
33 %endif
34%endmacro
35
36
37; Display library functions
38struc DISPLAY_LIB
39 .PushDisplayContext:
40 .PopDisplayContext:
41 .PrepareOffScreenBufferInESBXtoESDI:
42 .InitializeDisplayContext resb 2
43
44 .SetCharacterPointerFromBXAX resb 2
45 .SetCharOutputFunctionFromAXwithAttribFlagInBL resb 2
46 .SetCharacterOutputParameterFromAX resb 2
47 .SetCharacterAttributeFromAL resb 2
48 .SetCursorShapeFromAX resb 2
49 .SetCursorCoordinatesFromAX resb 2
50 .SetNewPageFromAL resb 2
51 .SynchronizeDisplayContextToHardware resb 2
52
53 .GetCharacterPointerToBXAX resb 2
54 .GetSoftwareCoordinatesToAX resb 2
55 .GetColumnsToALandRowsToAH resb 2
56
57 .FormatNullTerminatedStringFromCSSI resb 2
58 .PrintSignedWordFromAXWithBaseInBX resb 2
59 .PrintWordFromAXwithBaseInBX resb 2
60 .PrintCharBufferFromBXSIwithLengthInCX resb 2
61 .PrintNullTerminatedStringFromBXSI resb 2
62 .PrintNullTerminatedStringFromCSSI resb 2
63 .PrintRepeatedCharacterFromALwithCountInCX resb 2
64 .PrintCharacterFromAL resb 2
65 .PrintNewlineCharacters resb 2
66 .ClearAreaWithHeightInAHandWidthInAL resb 2
67 .ClearScreen resb 2
68endstruc
69
70; Attribute flags for DISPLAY_LIB.SetCharacterOutputFunctionFromAXwithAttributeFlagInDL
71ATTRIBUTES_NOT_USED EQU 0
72ATTRIBUTES_ARE_USED EQU FLG_CONTEXT_ATTRIBUTES
73
74; Character output functions for DISPLAY_LIB.SetCharacterOutputFunctionFromAXwithAttributeFlagInDL
75TELETYPE_OUTPUT_WITH_ATTRIBUTE EQU DisplayCharOut_TeletypeOutputWithAttribute
76TELETYPE_OUTPUT_WITHOUT_ATTRIBUTE EQU DisplayCharOut_TeletypeOutput
77TELETYPE_OUTPUT_USING_BIOS EQU DisplayCharOut_BiosTeletypeOutput
78FAST_OUTPUT_WITH_ATTRIBUTE_ONLY EQU DisplayCharOut_Attribute
79FAST_OUTPUT_WITH_CHAR_ONLY EQU DisplayCharOut_Character
80FAST_OUTPUT_WITH_CHAR_AND_ATTRIBUTE EQU DisplayCharOut_CharacterWithAttribute
81BUFFER_OUTPUT_WITH_CHAR_ONLY EQU DisplayCharOut_WriteCharacterToBuffer
82
83DEFAULT_CHARACTER_OUTPUT EQU TELETYPE_OUTPUT_WITH_ATTRIBUTE
84
85
86struc VIDEO_BDA
87 resb 449h
88 .bMode resb 1 ; 0:449h, Video, Mode
89 .wColumns resb 2 ; 0:44Ah, Video, Number of columns
90 .wBytesPerPage resb 2 ; 0:44Ch, Video, Total number of bytes per page
91 .wPageOffset resb 2 ; 0:44Eh, Video, Current page offset
92 .rgwCursors resb 4 ; 0:450h, Video, Cursor position, pages 0...1
93 .displayContext resb 12 ; Our own display context (normally cursors for pages 2...7)
94 .wCursorShape resb 2 ; 0:460h, Video, Cursor shape
95 .bActivePage resb 1 ; 0:462h, Video, Active display page
96 .wVideoPort resb 2 ; 0:463h, Video, I/O Port number base
97 .bInternalModeReg resb 1 ; 0:465h, Video, Internal mode register
98 .bColorPalette resb 1 ; 0:466h, Video, Color palette
99endstruc
100
101struc DISPLAY_CONTEXT
102 .fpCursorPosition resb 4 ; Far pointer to cursor position in video memory
103 .fnCharOut resb 2 ; Function to draw character with
104 .wCharOutParam resb 2 ; User parameter for custom character output function
105 .wCursorShape resb 2 ; Current cursor shape
106 .bAttribute resb 1 ; Selected character attribute
107 .bFlags resb 1 ; Display context flags
108endstruc
109
110; Display context flags
111FLG_CONTEXT_ATTRIBUTES EQU (1<<0) ; Character output function uses attributes
112
113
114; Text mode character attribute byte bits for CGA+ (color adapters)
115FLG_COLOR_FORE_BLUE EQU (1<<0)
116FLG_COLOR_FORE_GREEN EQU (1<<1)
117FLG_COLOR_FORE_RED EQU (1<<2)
118FLG_COLOR_FORE_INTENSITY EQU (1<<3)
119FLG_COLOR_FORE_FONT_B EQU (1<<3) ; Select font set B (if available, EGA+)
120FLG_COLOR_BACK_BLUE EQU (1<<4)
121FLG_COLOR_BACK_GREEN EQU (1<<5)
122FLG_COLOR_BACK_RED EQU (1<<6)
123FLG_COLOR_BACK_INTENSITY EQU (1<<7) ; Intensity when blinking is disabled
124FLG_COLOR_BLINK EQU (1<<7) ; Blinking color when enabled (enabled by default)
125
126; CGA colors
127%define COLOR_ATTRIBUTE(foreground, background) ( (foreground) | ((background)<<4) )
128COLOR_BLACK EQU 0
129COLOR_BLUE EQU 1
130COLOR_GREEN EQU 2
131COLOR_CYAN EQU 3
132COLOR_RED EQU 4
133COLOR_MAGENTA EQU 5
134COLOR_BROWN EQU 6
135COLOR_WHITE EQU 7 ; Last background color if blinking enabled
136COLOR_GRAY EQU 8
137COLOR_LIGHT_BLUE EQU 9
138COLOR_LIGHT_GREEN EQU 10
139COLOR_LIGHT_CYAN EQU 11
140COLOR_LIGHT_RED EQU 12
141COLOR_LIGHT_MAGENTA EQU 13
142COLOR_YELLOW EQU 14
143COLOR_BRIGHT_WHITE EQU 15
144
145
146; Text mode character attribute byte bits for MDA (monochrome adapters)
147; (attributes 00h, 08h, 80h, 88h, 70h, 78h, F0h and F8h are exceptions)
148FLG_MONO_UNDERLINE EQU (1<<1)
149FLG_MONO_INTENSITY EQU (1<<3)
150FLG_MONO_BLINK EQU (1<<7)
151
152; Text mode character attribute bytes for MDA/Hercules (monochrome adapters)
153; *Not displayed on some monitors
154MONO_HIDDEN EQU 00h ; Not displayed (same for 08h, 80h and 88h)
155MONO_UNDERLINE EQU 01h ; Underlined
156MONO_NORMAL EQU 07h ; Normal (white on black)
157MONO_BRIGHT_UNDERLINE EQU 09h ; High intensity, underlined
158MONO_BRIGHT EQU 0Fh ; High intensity
159MONO_REVERSE EQU 70h ; Reverse video (black on white)
160MONO_REVERSE_DARK EQU 78h ; (dark green on green)
161MONO_BLINK EQU 87h ; Blinking white on black*
162MONO_BRIGHT_BLINK EQU 8Fh ; Blinking high intensity*
163MONO_REVERSE_BLINK EQU 0F0h ; Blinking reverse video
164MONO_REVERSE_DARK_BLINK EQU 0F8h ; (blinking dark green on green)
165
166
167; Cursor position macro for DX register
168%define CURSOR_XY(x, y) ( (x) | ((y)<<8) )
169
170; Cursor shapes
171CURSOR_NORMAL EQU 0607h ; Two line cursor near or at the bottom of cell
172CURSOR_HIDDEN EQU 2000h
173
174
175; Display modes
176CGA_TEXT_MODE_BW40 EQU 0 ; Applications should use...
177CGA_TEXT_MODE_CO40 EQU 1
178CGA_TEXT_MODE_BW80 EQU 2 ; ..black, white and bright white attributes only
179CGA_TEXT_MODE_CO80 EQU 3
180MDA_TEXT_MODE EQU 7 ; Real monochrome attributes available
181
182
183; Display segments
184COLOR_TEXT_SEGMENT EQU 0B800h ; Text modes 0...3 (CGA+)
185MONO_TEXT_SEGMENT EQU 0B000h ; Text mode 7 (MDA, Hercules)
186
187OFFSET_TO_CGA_STATUS_REGISTER EQU 6 ; Base port 3D4h + 6 = 3DAh
188CGA_STATUS_REGISTER EQU 3DAh
189
190
191; Control characters for teletype output
192NULL EQU 00h
193SOH EQU 01h ; Start of heading
194STX EQU 02h ; Start of text
195BELL EQU 07h ; Bell
196BS EQU 08h ; Backspace
197TAB EQU 09h ; Horizontal TAB
198LF EQU 0Ah ; Line feed (newline)
199CR EQU 0Dh ; Carriage return
200ESC EQU 1Bh ; Escape
201
202; Non ASCII characters (code page 437)
203DOUBLE_TOP_RIGHT_CORNER EQU 187
204DOUBLE_TOP_LEFT_CORNER EQU 201
205DOUBLE_BOTTOM_RIGHT_CORNER EQU 188
206DOUBLE_BOTTOM_LEFT_CORNER EQU 200
207DOUBLE_VERTICAL EQU 186
208DOUBLE_HORIZONTAL EQU 205
209DOUBLE_VERTICAL_TO_RIGHT_SINGLE EQU 199
210DOUBLE_VERTICAL_TO_LEFT_SINGLE EQU 182
211DOUBLE_LEFT_HORIZONTAL_TO_SINGLE_VERTICAL EQU 181
212DOUBLE_RIGHT_HORIZONTAL_TO_SINGLE_VERTICAL EQU 198
213SINGLE_HORIZONTAL EQU 196
214SINGLE_LEFT_HORIZONTAL_TO_VERTICAL EQU 180
215SINGLE_RIGHT_HORIZONTAL_TO_VERTICAL EQU 195
216ANGLE_QUOTE_LEFT EQU 174
217ANGLE_QUOTE_RIGHT EQU 175
218BLOCK_MOSTLY_BACKGROUND EQU 176
219BLOCK_EVEN_BACKGROUND_AND_FOREGROUND EQU 177
220BLOCK_MOSTLY_FOREGROUND EQU 178
221BLOCK_FULL_FOREGROUND EQU 219
222
223
224; Background character for clearing screen
225%ifndef SCREEN_BACKGROUND_CHARACTER
226 %define SCREEN_BACKGROUND_CHARACTER BLOCK_MOSTLY_BACKGROUND
227%endif
228%ifndef SCREEN_BACKGROUND_ATTRIBUTE
229 %define SCREEN_BACKGROUND_ATTRIBUTE MONO_NORMAL
230%endif
231
232%endif ; DISPLAY_INC
Note: See TracBrowser for help on using the repository browser.