X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=include%2Ftgi.h;h=02dff8868768b93ae7f2ec6f3a8caa22332449cf;hb=06c3cd830747c0049ada4a5a0eef2b1ad3fd29e7;hp=64db5fcbd4c307277d6e9a69f5516ac27af0139f;hpb=7fc24b058aff3a961c671de44ec7aa2c1ea28d8e;p=cc65 diff --git a/include/tgi.h b/include/tgi.h index 64db5fcbd..02dff8868 100644 --- a/include/tgi.h +++ b/include/tgi.h @@ -6,10 +6,10 @@ /* */ /* */ /* */ -/* (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 */ @@ -38,118 +38,247 @@ -#ifndef _TGI_MODE_H -#include "tgi/tgi-mode.h" -#endif #ifndef _TGI_ERROR_H -#include "tgi/tgi-error.h" +#include #endif /*****************************************************************************/ -/* Data */ +/* Definitions */ /*****************************************************************************/ -struct palettetype { - unsigned char r; /* Red component */ - unsigned char g; /* Green component */ - unsigned char b; /* Blue component */ -}; +/* 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_unload (void); -/* Unload the currently loaded driver. */ +void __fastcall__ tgi_install (void* driver); +/* Install an already loaded driver. */ -void __fastcall__ tgi_init (unsigned char mode); -/* Initialize the given graphics mode. */ +void tgi_uninstall (void); +/* Uninstall the currently loaded driver but do not unload it. Will call +** tgi_done if necessary. +*/ -void __fastcall__ tgi_done (void); -/* End graphics mode, switch back to text mode. Will NOT unload the driver! */ +void tgi_init (void); +/* Initialize the already loaded graphics driver. */ -unsigned char __fastcall__ tgi_geterror (void); +void tgi_done (void); +/* End graphics mode, switch back to text mode. Will NOT uninstall or unload +** the 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_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. +*/ + +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. +*/ -void __fastcall__ tgi_clear (void); -/* Clear the screen */ +const char* __fastcall__ tgi_geterrormsg (unsigned char code); +/* Get an error message describing the error in code. */ -unsigned char __fastcall__ tgi_getmaxcolor (void); -/* Return the maximum supported color number (the number of colors would - * then be getmaxcolor()+1). - */ +void tgi_clear (void); +/* Clear the drawpage. */ -unsigned __fastcall__ tgi_getmaxx (void); -/* Return the maximum x coordinate. The resolution in x direction is - * getmaxx() + 1 - */ +unsigned tgi_getpagecount (void); +/* Returns the number of screen pages available. */ -unsigned __fastcall__ tgi_getmaxy (void); -/* Return the maximum y coordinate. The resolution in y direction is - * getmaxy() + 1 - */ +void __fastcall__ tgi_setviewpage (unsigned char page); +/* Set the visible page. Will set an error if the page is not available. */ -unsigned __fastcall__ tgi_getxres (void); -/* Return the resolution in X direction */ +void __fastcall__ tgi_setdrawpage (unsigned char page); +/* Set the drawable page. Will set an error if the page is not available. */ -unsigned __fastcall__ tgi_getyres (void); -/* Return the resolution in Y direction */ +unsigned char tgi_getcolorcount (void); +/* Get the number of available colors. */ + +unsigned char tgi_getmaxcolor (void); +/* Return the maximum supported color number (the number of colors would +** then be getmaxcolor()+1). +*/ void __fastcall__ tgi_setcolor (unsigned char color); -/* Set the current drawing color */ +/* Set the current drawing color. */ + +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. +*/ -unsigned char __fastcall__ tgi_getcolor (void); -/* Return the current drawing color */ +const unsigned char* tgi_getpalette (void); +/* Return the current palette. */ -unsigned char __fastcall__ tgi_getbkcolor (void); -/* Return the current background color */ +const unsigned char* tgi_getdefpalette (void); +/* Return the default palette. */ + +unsigned tgi_getxres (void); +/* Return the resolution in X direction. */ + +unsigned tgi_getmaxx (void); +/* Return the maximum x coordinate. The resolution in x direction is +** getmaxx() + 1 +*/ -void __fastcall__ tgi_setbkcolor (unsigned char color); -/* Set the background color */ +unsigned tgi_getyres (void); +/* Return the resolution in Y direction. */ + +unsigned tgi_getmaxy (void); +/* Return the maximum y coordinate. The resolution in y direction is +** 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 */ +/* Get the color value of a pixel. */ void __fastcall__ tgi_setpixel (int x, int y); -/* Plot a point in the current drawing color */ +/* Plot a pixel in the current drawing color. */ + +void __fastcall__ tgi_gotoxy (int x, int y); +/* Set the graphics cursor to the given position. */ void __fastcall__ tgi_line (int x1, int y1, int x2, int y2); -/* Draw a line in the current drawing color */ +/* Draw a line in the current drawing color. The graphics cursor will +** 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. - */ +** 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_outtext (int x, int y, const char* text); -/* Print a text in graphics mode */ +/* 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 */ +/* Draw a bar (a filled rectangle) using the current color. */ + +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. +*/ + +unsigned __fastcall__ tgi_gettextheight (const char* s); +/* Calculate the height of the text in pixels according to the current text +** 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. +*/ + +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. +*/ + +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. +*/ + +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. +*/