1 ;*****************************************************************************/
5 ;* TGI kernel interface */
9 ;* (C) 2002-2009, Ullrich von Bassewitz */
10 ;* Roemerstrasse 52 */
11 ;* D-70794 Filderstadt */
12 ;* EMail: uz@cc65.org */
15 ;* This software is provided 'as-is', without any expressed or implied */
16 ;* warranty. In no event will the authors be held liable for any damages */
17 ;* arising from the use of this software. */
19 ;* Permission is granted to anyone to use this software for any purpose, */
20 ;* including commercial applications, and to alter it and redistribute it */
21 ;* freely, subject to the following restrictions: */
23 ;* 1. The origin of this software must not be misrepresented; you must not */
24 ;* claim that you wrote the original software. If you use this software */
25 ;* in a product, an acknowledgment in the product documentation would be */
26 ;* appreciated but is not required. */
27 ;* 2. Altered source versions must be plainly marked as such, and must not */
28 ;* be misrepresented as being the original software. */
29 ;* 3. This notice may not be removed or altered from any source */
32 ;*****************************************************************************/
36 ;------------------------------------------------------------------------------
40 ID .byte 3 ; Contains 0x74, 0x67, 0x69 ("tgi")
41 VERSION .byte 1 ; Interface version
43 XRES .word 1 ; X resolution
44 YRES .word 1 ; Y resolution
45 COLORCOUNT .byte 1 ; Number of available colors
46 PAGECOUNT .byte 1 ; Number of screens available
47 FONTWIDTH .byte 1 ; System font width
48 FONTHEIGHT .byte 1 ; System font height
49 ASPECTRATIO .word 1 ; Fixed point 8.8 format
52 INSTALL .addr ; INSTALL routine
53 UNINSTALL .addr ; UNINSTALL routine
54 INIT .addr ; INIT routine
55 DONE .addr ; DONE routine
56 GETERROR .addr ; GETERROR routine
57 CONTROL .addr ; CONTROL routine
58 CLEAR .addr ; CLEAR routine
59 SETVIEWPAGE .addr ; SETVIEWPAGE routine
60 SETDRAWPAGE .addr ; SETDRAWPAGE routine
61 SETCOLOR .addr ; SETCOLOR routine
62 SETPALETTE .addr ; SETPALETTE routine
63 GETPALETTE .addr ; GETPALETTE routine
64 GETDEFPALETTE .addr ; GETDEFPALETTE routine
65 SETPIXEL .addr ; SETPIXEL routine
66 GETPIXEL .addr ; GETPIXEL routine
67 LINE .addr ; LINE routine
68 BAR .addr ; BAR routine
69 TEXTSTYLE .addr ; TEXTSTYLE routine
70 OUTTEXT .addr ; OUTTEXT routine
71 IRQ .addr ; IRQ routine
75 ;------------------------------------------------------------------------------
76 ; The TGI API version, stored at TGI_HDR_VERSION
80 ;------------------------------------------------------------------------------
81 ; Color and text constants
89 TGI_TEXT_HORIZONTAL = 0
92 ;----------------------------------------------------------------------------
93 ; Results of tgi_outcode
101 ;------------------------------------------------------------------------------
102 ; C accessible Variables
104 .global _tgi_drv ; Pointer to driver
105 .global _tgi_error ; Last error code
106 .global _tgi_gmode ; Flag: graphics mode active
107 .global _tgi_curx ; Current drawing cursor X
108 .global _tgi_cury ; Current drawing cursor Y
109 .global _tgi_color ; Current drawing color
110 .global _tgi_font ; Which font to use
111 .global _tgi_textdir ; Current text direction
112 .global _tgi_vectorfont ; Pointer to vector font
113 .global _tgi_textscalew ; Text magnification for the width
114 .global _tgi_textscaleh ; Text magnification for the height
115 .global _tgi_charwidth ; Width of scaled system font char
116 .global _tgi_charheight ; Height of scaled system font char
117 .global _tgi_xres ; X resolution of the current mode
118 .global _tgi_yres ; Y resolution of the current mode
119 .global _tgi_xmax ; Maximum X coordinate
120 .global _tgi_ymax ; Maximum Y coordinate
121 .global _tgi_colorcount ; Number of available colors
122 .global _tgi_pagecount ; Number of available screen pages
123 .global _tgi_fontwidth ; System font width
124 .global _tgi_fontheight ; System font height
125 .global _tgi_aspectratio ; Aspect ratio, fixed point 8.8
127 ;------------------------------------------------------------------------------
128 ; ASM accessible Variables
130 .global tgi_clip_x1 ; Coordinate for line clipper
131 .global tgi_clip_y1 ; Coordinate for line clipper
132 .global tgi_clip_x2 ; Coordinate for line clipper
133 .global tgi_clip_y2 ; Coordinate for line clipper
135 ;------------------------------------------------------------------------------
136 ; Driver entry points
139 .global tgi_uninstall
145 .global tgi_setviewpage
146 .global tgi_setdrawpage
148 .global tgi_setpalette
149 .global tgi_getpalette
150 .global tgi_getdefpalette
155 .global tgi_textstyle
158 ;------------------------------------------------------------------------------
161 .global tgi_clippedline
164 .global tgi_imulround
173 ;------------------------------------------------------------------------------
174 ; C callable functions
182 .global _tgi_getcolor
183 .global _tgi_getcolorcount
184 .global _tgi_getdefpalette
185 .global _tgi_geterror
186 .global _tgi_geterrormsg
187 .global _tgi_getmaxcolor
190 .global _tgi_getpagecount
191 .global _tgi_getpalette
192 .global _tgi_getpixel
196 .global _tgi_imulround
199 .global _tgi_install_vectorfont
204 .global _tgi_load_driver
206 .global _tgi_outtextxy
207 .global _tgi_pieslice
208 .global _tgi_setcolor
209 .global _tgi_setdrawpage
210 .global _tgi_setpalette
211 .global _tgi_setpixel
212 .global _tgi_setviewpage
213 .global _tgi_textheight
214 .global _tgi_textscale
215 .global _tgi_textstyle
216 .global _tgi_textwidth
217 .global _tgi_uninstall