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

Last change on this file since 85 was 85, checked in by aitotat, 13 years ago

Changes to Assembly Library:

  • Some minor adjustments
File size: 8.7 KB
Line 
1; File name     :   Display.inc
2; Project name  :   AssemblyLibrary
3; Created date  :   25.6.2010
4; Last update   :   7.12.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, PrepareOffScreenBufferInESBXwithLengthInCX
29        call    DisplayContext_PrepareOffScreenBufferInESBXwithLengthInCX
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    .InitializeDisplayContext                       resb    2
42
43    .SetCharacterPointerFromBXAX                    resb    2
44    .SetCharOutputFunctionFromAXwithAttribFlagInBL  resb    2
45    .SetCharacterOutputParameterFromAX              resb    2
46    .SetCharacterAttributeFromAL                    resb    2
47    .SetCursorShapeFromAX                           resb    2
48    .SetCursorCoordinatesFromAX                     resb    2
49    .SetNewPageFromAL                               resb    2
50    .SynchronizeDisplayContextToHardware            resb    2
51
52    .GetCharacterPointerToBXAX                      resb    2
53    .GetSoftwareCoordinatesToAX                     resb    2
54    .GetColumnsToALandRowsToAH                      resb    2
55
56    .FormatNullTerminatedStringFromCSSI             resb    2
57    .PrintSignedWordFromAXWithBaseInBX              resb    2
58    .PrintWordFromAXwithBaseInBX                    resb    2
59    .PrintCharBufferFromBXSIwithLengthInCX          resb    2
60    .PrintNullTerminatedStringFromBXSI              resb    2
61    .PrintNullTerminatedStringFromCSSI              resb    2
62    .PrintRepeatedCharacterFromALwithCountInCX      resb    2
63    .PrintCharacterFromAL                           resb    2
64    .PrintNewlineCharacters                         resb    2
65    .ClearAreaWithHeightInAHandWidthInAL            resb    2
66    .ClearScreenWithCharInALandAttrInAH             resb    2
67endstruc
68
69; Attribute flags for DISPLAY_LIB.SetCharacterOutputFunctionFromAXwithAttributeFlagInDL
70ATTRIBUTES_NOT_USED                         EQU     0
71ATTRIBUTES_ARE_USED                         EQU     FLG_CONTEXT_ATTRIBUTES
72
73; Character output functions for DISPLAY_LIB.SetCharacterOutputFunctionFromAXwithAttributeFlagInDL
74TELETYPE_OUTPUT_WITH_ATTRIBUTE              EQU     DisplayCharOut_TeletypeOutputWithAttribute
75TELETYPE_OUTPUT_WITHOUT_ATTRIBUTE           EQU     DisplayCharOut_TeletypeOutput
76TELETYPE_OUTPUT_USING_BIOS                  EQU     DisplayCharOut_BiosTeletypeOutput
77FAST_OUTPUT_WITH_ATTRIBUTE_ONLY             EQU     DisplayCharOut_Attribute
78FAST_OUTPUT_WITH_CHAR_ONLY                  EQU     DisplayCharOut_Character
79FAST_OUTPUT_WITH_CHAR_AND_ATTRIBUTE         EQU     DisplayCharOut_CharacterWithAttribute
80BUFFER_OUTPUT_WITH_CHAR_ONLY                EQU     DisplayCharOut_WriteCharacterToBuffer
81
82DEFAULT_CHARACTER_OUTPUT                    EQU     TELETYPE_OUTPUT_WITH_ATTRIBUTE
83
84
85struc VIDEO_BDA
86                        resb    449h
87    .bMode              resb    1       ; 0:449h, Video, Mode
88    .wColumns           resb    2       ; 0:44Ah, Video, Number of columns
89    .wBytesPerPage      resb    2       ; 0:44Ch, Video, Total number of bytes per page
90    .wPageOffset        resb    2       ; 0:44Eh, Video, Current page offset
91    .rgwCursors         resb    4       ; 0:450h, Video, Cursor position, pages 0...1
92    .displayContext     resb    12      ; Our own display context (normally cursors for pages 2...7)
93    .wCursorShape       resb    2       ; 0:460h, Video, Cursor shape
94    .bActivePage        resb    1       ; 0:462h, Video, Active display page
95    .wVideoPort         resb    2       ; 0:463h, Video, I/O Port number base
96    .bInternalModeReg   resb    1       ; 0:465h, Video, Internal mode register
97    .bColorPalette      resb    1       ; 0:466h, Video, Color palette
98endstruc
99
100struc DISPLAY_CONTEXT
101    .fpCursorPosition   resb    4   ; Far pointer to cursor position in video memory
102    .fnCharOut          resb    2   ; Function to draw character with
103    .wCharOutParam      resb    2   ; User parameter for custom character output function
104    .wCursorShape       resb    2   ; Current cursor shape
105    .bAttribute         resb    1   ; Selected character attribute
106    .bFlags             resb    1   ; Display context flags
107endstruc
108
109; Display context flags
110FLG_CONTEXT_ATTRIBUTES      EQU     (1<<0)  ; Character output function uses attributes
111FLG_CONTEXT_CGA             EQU     (1<<1)  ; CGA detected so prevent CGA snow
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_VERTICAL                             EQU     179
214SINGLE_HORIZONTAL                           EQU     196
215SINGLE_LEFT_HORIZONTAL_TO_VERTICAL          EQU     180
216SINGLE_RIGHT_HORIZONTAL_TO_VERTICAL         EQU     195
217ANGLE_QUOTE_LEFT                            EQU     174
218ANGLE_QUOTE_RIGHT                           EQU     175
219BLOCK_MOSTLY_BACKGROUND                     EQU     176
220BLOCK_EVEN_BACKGROUND_AND_FOREGROUND        EQU     177
221BLOCK_MOSTLY_FOREGROUND                     EQU     178
222BLOCK_FULL_FOREGROUND                       EQU     219
223
224
225; Background character for clearing screen
226%ifndef SCREEN_BACKGROUND_CHARACTER
227    %define SCREEN_BACKGROUND_CHARACTER     BLOCK_MOSTLY_BACKGROUND
228%endif
229%ifndef SCREEN_BACKGROUND_ATTRIBUTE
230    %define SCREEN_BACKGROUND_ATTRIBUTE     MONO_NORMAL
231%endif
232%define SCREEN_BACKGROUND_CHARACTER_AND_ATTRIBUTE   (SCREEN_BACKGROUND_CHARACTER | (SCREEN_BACKGROUND_ATTRIBUTE<<8))
233%define DOS_BACKGROUND_CHARACTER_AND_ATTRIBUTE      (' ' | (MONO_NORMAL<<8))
234
235%endif ; DISPLAY_INC
Note: See TracBrowser for help on using the repository browser.