EventJoystick.h

/*
 *
 * GPLv2 Licence https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
 * 
 * Copyright (c) 2024 Philip Fletcher <philip.fletcher@stutchbury.com>
 * 
 */
 
 
#ifndef EVENT_JOYSTICK_H
#define EVENT_JOYSTICK_H
 
#include "Arduino.h"
#include "EventAnalog.h"
 
 
class EventJoystick : public EventInputBase {
 
protected:
 
    #if defined(FUNCTIONAL_SUPPORTED)
        typedef std::function<void(InputEventType et, EventJoystick &ie)> CallbackFunction;
    #else
        typedef void (*CallbackFunction)(InputEventType et, EventJoystick &);
    #endif
 
    CallbackFunction callbackFunction = nullptr;
 
    void invoke(InputEventType et) override;
 
    void onEnabled() override;
    void onDisabled() override;
    void onIdle() override { /* Do nothing. Fire idle callback from either x or y but only if both are idle from onInputCallback() */ }
 
public:
 
 
    EventJoystick(byte analogX, byte analogY, uint8_t adcBits=10);
 
 
 
 
 
    void begin();
 
    void setCallback(CallbackFunction f) {
        callbackFunction = f;
        callbackIsSet = true;
    }
 
    #if defined(FUNCTIONAL_SUPPORTED)
    // Method to set callback with instance and class method
    template <typename T>
    void setCallback(T* instance, void (T::*method)(InputEventType, EventJoystick&)) {
        // Wrap the method call in a lambda
        callbackFunction = [instance, method](InputEventType et, EventJoystick &ie) {
            (instance->*method)(et, ie); // Call the member function on the instance
        };
        callbackIsSet = true;
    }
    #endif
 
    void unsetCallback() override;
 
    void update();
 
 
    EventAnalog x;
 
    EventAnalog y;
 
 
 
    bool hasChanged();
 
    bool isEnabled();
 
    bool isIdle();
 
 
 
    void setNumIncrements(uint8_t numIncr=10);
 
    void setNumNegativeIncrements(uint8_t numIncr=10);
 
    void setNumPositiveIncrements(uint8_t numIncr=10);
 
 
    void setStartValues();
 
    void setCentreBoundary(uint16_t width=200);
    void setOuterBoundary(uint16_t width=100);
 
 
 
     void setRateLimit(uint16_t ms);
 
    void enableAutoCalibrate(bool allow=true);
 
 
protected:
    void onInputCallback(InputEventType et, EventInputBase & ie);
    void onInputXCallback(InputEventType et, EventInputBase & ie);
    void onInputYCallback(InputEventType et, EventInputBase & ie);
 
private:
 
 
#ifndef FUNCTIONAL_SUPPORTED
private:
    static void analogXCallback(InputEventType et, EventAnalog &enc) {
        EventJoystick *instance = static_cast<EventJoystick *>(enc.getOwner());
        if (instance) instance->onInputXCallback(et, enc);
    }
 
    static void analogYCallback(InputEventType et, EventAnalog &enc) {
        EventJoystick *instance = static_cast<EventJoystick *>(enc.getOwner());
        if (instance) instance->onInputYCallback(et, enc);
    }
#endif
 
 
};
 
 
#endif