mirror of
https://github.com/cc65/cc65.git
synced 2024-12-25 17:29:50 +00:00
d7afadb2fe
So far conio.h included the target header to get the CH_... and COLOR_... macros. However tgi.h never did the same to get the TGI_COLOR_... macros. And some time ago the JOY_..._MASK macros moved from joystick.h into the target header yet joystick.h didn't include the target header. Why wasn't that issue detected so far? Because about every program using TGI and/or the joystick uses CONIO too and therefore includes the target header that way. However, conceptually it's clean to factor out the target header inclusion and have tgi.h and joystick.h do it like conio.h. Apart from that user code may make direct use of target.h too.
286 lines
11 KiB
C
286 lines
11 KiB
C
/*****************************************************************************/
|
|
/* */
|
|
/* tgi.h */
|
|
/* */
|
|
/* Tiny graphics interface */
|
|
/* */
|
|
/* */
|
|
/* */
|
|
/* (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 */
|
|
/* warranty. In no event will the authors be held liable for any damages */
|
|
/* arising from the use of this software. */
|
|
/* */
|
|
/* Permission is granted to anyone to use this software for any purpose, */
|
|
/* including commercial applications, and to alter it and redistribute it */
|
|
/* freely, subject to the following restrictions: */
|
|
/* */
|
|
/* 1. The origin of this software must not be misrepresented; you must not */
|
|
/* claim that you wrote the original software. If you use this software */
|
|
/* in a product, an acknowledgment in the product documentation would be */
|
|
/* appreciated but is not required. */
|
|
/* 2. Altered source versions must be plainly marked as such, and must not */
|
|
/* be misrepresented as being the original software. */
|
|
/* 3. This notice may not be removed or altered from any source */
|
|
/* distribution. */
|
|
/* */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef _TGI_H
|
|
#define _TGI_H
|
|
|
|
|
|
|
|
#include <tgi/tgi-error.h>
|
|
#include <target.h>
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
/* Definitions */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
/* 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 */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
void __fastcall__ tgi_load_driver (const char* name);
|
|
/* 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 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.
|
|
*/
|
|
|
|
const char* __fastcall__ tgi_geterrormsg (unsigned char code);
|
|
/* Get an error message describing the error in code. */
|
|
|
|
void tgi_clear (void);
|
|
/* Clear the drawpage. */
|
|
|
|
unsigned tgi_getpagecount (void);
|
|
/* Returns the number of screen pages available. */
|
|
|
|
void __fastcall__ tgi_setviewpage (unsigned char page);
|
|
/* Set the visible page. Will set an error if the page is not available. */
|
|
|
|
void __fastcall__ tgi_setdrawpage (unsigned char page);
|
|
/* Set the drawable page. Will set an error if the page is not available. */
|
|
|
|
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. */
|
|
|
|
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.
|
|
*/
|
|
|
|
const unsigned char* tgi_getpalette (void);
|
|
/* Return the current palette. */
|
|
|
|
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
|
|
*/
|
|
|
|
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. */
|
|
|
|
void __fastcall__ tgi_setpixel (int x, int y);
|
|
/* 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. 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. 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_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.
|
|
*/
|
|
|
|
|
|
|
|
/* End of tgi.h */
|
|
#endif
|