perfect_dark/port/include/input.h

#ifndef _IN_INPUT_H
#define _IN_INPUT_H

#include <PR/ultratypes.h>
#include <PR/os_cont.h>

#define INPUT_MAX_CONTROLLERS MAXCONTROLLERS
#define INPUT_MAX_CONNECTED_CONTROLLERS 8
#define INPUT_MAX_CONTROLLER_BUTTONS 32
#define INPUT_MAX_BINDS 4

#define CONT_STICK_XNEG 0x10000
#define CONT_STICK_XPOS 0x20000
#define CONT_STICK_YNEG 0x40000
#define CONT_STICK_YPOS 0x80000

#define CONT_NUM_BUTTONS 32 // not including the stick axes

enum virtkey {
	/* same order as SDL scancodes */
	VK_KEYBOARD_BEGIN = 0,
	VK_A = 4,
	VK_Z = 29,
	VK_1 = 30,
	VK_9 = 38,
	VK_0 = 39,
	VK_RETURN = 40,
	VK_ESCAPE = 41,
	VK_BACKSPACE = 42,
	VK_SPACE = 44,
	VK_MINUS = 45,
	VK_LEFTBRACKET = 47,
	VK_RIGHTBRACKET = 48,
	VK_SEMICOLON = 51,
	VK_GRAVE = 53,
	VK_COMMA = 54,
	VK_PERIOD = 55,
	VK_F1 = 58,
	VK_F9 = 66,
	VK_DELETE = 76,
	VK_LCTRL = 224,
	VK_LSHIFT = 225,
	VK_LALT = 226,
	VK_RCTRL = 228,
	VK_RSHIFT = 229,

	/* same order as SDL mouse buttons */
	VK_MOUSE_BEGIN = 512,
	VK_MOUSE_LEFT = VK_MOUSE_BEGIN,
	VK_MOUSE_MIDDLE,
	VK_MOUSE_RIGHT,
	VK_MOUSE_X1,
	VK_MOUSE_X2,
	VK_MOUSE_WHEEL_UP,
	VK_MOUSE_WHEEL_DN,

	/* same order as SDL gamecontroller buttons plus two buttons for triggers */
	VK_JOY_BEGIN,
	VK_JOY1_BEGIN = VK_JOY_BEGIN,
	VK_JOY1_LSHOULDER = VK_JOY1_BEGIN + 9,
	VK_JOY1_RSHOULDER = VK_JOY1_BEGIN + 10,
	VK_JOY1_LTRIG = VK_JOY1_BEGIN + 30,
	VK_JOY1_RTRIG = VK_JOY1_BEGIN + 31,
	VK_JOY2_BEGIN = VK_JOY1_BEGIN + INPUT_MAX_CONTROLLER_BUTTONS,
	VK_JOY3_BEGIN = VK_JOY2_BEGIN + INPUT_MAX_CONTROLLER_BUTTONS,
	VK_JOY4_BEGIN = VK_JOY3_BEGIN + INPUT_MAX_CONTROLLER_BUTTONS,

	VK_TOTAL_COUNT = VK_JOY_BEGIN + INPUT_MAX_CONTROLLERS * INPUT_MAX_CONTROLLER_BUTTONS,
};

enum keymod {
	/* same order as SDL keymods */
	KM_LSHIFT = 0x0001,
	KM_RSHIFT = 0x0002,
	KM_LCTRL = 0x0040,
	KM_RCTRL = 0x0080,
	KM_CAPS = 0x2000,
	KM_CTRL = KM_LCTRL | KM_RCTRL,
	KM_SHIFT = KM_LSHIFT | KM_RSHIFT
};

enum contkey {
	CK_C_R,
	CK_C_L,
	CK_C_D,
	CK_C_U,
	CK_RTRIG,
	CK_LTRIG,
	CK_X, // gap in CONT_
	CK_Y, // gap in CONT_
	CK_DPAD_R,
	CK_DPAD_L,
	CK_DPAD_D,
	CK_DPAD_U,
	CK_START,
	CK_ZTRIG,
	CK_B,
	CK_A,
	CK_STICK_XNEG,
	CK_STICK_XPOS,
	CK_STICK_YNEG,
	CK_STICK_YPOS,
	CK_ACCEPT,
	CK_CANCEL,
	CK_0040,
	CK_0080,
	CK_0100,
	CK_0200,
	CK_0400,
	CK_0800,
	CK_1000,
	CK_2000,
	CK_4000,
	CK_8000,
	CK_TOTAL_COUNT
};

enum mouselockmode {
	MLOCK_OFF = 0,
	MLOCK_ON = 1,
	MLOCK_AUTO = 2
};

// returns bitmask of connected controllers or -1 if failed
s32 inputInit(void);

// read the specified player's inputs into the N64 pad struct
// returns 0 if read, non-0 if failed
s32 inputReadController(s32 idx, OSContPad *npad);

// returns 1 if rumble is supported for specified player's controller
s32 inputRumbleSupported(s32 idx);

// returns 1 if specified player has a live controller assigned
s32 inputControllerConnected(s32 idx);

// returns bitmask of players with assigned controllers
s32 inputControllerMask(void);

// get/set Input.Player%d.SwapSticks
s32 inputControllerGetSticksSwapped(s32 cidx);
void inputControllerSetSticksSwapped(s32 cidx, s32 swapped);

