source: xtideuniversalbios/trunk/Assembly_Library/Src/Display/DisplayContext.asm @ 489

Last change on this file since 489 was 489, checked in by gregli@…, 11 years ago

Added version string to initial title banner, for cases where there is not a boot menu (just hotkeys, or no hotkeys). Also ifdef'd out some unused code.

File size: 10.6 KB
Line 
1; Project name  :   Assembly Library
2; Description   :   Functions for managing display context.
3
4;
5; XTIDE Universal BIOS and Associated Tools 
6; Copyright (C) 2009-2010 by Tomi Tilli, 2011-2012 by XTIDE Universal BIOS Team.
7;
8; This program is free software; you can redistribute it and/or modify
9; it under the terms of the GNU General Public License as published by
10; the Free Software Foundation; either version 2 of the License, or
11; (at your option) any later version.
12; 
13; This program is distributed in the hope that it will be useful,
14; but WITHOUT ANY WARRANTY; without even the implied warranty of
15; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16; GNU General Public License for more details.     
17; Visit http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
18;       
19
20; Section containing code
21SECTION .text
22
23;--------------------------------------------------------------------
24; DisplayContext_Initialize
25;   Parameters:
26;       DS:     BDA segment (zero)
27;   Returns:
28;       Nothing
29;   Corrupts registers:
30;       AX, DX, DI
31;--------------------------------------------------------------------
32ALIGN DISPLAY_JUMP_ALIGN
33DisplayContext_Initialize:
34    mov     WORD [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fnCharOut], DEFAULT_CHARACTER_OUTPUT
35    mov     BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bAttribute], SCREEN_BACKGROUND_ATTRIBUTE
36    call    DisplayCursor_GetDefaultCursorShapeToAX
37    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCursorShape], ax
38    ; Fall to .DetectAndSetDisplaySegment
39
40;--------------------------------------------------------------------
41; .DetectAndSetDisplaySegment
42;   Parameters:
43;       DS:     BDA segment (zero)
44;   Returns:
45;       Nothing
46;   Corrupts registers:
47;       AX, DX
48;--------------------------------------------------------------------
49.DetectAndSetDisplaySegment:
50    mov     ax, COLOR_TEXT_SEGMENT
51    cmp     BYTE [VIDEO_BDA.bMode], MDA_TEXT_MODE
52    eCMOVE  ah, MONO_TEXT_SEGMENT >> 8
53    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition+2], ax
54    ; Fall to .InitializeFlags
55
56;--------------------------------------------------------------------
57; .InitializeFlags
58;   Parameters:
59;       DS:     BDA segment (zero)
60;   Returns:
61;       Nothing
62;   Corrupts registers:
63;       AX, DX
64;--------------------------------------------------------------------
65.InitializeFlags:
66    mov     dl, FLG_CONTEXT_ATTRIBUTES
67    call    CgaSnow_IsCgaPresent
68    jnc     SHORT .DoNotSetCgaFlag
69    or      dl, FLG_CONTEXT_CGA
70.DoNotSetCgaFlag:
71    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], dl
72    ; Fall to .InitializeCursor
73
74;--------------------------------------------------------------------
75; .InitializeCursor
76;   Parameters:
77;       DS:     BDA segment (zero)
78;   Returns:
79;       Nothing
80;   Corrupts registers:
81;       AX, DX
82;--------------------------------------------------------------------
83.InitializeCursor:
84    call    DisplayCursor_GetHardwareCoordinatesToAX    ; Coordinates before init
85    call    DisplayCursor_SetCoordinatesFromAX          ; Cursor to Display Context
86    ; Fall to DisplayContext_SynchronizeToHardware
87
88;--------------------------------------------------------------------
89; DisplayContext_SynchronizeToHardware
90;   Parameters:
91;       DS:     BDA segment (zero)
92;   Returns:
93;       Nothing
94;   Corrupts registers:
95;       AX, DX
96;--------------------------------------------------------------------
97ALIGN DISPLAY_JUMP_ALIGN
98DisplayContext_SynchronizeToHardware:
99    call    DisplayPage_SynchronizeToHardware
100    call    DisplayCursor_SynchronizeShapeToHardware
101    jmp     DisplayCursor_SynchronizeCoordinatesToHardware
102
103
104%ifdef INCLUDE_MENU_LIBRARY
105
106;--------------------------------------------------------------------
107; DisplayContext_Push
108;   Parameters:
109;       Nothing
110;   Returns:
111;       Nothing
112;   Corrupts registers:
113;       AX, DI
114;--------------------------------------------------------------------
115ALIGN DISPLAY_JUMP_ALIGN
116DisplayContext_Push:
117    mov     di, ds                  ; Backup DS
118    LOAD_BDA_SEGMENT_TO ds, ax
119    pop     ax                      ; Pop return address
120
121%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS
122    %assign i 0
123    %rep DISPLAY_CONTEXT_size / 2
124        push    WORD [VIDEO_BDA.displayContext + i]
125    %assign i i+2
126    %endrep
127%endif
128       
129    mov     ds, di                  ; Restore DS
130    jmp     ax
131
132;--------------------------------------------------------------------
133; DisplayContext_Pop
134;   Parameters:
135;       Nothing
136;   Returns:
137;       Nothing
138;   Corrupts registers:
139;       AX, DI
140;--------------------------------------------------------------------
141ALIGN DISPLAY_JUMP_ALIGN
142DisplayContext_Pop:
143    mov     di, ds                  ; Backup DS
144    LOAD_BDA_SEGMENT_TO ds, ax
145    pop     ax                      ; Pop return address
146
147%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS       
148    %assign i DISPLAY_CONTEXT_size-2
149    %rep DISPLAY_CONTEXT_size / 2
150        pop     WORD [VIDEO_BDA.displayContext + i]
151    %assign i i-2
152    %endrep
153%endif
154       
155    push    ax                      ; Push return address
156    push    dx
157    call    DisplayContext_SynchronizeToHardware
158    pop     dx
159    mov     ds, di                  ; Restore DS
160    ret
161%endif
162
163;--------------------------------------------------------------------
164; DisplayContext_PrepareOffScreenBufferInESBXwithLengthInCX
165;   Parameters:
166;       CX:     Off screen buffer length in characters
167;       ES:BX:  Ptr to off screen buffer
168;   Returns:
169;       Nothing
170;   Corrupts registers:
171;       AX, DI
172;--------------------------------------------------------------------
173%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
174ALIGN DISPLAY_JUMP_ALIGN
175DisplayContext_PrepareOffScreenBufferInESBXwithLengthInCX:
176    push    ds
177
178    LOAD_BDA_SEGMENT_TO ds, di
179    xchg    ax, bx
180    mov     bx, es
181    call    DisplayContext_SetCharacterPointerFromBXAX  ; ES:DI now has the pointer
182
183    mov     bl, ATTRIBUTES_NOT_USED
184    mov     ax, BUFFER_OUTPUT_WITH_CHAR_ONLY
185    call    DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL
186    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam], cx
187
188    mov     bx, di
189    pop     ds
190    ret
191
192%endif  ; INCLUDE_MENU_LIBRARY
193
194
195;--------------------------------------------------------------------
196; DisplayContext_SetCharacterPointerFromBXAX
197;   Parameters:
198;       BX:AX:  Ptr to destination for next character to output
199;       DS:     BDA segment (zero)
200;   Returns:
201;       ES:DI:  Pointer that was in BX:AX
202;   Corrupts registers:
203;       AX
204;--------------------------------------------------------------------
205%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
206ALIGN DISPLAY_JUMP_ALIGN
207DisplayContext_SetCharacterPointerFromBXAX:
208    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition], ax
209    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition+2], bx
210    xchg    di, ax
211    mov     es, bx
212    ret
213%endif
214
215
216;--------------------------------------------------------------------
217; DisplayContext_GetCharacterPointerToBXAX
218;   Parameters:
219;       DS:     BDA segment (zero)
220;   Returns:
221;       BX:AX:  Ptr to destination for next character to output
222;   Corrupts registers:
223;       Nothing
224;--------------------------------------------------------------------
225%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
226ALIGN DISPLAY_JUMP_ALIGN
227DisplayContext_GetCharacterPointerToBXAX:
228    mov     ax, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition]
229    mov     bx, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition+2]
230    ret
231%endif
232
233%ifdef INCLUDE_MENU_LIBRARY
234
235;--------------------------------------------------------------------
236; DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL
237;   Parameters:
238;       AX:     Offset to character output function
239;       BL:     Attribute Flag
240;       DS:     BDA segment (zero)
241;   Returns:
242;       Nothing
243;   Corrupts registers:
244;       BL
245;--------------------------------------------------------------------
246ALIGN DISPLAY_JUMP_ALIGN
247DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL:
248    and     bl, FLG_CONTEXT_ATTRIBUTES
249    and     BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], ~FLG_CONTEXT_ATTRIBUTES
250    or      [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], bl
251    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fnCharOut], ax
252    ret
253
254
255;--------------------------------------------------------------------
256; DisplayContext_SetCharacterAttributeFromAL
257;   Parameters:
258;       AL:     Character attribute
259;       DS:     BDA segment (zero)
260;   Returns:
261;       Nothing
262;   Corrupts registers:
263;       Nothing
264;--------------------------------------------------------------------
265ALIGN DISPLAY_JUMP_ALIGN
266DisplayContext_SetCharacterAttributeFromAL:
267    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bAttribute], al
268    ret
269
270
271;--------------------------------------------------------------------
272; DisplayContext_SetCharacterOutputParameterFromAX
273;   Parameters:
274;       AX:     Parameter for Character Output function
275;       DS:     BDA segment (zero)
276;   Returns:
277;       Nothing
278;   Corrupts registers:
279;       Nothing
280;--------------------------------------------------------------------
281ALIGN DISPLAY_JUMP_ALIGN
282DisplayContext_SetCharacterOutputParameterFromAX:
283    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam], ax
284    ret
285       
286%endif   ; INCLUDE_MENU_LIBRARY
287       
288;--------------------------------------------------------------------
289; DisplayContext_GetCharacterOutputParameterToDX
290;   Parameters:
291;       DS:     BDA segment (zero)
292;   Returns:
293;       DX:     User parameter for Character Output function
294;   Corrupts registers:
295;       Nothing
296;--------------------------------------------------------------------
297%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS OR EXCLUDE_FROM_XTIDECFG  ; This is currently unused (dead code)
298ALIGN DISPLAY_JUMP_ALIGN
299DisplayContext_GetCharacterOutputParameterToDX:
300    mov     dx, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam]
301    ret
302%endif
303
304
305;--------------------------------------------------------------------
306; DisplayContext_GetCharacterOffsetToAXfromByteOffsetInAX
307;   Parameters:
308;       AX:     Offset in bytes from some character to another
309;       DS:     BDA segment (zero)
310;   Returns:
311;       AX:     Offset in characters from some character to another
312;   Corrupts registers:
313;       Nothing
314;--------------------------------------------------------------------
315%ifndef MODULE_STRINGS_COMPRESSED
316ALIGN DISPLAY_JUMP_ALIGN
317DisplayContext_GetCharacterOffsetToAXfromByteOffsetInAX:
318    test    BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], FLG_CONTEXT_ATTRIBUTES
319    jz      SHORT ReturnOffsetInAX
320    sar     ax, 1       ; BYTE count to WORD count
321    ret
322%endif
323
324       
325;--------------------------------------------------------------------
326; DisplayContext_GetByteOffsetToAXfromCharacterOffsetInAX
327;   Parameters:
328;       AX:     Offset in characters from some character to another
329;       DS:     BDA segment (zero)
330;   Returns:
331;       AX:     Offset in bytes from some character to another
332;   Corrupts registers:
333;       Nothing
334;--------------------------------------------------------------------
335%ifndef MODULE_STRINGS_COMPRESSED
336ALIGN DISPLAY_JUMP_ALIGN
337DisplayContext_GetByteOffsetToAXfromCharacterOffsetInAX:
338    test    BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], FLG_CONTEXT_ATTRIBUTES
339    jz      SHORT ReturnOffsetInAX
340    sal     ax, 1       ; WORD count to BYTE count
341ALIGN DISPLAY_JUMP_ALIGN, ret
342ReturnOffsetInAX:
343    ret
344%endif
Note: See TracBrowser for help on using the repository browser.