/* */
/* */
/* */
-/* (C) 2002 Ullrich von Bassewitz */
-/* Wacholderweg 14 */
-/* D-70597 Stuttgart */
-/* EMail: uz@musoftware.de */
+/* (C) 2002-2013, Ullrich von Bassewitz */
+/* Roemerstrasse 52 */
+/* D-70794 Filderstadt */
+/* EMail: uz@cc65.org */
/* */
/* */
/* This software is provided 'as-is', without any expressed or implied */
-#ifndef _TGI_MODE_H
-#include <tgi/tgi-mode.h>
-#endif
-#ifndef _TGI_ERROR_H
#include <tgi/tgi-error.h>
-#endif
+#include <target.h>
-/* Constants used for tgi_textstyle */
+/* Font constants for use with tgi_settextstyle */
+#define TGI_FONT_BITMAP 0
+#define TGI_FONT_VECTOR 1
+
+/* Direction constants for use with tgi_settextstyle */
#define TGI_TEXT_HORIZONTAL 0
#define TGI_TEXT_VERTICAL 1
+/* The name of the standard tgi driver for a platform */
+extern const char tgi_stddrv[];
+
+/* The address of the static standard tgi driver for a platform */
+extern const void tgi_static_stddrv[];
+
+/* A vector font definition */
+typedef struct tgi_vectorfont tgi_vectorfont;
+
/*****************************************************************************/
-/* Functions */
+/* Functions */
/*****************************************************************************/
-void __fastcall__ tgi_load (unsigned char mode);
-/* Install the matching driver for the given mode. Will just load the driver
- * and check if loading was successul. Will not switch to gaphics mode.
- */
-
void __fastcall__ tgi_load_driver (const char* name);
-/* Install the given driver. This function is identical to tgi_load with the
- * only difference that the name of the driver is specified explicitly. You
- * should NOT use this function in most cases, use tgi_load() instead.
- */
+/* Load and install the given driver. */
+
+void tgi_unload (void);
+/* Uninstall, then unload the currently loaded driver. Will call tgi_done if
+** necessary.
+*/
+
+void __fastcall__ tgi_install (void* driver);
+/* Install an already loaded driver. */
+
+void tgi_uninstall (void);
+/* Uninstall the currently loaded driver but do not unload it. Will call
+** tgi_done if necessary.
+*/
+
+void tgi_init (void);
+/* Initialize the already loaded graphics driver. */
-void __fastcall__ tgi_unload (void);
-/* Unload the currently loaded driver. Will call tgi_done if necessary. */
+void tgi_done (void);
+/* End graphics mode, switch back to text mode. Will NOT uninstall or unload
+** the driver!
+*/
-void __fastcall__ tgi_init (void);
-/* Initialize the already loaded graphics driver */
+const tgi_vectorfont* __fastcall__ tgi_load_vectorfont (const char* name);
+/* Load a vector font into memory and return it. In case of errors, NULL is
+** returned and an error is set, which can be retrieved using tgi_geterror.
+** To use the font, it has to be installed using tgi_install_vectorfont.
+*/
-void __fastcall__ tgi_done (void);
-/* End graphics mode, switch back to text mode. Will NOT unload the driver! */
+void __fastcall__ tgi_install_vectorfont (const tgi_vectorfont* font);
+/* Install a vector font for use. More than one vector font can be loaded,
+** but only one can be active. This function is used to tell which one. Call
+** with a NULL pointer to uninstall the currently installed font.
+*/
-unsigned char __fastcall__ tgi_geterror (void);
+void __fastcall__ tgi_free_vectorfont (const tgi_vectorfont* font);
+/* Free a vector font that was previously loaded into memory. */
+
+unsigned char tgi_geterror (void);
/* Return the error code for the last operation. This will also clear the
- * error.
- */
+** error.
+*/
+
+const char* __fastcall__ tgi_geterrormsg (unsigned char code);
+/* Get an error message describing the error in code. */
-void __fastcall__ tgi_clear (void);
-/* Clear the screen. */
+void tgi_clear (void);
+/* Clear the drawpage. */
-void __fastcall__ tgi_getpagecount (void);
+unsigned tgi_getpagecount (void);
/* Returns the number of screen pages available. */
void __fastcall__ tgi_setviewpage (unsigned char page);
void __fastcall__ tgi_setdrawpage (unsigned char page);
/* Set the drawable page. Will set an error if the page is not available. */
-unsigned char __fastcall__ tgi_getcolorcount (void);
+unsigned char tgi_getcolorcount (void);
/* Get the number of available colors. */
-unsigned char __fastcall__ tgi_getmaxcolor (void);
+unsigned char tgi_getmaxcolor (void);
/* Return the maximum supported color number (the number of colors would
- * then be getmaxcolor()+1).
- */
+** then be getmaxcolor()+1).
+*/
void __fastcall__ tgi_setcolor (unsigned char color);
/* Set the current drawing color. */
-unsigned char __fastcall__ tgi_getcolor (void);
+unsigned char tgi_getcolor (void);
/* Return the current drawing color. */
void __fastcall__ tgi_setpalette (const unsigned char* palette);
/* Set the palette (not available with all drivers/hardware). palette is
- * a pointer to as many entries as there are colors.
- */
+** a pointer to as many entries as there are colors.
+*/
-const unsigned char* __fastcall__ tgi_getpalette (void);
-/* Return the current palette. Will return NULL for drivers that do not
- * support palettes.
- */
+const unsigned char* tgi_getpalette (void);
+/* Return the current palette. */
-const unsigned char* __fastcall__ tgi_getdefpalette (void);
-/* Return the default palette. Will return NULL for drivers that do not
- * support palettes.
- */
+const unsigned char* tgi_getdefpalette (void);
+/* Return the default palette. */
-unsigned __fastcall__ tgi_getxres (void);
+unsigned tgi_getxres (void);
/* Return the resolution in X direction. */
-unsigned __fastcall__ tgi_getmaxx (void);
+unsigned tgi_getmaxx (void);
/* Return the maximum x coordinate. The resolution in x direction is
- * getmaxx() + 1
- */
+** getmaxx() + 1
+*/
-unsigned __fastcall__ tgi_getyres (void);
+unsigned tgi_getyres (void);
/* Return the resolution in Y direction. */
-unsigned __fastcall__ tgi_getmaxy (void);
+unsigned tgi_getmaxy (void);
/* Return the maximum y coordinate. The resolution in y direction is
- * getmaxy() + 1
- */
+** getmaxy() + 1
+*/
+
+unsigned tgi_getaspectratio (void);
+/* Returns the aspect ratio for the loaded driver. The aspect ratio is an
+** 8.8 fixed point value.
+*/
+
+void __fastcall__ tgi_setaspectratio (unsigned aspectratio);
+/* Set a new aspect ratio for the loaded driver. The aspect ratio is an
+** 8.8 fixed point value.
+*/
unsigned char __fastcall__ tgi_getpixel (int x, int y);
/* Get the color value of a pixel. */
void __fastcall__ tgi_line (int x1, int y1, int x2, int y2);
/* Draw a line in the current drawing color. The graphics cursor will
- * be set to x2/y2 by this call.
- */
+** be set to x2/y2 by this call.
+*/
void __fastcall__ tgi_lineto (int x2, int y2);
/* Draw a line in the current drawing color from the graphics cursor to the
- * new end point. The graphics cursor will be updated to x2/y2.
- */
+** new end point. The graphics cursor will be updated to x2/y2.
+*/
void __fastcall__ tgi_circle (int x, int y, unsigned char radius);
/* Draw a circle in the current drawing color. */
+void __fastcall__ tgi_ellipse (int x, int y, unsigned char rx, unsigned char ry);
+/* Draw a full ellipse with center at x/y and radii rx/ry using the current
+** drawing color.
+*/
+
+void __fastcall__ tgi_arc (int x, int y, unsigned char rx, unsigned char ry,
+ unsigned sa, unsigned ea);
+/* Draw an ellipse arc with center at x/y and radii rx/ry using the current
+** drawing color. The arc covers the angle between sa and ea (startangle and
+** endangle), which must be in the range 0..360 (otherwise the function may
+** bevave unextectedly).
+*/
+
+void __fastcall__ tgi_pieslice (int x, int y, unsigned char rx, unsigned char ry,
+ unsigned sa, unsigned ea);
+/* Draw an ellipse pie slice with center at x/y and radii rx/ry using the
+** current drawing color. The pie slice covers the angle between sa and ea
+** (startangle and endangle), which must be in the range 0..360 (otherwise the
+** function may behave unextectedly).
+*/
+
void __fastcall__ tgi_bar (int x1, int y1, int x2, int y2);
/* Draw a bar (a filled rectangle) using the current color. */
-void __fastcall__ tgi_textstyle (unsigned char magx, unsigned char magy,
- unsigned char dir);
-/* Set the style for text output. */
-
-unsigned __fastcall__ tgi_textwidth (const char* s);
+void __fastcall__ tgi_settextdir (unsigned char dir);
+/* Set the direction for text output. dir is one of the TGI_TEXT_XXX
+** constants.
+*/
+
+void __fastcall__ tgi_settextscale (unsigned width, unsigned height);
+/* Set the scaling for text output. The scaling factors for width and height
+** are 8.8 fixed point values. This means that $100 = 1 $200 = 2 etc.
+*/
+
+void __fastcall__ tgi_settextstyle (unsigned width, unsigned height,
+ unsigned char dir, unsigned char font);
+/* Set the style for text output. The scaling factors for width and height
+** are 8.8 fixed point values. This means that $100 = 1 $200 = 2 etc.
+** dir is one of the TGI_TEXT_XXX constants. font is one of the TGI_FONT_XXX
+** constants.
+*/
+
+unsigned __fastcall__ tgi_gettextwidth (const char* s);
/* Calculate the width of the text in pixels according to the current text
- * style.
- */
+** style.
+*/
-unsigned __fastcall__ tgi_textheight (const char* s);
+unsigned __fastcall__ tgi_gettextheight (const char* s);
/* Calculate the height of the text in pixels according to the current text
- * style.
- */
+** style.
+*/
void __fastcall__ tgi_outtext (const char* s);
/* Output text at the current graphics cursor position. The graphics cursor
- * is moved to the end of the text.
- */
+** is moved to the end of the text.
+*/
void __fastcall__ tgi_outtextxy (int x, int y, const char* s);
/* Output text at the given cursor position. The graphics cursor is moved to
- * the end of the text.
- */
+** the end of the text.
+*/
+unsigned __fastcall__ tgi_ioctl (unsigned char code, void* data);
+/* Call the driver specific control function. What this function does for
+** a specific code depends on the driver. The driver will set an error
+** for unknown codes or values.
+*/
-
-/* End of tgi.h */
-#endif
+int __fastcall__ tgi_imulround (int rhs, int lhs);
+/* Helper function for functions using sine/cosine: Multiply two values, one
+** being an 8.8 fixed point one, and return the rounded and scaled result.
+*/
+/* End of tgi.h */
+#endif
projects / cc65 / blobdiff