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

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

WIDE checkin... Added copyright and license information to sorce files, as per the GPL instructions for usage.
File size: 10.5 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    mov     ax, [VIDEO_BDA.wCursorShape]
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;--------------------------------------------------------------------
105; DisplayContext_Push
106;   Parameters:
107;       Nothing
108;   Returns:
109;       Nothing
110;   Corrupts registers:
111;       AX, DI
112;--------------------------------------------------------------------
113ALIGN DISPLAY_JUMP_ALIGN
114DisplayContext_Push:
115    mov     di, ds                  ; Backup DS
116    LOAD_BDA_SEGMENT_TO ds, ax
117    pop     ax                      ; Pop return address
118
119%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS
120    %assign i 0
121    %rep DISPLAY_CONTEXT_size / 2
122        push    WORD [VIDEO_BDA.displayContext + i]
123    %assign i i+2
124    %endrep
125%endif
126       
127    mov     ds, di                  ; Restore DS
128    jmp     ax
129
130;--------------------------------------------------------------------
131; DisplayContext_Pop
132;   Parameters:
133;       Nothing
134;   Returns:
135;       Nothing
136;   Corrupts registers:
137;       AX, DI
138;--------------------------------------------------------------------
139ALIGN DISPLAY_JUMP_ALIGN
140DisplayContext_Pop:
141    mov     di, ds                  ; Backup DS
142    LOAD_BDA_SEGMENT_TO ds, ax
143    pop     ax                      ; Pop return address
144
145%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS       
146    %assign i DISPLAY_CONTEXT_size-2
147    %rep DISPLAY_CONTEXT_size / 2
148        pop     WORD [VIDEO_BDA.displayContext + i]
149    %assign i i-2
150    %endrep
151%endif
152       
153    push    ax                      ; Push return address
154    push    dx
155    call    DisplayContext_SynchronizeToHardware
156    pop     dx
157    mov     ds, di                  ; Restore DS
158    ret
159
160
161;--------------------------------------------------------------------
162; DisplayContext_PrepareOffScreenBufferInESBXwithLengthInCX
163;   Parameters:
164;       CX:     Off screen buffer length in characters
165;       ES:BX:  Ptr to off screen buffer
166;   Returns:
167;       Nothing
168;   Corrupts registers:
169;       AX, DI
170;--------------------------------------------------------------------
171%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
172ALIGN DISPLAY_JUMP_ALIGN
173DisplayContext_PrepareOffScreenBufferInESBXwithLengthInCX:
174    push    ds
175
176    LOAD_BDA_SEGMENT_TO ds, di
177    xchg    ax, bx
178    mov     bx, es
179    call    DisplayContext_SetCharacterPointerFromBXAX  ; ES:DI now has the pointer
180
181    mov     bl, ATTRIBUTES_NOT_USED
182    mov     ax, BUFFER_OUTPUT_WITH_CHAR_ONLY
183    call    DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL
184    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam], cx
185
186    mov     bx, di
187    pop     ds
188    ret
189%endif
190
191
192;--------------------------------------------------------------------
193; DisplayContext_SetCharacterPointerFromBXAX
194;   Parameters:
195;       BX:AX:  Ptr to destination for next character to output
196;       DS:     BDA segment (zero)
197;   Returns:
198;       ES:DI:  Pointer that was in BX:AX
199;   Corrupts registers:
200;       AX
201;--------------------------------------------------------------------
202%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
203ALIGN DISPLAY_JUMP_ALIGN
204DisplayContext_SetCharacterPointerFromBXAX:
205    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition], ax
206    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition+2], bx
207    xchg    di, ax
208    mov     es, bx
209    ret
210%endif
211
212
213;--------------------------------------------------------------------
214; DisplayContext_GetCharacterPointerToBXAX
215;   Parameters:
216;       DS:     BDA segment (zero)
217;   Returns:
218;       BX:AX:  Ptr to destination for next character to output
219;   Corrupts registers:
220;       Nothing
221;--------------------------------------------------------------------
222%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS
223ALIGN DISPLAY_JUMP_ALIGN
224DisplayContext_GetCharacterPointerToBXAX:
225    mov     ax, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition]
226    mov     bx, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fpCursorPosition+2]
227    ret
228%endif
229
230
231;--------------------------------------------------------------------
232; DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL
233;   Parameters:
234;       AX:     Offset to character output function
235;       BL:     Attribute Flag
236;       DS:     BDA segment (zero)
237;   Returns:
238;       Nothing
239;   Corrupts registers:
240;       BL
241;--------------------------------------------------------------------
242ALIGN DISPLAY_JUMP_ALIGN
243DisplayContext_SetCharOutputFunctionFromAXwithAttribFlagInBL:
244    and     bl, FLG_CONTEXT_ATTRIBUTES
245    and     BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], ~FLG_CONTEXT_ATTRIBUTES
246    or      [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], bl
247    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.fnCharOut], ax
248    ret
249       
250
251;--------------------------------------------------------------------
252; DisplayContext_SetCharacterAttributeFromAL
253;   Parameters:
254;       AL:     Character attribute
255;       DS:     BDA segment (zero)
256;   Returns:
257;       Nothing
258;   Corrupts registers:
259;       Nothing
260;--------------------------------------------------------------------
261ALIGN DISPLAY_JUMP_ALIGN
262DisplayContext_SetCharacterAttributeFromAL:
263    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bAttribute], al
264    ret
265
266
267;--------------------------------------------------------------------
268; DisplayContext_SetCharacterOutputParameterFromAX
269;   Parameters:
270;       AX:     Parameter for Character Output function
271;       DS:     BDA segment (zero)
272;   Returns:
273;       Nothing
274;   Corrupts registers:
275;       Nothing
276;--------------------------------------------------------------------
277ALIGN DISPLAY_JUMP_ALIGN
278DisplayContext_SetCharacterOutputParameterFromAX:
279    mov     [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam], ax
280    ret
281
282       
283;--------------------------------------------------------------------
284; DisplayContext_GetCharacterOutputParameterToDX
285;   Parameters:
286;       DS:     BDA segment (zero)
287;   Returns:
288;       DX:     User parameter for Character Output function
289;   Corrupts registers:
290;       Nothing
291;--------------------------------------------------------------------
292%ifndef EXCLUDE_FROM_XTIDE_UNIVERSAL_BIOS OR EXCLUDE_FROM_XTIDECFG  ; This is currently unused (dead code)
293ALIGN DISPLAY_JUMP_ALIGN
294DisplayContext_GetCharacterOutputParameterToDX:
295    mov     dx, [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.wCharOutParam]
296    ret
297%endif
298
299
300;--------------------------------------------------------------------
301; DisplayContext_GetCharacterOffsetToAXfromByteOffsetInAX
302;   Parameters:
303;       AX:     Offset in bytes from some character to another
304;       DS:     BDA segment (zero)
305;   Returns:
306;       AX:     Offset in characters from some character to another
307;   Corrupts registers:
308;       Nothing
309;--------------------------------------------------------------------
310%ifndef MODULE_STRINGS_COMPRESSED
311ALIGN DISPLAY_JUMP_ALIGN
312DisplayContext_GetCharacterOffsetToAXfromByteOffsetInAX:
313    test    BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], FLG_CONTEXT_ATTRIBUTES
314    jz      SHORT ReturnOffsetInAX
315    sar     ax, 1       ; BYTE count to WORD count
316    ret
317%endif
318
319       
320;--------------------------------------------------------------------
321; DisplayContext_GetByteOffsetToAXfromCharacterOffsetInAX
322;   Parameters:
323;       AX:     Offset in characters from some character to another
324;       DS:     BDA segment (zero)
325;   Returns:
326;       AX:     Offset in bytes from some character to another
327;   Corrupts registers:
328;       Nothing
329;--------------------------------------------------------------------
330%ifndef MODULE_STRINGS_COMPRESSED
331ALIGN DISPLAY_JUMP_ALIGN
332DisplayContext_GetByteOffsetToAXfromCharacterOffsetInAX:
333    test    BYTE [VIDEO_BDA.displayContext+DISPLAY_CONTEXT.bFlags], FLG_CONTEXT_ATTRIBUTES
334    jz      SHORT ReturnOffsetInAX
335    sal     ax, 1       ; WORD count to BYTE count
336ALIGN DISPLAY_JUMP_ALIGN, ret
337ReturnOffsetInAX:
338    ret
339%endif
Note: See TracBrowser for help on using the repository browser.