#pragma once

#ifndef JOYSTICK_H

#define JOYSTICK_H

#include <stdint.h>

#include <stdbool.h>

#define JOY_LATCH_MASK 0x04

#define JOY_CLK_MASK 0x08

#define NUM_JOYSTICKS 4

extern uint8_t Joystick_data;

extern bool Joystick_slots_enabled[NUM_JOYSTICKS];

bool joystick_init(void); //initialize SDL controllers

void joystick_add(int index);

void joystick_remove(int index);

void joystick_button_down(int instance_id, uint8_t button);

void joystick_button_up(int instance_id, uint8_t button);

void joystick_set_latch(bool value);

void joystick_set_clock(bool value);

/* --- Virtual pads, for the RRDC control port (contract 0.5) ----------

 *

 * A harness has no SDL controller to plug in, so it asks for one to be

 * synthesised in a joystick slot. `mask` is the X16's own SNES bit

 * order and is ACTIVE LOW, exactly like joystick_info::button_mask —

 * converting from RRDC's canonical layout is the caller's job, not

 * this layer's.

 *

 * A virtual pad is a LEVEL, not an event: what it holds persists across

 * frames until set again, which is what makes "hold RIGHT for 60

 * frames" expressible. Returns false if `slot` is out of range. */

bool joystick_virtual_set(int slot, bool connected, bool set_buttons, uint16_t mask);

/* Read back what is present in `slot` — a virtual pad OR a real one, so

 * a harness can tell "no controller at all" from "controller present,

 * nothing held". Returns false if `slot` is out of range. */

bool joystick_virtual_get(int slot, bool *connected, uint16_t *mask);

#endif