X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=include%2Ftgi.h;h=f458180c51a8c62f91b938e958bf7ea9c3de01cc;hb=HEAD;hp=51d0eaebc6b8c20e953fa48cee30042335341fea;hpb=435fd06bc6195eef7d6e389daeca53b1dacae6c3;p=cc65 diff --git a/include/tgi.h b/include/tgi.h index 51d0eaebc..f458180c5 100644 --- a/include/tgi.h +++ b/include/tgi.h @@ -38,9 +38,8 @@ -#ifndef _TGI_ERROR_H #include -#endif +#include @@ -80,44 +79,44 @@ void __fastcall__ tgi_load_driver (const char* name); void tgi_unload (void); /* Uninstall, then unload the currently loaded driver. Will call tgi_done if - * necessary. - */ +** 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. - */ +** tgi_done if necessary. +*/ void tgi_init (void); /* Initialize the already loaded graphics driver. */ void tgi_done (void); /* End graphics mode, switch back to text mode. Will NOT uninstall or unload - * the driver! - */ +** 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. - */ +** 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. - */ +** 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. +*/ const char* __fastcall__ tgi_geterrormsg (unsigned char code); /* Get an error message describing the error in code. */ @@ -139,8 +138,8 @@ unsigned char tgi_getcolorcount (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. */ @@ -150,8 +149,8 @@ unsigned char tgi_getcolor (void); 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* tgi_getpalette (void); /* Return the current palette. */ @@ -164,26 +163,26 @@ unsigned tgi_getxres (void); unsigned tgi_getmaxx (void); /* Return the maximum x coordinate. The resolution in x direction is - * getmaxx() + 1 - */ +** getmaxx() + 1 +*/ 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 - */ +** getmaxy() + 1 +*/ unsigned tgi_getaspectratio (void); /* Returns the aspect ratio for the loaded driver. The aspect ratio is an - * 8.8 fixed point value. - */ +** 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. - */ +** 8.8 fixed point value. +*/ unsigned char __fastcall__ tgi_getpixel (int x, int y); /* Get the color value of a pixel. */ @@ -196,94 +195,91 @@ void __fastcall__ tgi_gotoxy (int x, int y); 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. - */ +** 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). - */ +** 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). - */ +** 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_settextdir (unsigned char dir); /* Set the direction for text output. dir is one of the TGI_TEXT_XXX - * constants. - */ +** 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. - */ +** 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. - */ +** 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_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. - */ +** 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. - */ +** being an 8.8 fixed point one, and return the rounded and scaled result. +*/ /* End of tgi.h */ #endif - - -