PqEvents.h

/*
 * PqEvents.h
 *
 * (c) 2025 Sofian Audry        :: info(@)sofianaudry(.)com
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 */
 
#include "PqCore.h"
 
#ifndef PQ_EVENT_MANAGER_H_
#define PQ_EVENT_MANAGER_H_
 
namespace pq {
 
class Unit;
 
typedef void (*EventCallback)();
 
enum EventType {
  EVENT_NONE,     // no event
  EVENT_CHANGE,   // value changed
  EVENT_RISE,     // value rose
  EVENT_FALL,     // value fell
  EVENT_BANG,     // single trigger
  EVENT_FINISH,   // process/timer finished
  EVENT_UPDATE,   // unit updated and ready to be read/used
  EVENT_CUSTOM_1, // custom event 1
  EVENT_CUSTOM_2, // custom event 2
  EVENT_CUSTOM_3, // custom event 3
  EVENT_CUSTOM_4, // custom event 4
};
 
class EventManager {
 
private:
  // A listener is a tuple (unit, callback, eventType)
  struct Listener {
    Unit* unit;
    EventCallback callback;
    EventType eventType;
 
    Listener() : unit(NULL), callback(NULL), eventType(EVENT_NONE) {}
 
    Listener(Unit* unit, EventCallback callback, EventType eventType) :
      unit(unit), callback(callback), eventType(eventType) {
    }
 
    bool operator==(const Listener& other) const {
      return unit == other.unit &&
             callback == other.callback &&
             eventType == other.eventType;
    }
  };
public:
  void addListener(Unit* unit, EventCallback callback, EventType eventType);
  // void removeListeners(Unit* unit, EventCallback callback, uint8_t eventType);
 
  void clearListeners(Unit* unit);
 
  void step();
 
private:
  // Contains all listeners.
  HybridArrayList<Listener, 4> _listeners;
};
}
 
#endif