mirror of
https://github.com/cc65/cc65.git
synced 2024-08-28 02:29:22 +00:00
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.
110 lines
5.0 KiB
C
110 lines
5.0 KiB
C
/*****************************************************************************/
|
|
/* */
|
|
/* joystick.h */
|
|
/* */
|
|
/* Read the joystick on systems that support it */
|
|
/* */
|
|
/* */
|
|
/* */
|
|
/* (C) 1998-2011, 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 _JOYSTICK_H
|
|
#define _JOYSTICK_H
|
|
|
|
|
|
|
|
#include <target.h>
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
/* Definitions */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
/* Error codes */
|
|
#define JOY_ERR_OK 0 /* No error */
|
|
#define JOY_ERR_NO_DRIVER 1 /* No driver available */
|
|
#define JOY_ERR_CANNOT_LOAD 2 /* Error loading driver */
|
|
#define JOY_ERR_INV_DRIVER 3 /* Invalid driver */
|
|
#define JOY_ERR_NO_DEVICE 4 /* Device (hardware) not found */
|
|
|
|
/* Argument for the joy_read function */
|
|
#define JOY_1 0
|
|
#define JOY_2 1
|
|
|
|
/* Macros that evaluate the return code of joy_read */
|
|
#define JOY_UP(v) ((v) & JOY_UP_MASK)
|
|
#define JOY_DOWN(v) ((v) & JOY_DOWN_MASK)
|
|
#define JOY_LEFT(v) ((v) & JOY_LEFT_MASK)
|
|
#define JOY_RIGHT(v) ((v) & JOY_RIGHT_MASK)
|
|
#define JOY_BTN_1(v) ((v) & JOY_BTN_1_MASK) /* Universally available */
|
|
#define JOY_BTN_2(v) ((v) & JOY_BTN_2_MASK) /* Second button if available */
|
|
#define JOY_BTN_3(v) ((v) & JOY_BTN_3_MASK) /* Third button if available */
|
|
#define JOY_BTN_4(v) ((v) & JOY_BTN_4_MASK) /* Fourth button if available */
|
|
|
|
/* The name of the standard joystick driver for a platform */
|
|
extern const char joy_stddrv[];
|
|
|
|
/* The address of the static standard joystick driver for a platform */
|
|
extern const void joy_static_stddrv[];
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
/* Functions */
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
unsigned char __fastcall__ joy_load_driver (const char* driver);
|
|
/* Load and install a joystick driver. Return an error code. */
|
|
|
|
unsigned char joy_unload (void);
|
|
/* Uninstall, then unload the currently loaded driver. */
|
|
|
|
unsigned char __fastcall__ joy_install (void* driver);
|
|
/* Install an already loaded driver. Return an error code. */
|
|
|
|
unsigned char joy_uninstall (void);
|
|
/* Uninstall the currently loaded driver and return an error code.
|
|
** Note: This call does not free allocated memory.
|
|
*/
|
|
|
|
unsigned char joy_count (void);
|
|
/* Return the number of joysticks supported by the driver */
|
|
|
|
unsigned char __fastcall__ joy_read (unsigned char joystick);
|
|
/* Read a particular joystick */
|
|
|
|
|
|
|
|
/* End of joystick.h */
|
|
#endif
|