channel_events.h

Go to the documentation of this file.

#pragma once
 
#include "fl/stl/function.h"
#include "fl/stl/noexcept.h"
#include "fl/stl/string.h"  // IWYU pragma: keep
 
namespace fl {
 
class IChannel;
class IChannelDriver;  // IWYU pragma: keep
class ChannelData;
struct ChannelConfig;

#if defined(FASTLED_DISABLE_CHANNEL_EVENTS) && FASTLED_DISABLE_CHANNEL_EVENTS
 
namespace detail {
struct NoOpChannelEvent {
    template <typename... Args>
    void operator()(Args&&...) const FL_NOEXCEPT {}
 
    template <typename F>
    int add(F&& /*f*/, int /*priority*/ = 0) const FL_NOEXCEPT { return -1; }
 
    void remove(int /*id*/) const FL_NOEXCEPT {}
};
}  // namespace detail
 
struct ChannelEvents {
    static ChannelEvents& instance() FL_NOEXCEPT {
        static ChannelEvents s;
        return s;
    }
 
    detail::NoOpChannelEvent onChannelCreated;
    detail::NoOpChannelEvent onChannelBeginDestroy;
    detail::NoOpChannelEvent onChannelAdded;
    detail::NoOpChannelEvent onChannelRemoved;
    detail::NoOpChannelEvent onChannelConfigured;
    detail::NoOpChannelEvent onChannelDataEncoded;
    detail::NoOpChannelEvent onChannelEnqueued;
};
 
#else
 
struct ChannelEvents {
    static ChannelEvents& instance();
 
    // -- Lifecycle events --

    fl::function_list<void(const IChannel&)> onChannelCreated;

    fl::function_list<void(const IChannel&)> onChannelBeginDestroy;
 
    // -- FastLED list events --

    fl::function_list<void(const IChannel&)> onChannelAdded;

    fl::function_list<void(const IChannel&)> onChannelRemoved;
 
    // -- Configuration events --

    fl::function_list<void(const IChannel&, const ChannelConfig&)> onChannelConfigured;
 
    // -- Rendering events --

    fl::function_list<void(const IChannel&, const ChannelData&)> onChannelDataEncoded;

    fl::function_list<void(const IChannel&, const fl::string& driverName)> onChannelEnqueued;
};
 
#endif  // FASTLED_DISABLE_CHANNEL_EVENTS
 
}  // namespace fl