// get/set Input.Player%d.StickCButtons (DualAnalog is 1 if StickCButtons is 0)
s32 inputControllerGetDualAnalog(s32 cidx);
void inputControllerSetDualAnalog(s32 cidx, s32 enable);

// get/set Input.Player%d.CancelCButtons
s32 inputControllerGetCancelCButtons(s32 cidx);
void inputControllerSetCancelCButtons(s32 cidx, s32 cancel);

// get/set sensitivity for a given player
f32 inputControllerGetAxisScale(s32 cidx, s32 stick, s32 axis);
void inputControllerSetAxisScale(s32 cidx, s32 stick, s32 axis, f32 value);

// get/set deadzone for a given player
f32 inputControllerGetAxisDeadzone(s32 cidx, s32 stick, s32 axis);
void inputControllerSetAxisDeadzone(s32 cidx, s32 stick, s32 axis, f32 value);

// writes array of up to INPUT_MAX_CONNECTED_CONTROLLERS controller IDs
// for all the controllers available on this machine into out if it's not NULL
// returns number of IDs that would've been written (or were written if out is not NULL)
s32 inputGetConnectedControllers(s32 *out);

// get name of connected controller id
// returns "Invalid" on failure
const char *inputGetConnectedControllerName(s32 id);

// get id of the controller currently assigned to player cidx or -1 if none
s32 inputGetAssignedControllerId(s32 cidx);

// assign connected controller id to player cidx
// if id is -1, unassigns controller from player, if any
// returns true on success, false on failure
s32 inputAssignController(s32 cidx, s32 id);

// vk is a value from the virtkey enum above
s32 inputKeyPressed(u32 vk);
s32 inputKeyJustPressed(u32 vk);

// idx is controller index, contbtn is one of the CONT_ constants
s32 inputButtonPressed(s32 idx, u32 contbtn);

// bind virtkey vk to n64 pad #idx's button/axis ck as represented by its contkey value
// if bind is -1, picks a bind slot automatically
void inputKeyBind(s32 idx, u32 ck, s32 bind, u32 vk);

const u32 *inputKeyGetBinds(s32 idx, u32 ck);

// get VK_ value from human-readable name
s32 inputGetKeyByName(const char *name);

// get human-readable name from VK_ value
const char *inputGetKeyName(s32 vk);

// get CK_ value from human-readable name
s32 inputGetContKeyByName(const char *name);

// get human-readable name from CK_ value
const char *inputGetContKeyName(u32 ck);

// strength is 0 .. 1; 0 strength turns it off
void inputRumble(s32 idx, f32 strength, f32 time);

f32 inputRumbleGetStrength(s32 cidx);
void inputRumbleSetStrength(s32 cidx, f32 val);

// locks the mouse cursor in the window and makes it invisible if argument is true
void inputLockMouse(s32 lock);

// returns the current state of the above
s32 inputMouseIsLocked(void);

// sets x, y to mouse position in native viewport coordinates (ie, 320x240 most of the time)
// returns true if mouse has moved this input frame
s32 inputMouseGetPosition(s32 *x, s32 *y);

// returns changes in mouse position since last frame, in window coordinates
void inputMouseGetRawDelta(s32 *dx, s32 *dy);

// returns changes in mouse position since last frame, scaled by sensitivity
// returns 0, 0 when the mouse is not locked into the window
void inputMouseGetScaledDelta(f32 *dx, f32 *dy);

// returns changes in mouse position since last frame, scaled by absolute sensitivity
// returns 0, 0 when the mouse is not locked into the window
void inputMouseGetAbsScaledDelta(f32 *dx, f32 *dy);

void inputMouseGetSpeed(f32 *x, f32 *y);
void inputMouseSetSpeed(f32 x, f32 y);

s32 inputMouseIsEnabled(void);
void inputMouseEnable(s32 enabled);

// call this every frame
void inputUpdate(void);

// call this before configSave()
void inputSaveBinds(void);

// reset given player's binds to either PC or N64 defaults
void inputSetDefaultKeyBinds(s32 cidx, s32 n64mode);

// clear or get the last pressed button
void inputClearLastKey(void);
s32 inputGetLastKey(void);

// get/set Input.MouseLockMode
s32 inputGetMouseLockMode(void);
void inputSetMouseLockMode(s32 lockmode);

// same as inputLockMouse but works only if mouse is enabled and lockmode == MLOCK_AUTO
s32 inputAutoLockMouse(s32 wantlock);

// show/hide mouse cursor; if mouse lock is on the cursor is always hidden
void inputMouseShowCursor(s32 show);

void inputStartTextInput(void);
void inputStopTextInput(void);
s32 inputIsTextInputActive(void);

void inputClearLastTextChar(void);
char inputGetLastTextChar(void);

s32 inputTextHandler(char *out, const u32 outSize, s32 *curCol, s32 oskCharsOnly);

void inputClearClipboard(void);
const char *inputGetClipboard(void);

// returns keymod values
u32 inputGetKeyModState(void);

s32 inputMenuAlt1MenuPressed(s32 playerNum);
s32 inputMenuAlt2MenuPressed(s32 playerNum);
s32 inputMenuAltMenuPressed(s32 playerNum);

#endif