mirror of
https://git.code.sf.net/p/quake/quakeforge
synced 2024-11-27 14:42:07 +00:00
12c84046f3
This is an extremely extensive patch as it hits every cvar, and every usage of the cvars. Cvars no longer store the value they control, instead, they use a cexpr value object to reference the value and specify the value's type (currently, a null type is used for strings). Non-string cvars are passed through cexpr, allowing expressions in the cvars' settings. Also, cvars have returned to an enhanced version of the original (id quake) registration scheme. As a minor benefit, relevant code having direct access to the cvar-controlled variables is probably a slight optimization as it removed a pointer dereference, and the variables can be located for data locality. The static cvar descriptors are made private as an additional safety layer, though there's nothing stopping external modification via Cvar_FindVar (which is needed for adding listeners). While not used yet (partly due to working out the design), cvars can have a validation function. Registering a cvar allows a primary listener (and its data) to be specified: it will always be called first when the cvar is modified. The combination of proper listeners and direct access to the controlled variable greatly simplifies the more complex cvar interactions as much less null checking is required, and there's no need for one cvar's callback to call another's. nq-x11 is known to work at least well enough for the demos. More testing will come.
157 lines
3.5 KiB
C
157 lines
3.5 KiB
C
/*
|
|
joystick.h
|
|
|
|
QuakeForge joystick DPI (driver programming interface)
|
|
|
|
Copyright (C) 1996-1997 Jeff Teunissen <deek@dusknet.dhs.org>
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License
|
|
as published by the Free Software Foundation; either version 2
|
|
of the License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
See the GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to:
|
|
|
|
Free Software Foundation, Inc.
|
|
59 Temple Place - Suite 330
|
|
Boston, MA 02111-1307, USA
|
|
|
|
*/
|
|
|
|
#ifndef __QF_joystick_h
|
|
#define __QF_joystick_h
|
|
|
|
#include <QF/qtypes.h>
|
|
#include "QF/quakeio.h"
|
|
|
|
#define JOY_MAX_AXES 32
|
|
#define JOY_MAX_BUTTONS 64
|
|
|
|
extern char *joy_device;
|
|
extern int joy_enable;
|
|
|
|
struct joy_axis_button {
|
|
float threshold;
|
|
int key;
|
|
int state;
|
|
};
|
|
|
|
typedef enum {
|
|
js_none, // ignore axis
|
|
js_position, // linear delta
|
|
js_angles, // linear delta
|
|
js_button, // axis button
|
|
} js_dest_t;
|
|
|
|
typedef enum {
|
|
js_clear,
|
|
js_amp,
|
|
js_pre_amp,
|
|
js_deadzone,
|
|
js_offset,
|
|
js_type,
|
|
js_axis_button,
|
|
} js_opt_t;
|
|
|
|
struct joy_axis {
|
|
int current;
|
|
float amp;
|
|
float pre_amp;
|
|
int deadzone;
|
|
float offset;
|
|
js_dest_t dest;
|
|
int axis; // if linear delta
|
|
int num_buttons; // if axis button
|
|
struct joy_axis_button *axis_buttons; // if axis button
|
|
};
|
|
|
|
extern qboolean joy_found; // Joystick present?
|
|
extern qboolean joy_active; // Joystick in use?
|
|
|
|
struct joy_button {
|
|
int old;
|
|
int current;
|
|
};
|
|
|
|
extern struct joy_axis joy_axes[JOY_MAX_AXES];
|
|
|
|
extern struct joy_button joy_buttons[JOY_MAX_BUTTONS];
|
|
|
|
/*
|
|
JOY_Command ()
|
|
|
|
Use this function to process joystick button presses and generate key
|
|
events. It is called inside the IN_Commands () input function, once each
|
|
frame.
|
|
|
|
You should exit this function immediately if either joy_active or
|
|
joy_enable are zero.
|
|
*/
|
|
void JOY_Command (void);
|
|
void joy_clear_axis (int i);
|
|
|
|
/*
|
|
JOY_Move (usercmd_t *) // FIXME: Not anymore!
|
|
|
|
Use this function to process joystick movements to move the player around.
|
|
|
|
You should exit this function immediately if either joy_active or
|
|
joy_enable are zero.
|
|
*/
|
|
void JOY_Move (void);
|
|
|
|
/*
|
|
JOY_Init ()
|
|
|
|
Use this function to initialize the joystick Cvars, open your joystick
|
|
device, and get it ready for use. You MUST obey the value of the
|
|
joy_enable Cvar. Set joy_found if there is a device, and joy_active if
|
|
you have successfully enabled it.
|
|
*/
|
|
void JOY_Init (void);
|
|
void JOY_Init_Cvars (void);
|
|
|
|
/*
|
|
JOY_Shutdown ()
|
|
|
|
Use this function to close the joystick device and tell QuakeForge that it
|
|
is no longer available. It is called from IN_Init (), but may be called
|
|
elsewhere to disable the device.
|
|
*/
|
|
void JOY_Shutdown (void);
|
|
|
|
/*
|
|
JOY_Open ()
|
|
JOY_Close ()
|
|
|
|
OS-specific joystick init/deinit
|
|
*/
|
|
int JOY_Open (void);
|
|
void JOY_Close (void);
|
|
|
|
/*
|
|
JOY_Read ()
|
|
|
|
OS-specific joystick reading
|
|
*/
|
|
void JOY_Read (void);
|
|
|
|
|
|
const char *JOY_GetOption_c (int i) __attribute__((pure));
|
|
int JOY_GetOption_i (const char *c) __attribute__((pure));
|
|
|
|
const char *JOY_GetDest_c (int i) __attribute__((pure));
|
|
int JOY_GetDest_i (const char *c) __attribute__((pure));
|
|
int JOY_GetAxis_i (int dest, const char *c);
|
|
|
|
|
|
void Joy_WriteBindings (QFile *f);
|
|
|
|
#endif//__QF_joystick_h
|