unit_RectLED.hpp

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
 *
 * SPDX-License-Identifier: MIT
 */
#ifndef M5_UNIT_RGB_UNIT_RECT_LED_HPP
#define M5_UNIT_RGB_UNIT_RECT_LED_HPP
 
#include <m5_utility/murmurhash3.hpp>
 
#include "unit_LED.hpp"
#include "unit_SK6812.hpp"
#include "unit_WS2812.hpp"
 
namespace m5 {
namespace unit {
 
template <const uint8_t WIDTH, const uint8_t HEIGHT, class BaseClass>
class UnitRectLED : public BaseClass {
    static_assert(WIDTH > 0, "WIDTH must be greater than 0");
    static_assert(HEIGHT > 0, "HEIGHT must be greater than 0");
    static_assert(std::is_base_of<UnitLED, BaseClass>::value, "BaseClass must derive from UnitLED");
    M5_UNIT_COMPONENT_HPP_BUILDER(UnitRectLED, 0x00);
 
public:
    using BaseClass::BaseClass;
    UnitRectLED() : BaseClass(WIDTH * HEIGHT)
    {
    }
    static constexpr uint8_t LED_WIDTH{WIDTH};    
    static constexpr uint8_t LED_HEIGHT{HEIGHT};  
 
    inline virtual uint16_t width() const override
    {
        return (this->rotation() & 1) ? HEIGHT : WIDTH;
    }
    inline virtual uint16_t height() const override
    {
        return (this->rotation() & 1) ? WIDTH : HEIGHT;
    }
 
    inline virtual uint8_t maxRotation() const override
    {
        // 0:0 1:90 2:180 3:270
        return 4;
    }
 
protected:
    virtual uint16_t index_of(const uint16_t n) const override
    {
        switch (this->rotation()) {
            case 1: {  // 90° CW (logical grid: HEIGHT x WIDTH)
                uint8_t x = n % HEIGHT;
                uint8_t y = n / HEIGHT;
                return x * WIDTH + (WIDTH - 1 - y);
            }
            case 2: {  // 180° (logical grid: WIDTH x HEIGHT)
                uint8_t x = n % WIDTH;
                uint8_t y = n / WIDTH;
                return (HEIGHT - 1 - y) * WIDTH + (WIDTH - 1 - x);
            }
            case 3: {  // 270° CW (logical grid: HEIGHT x WIDTH)
                uint8_t x = n % HEIGHT;
                uint8_t y = n / HEIGHT;
                return (HEIGHT - 1 - x) * WIDTH + y;
            }
            default: {  // 0°
                return n;
            }
        }
    }
};
 
// class UnitRectLED
template <const uint8_t WIDTH, const uint8_t HEIGHT, class BaseClass>
const char UnitRectLED<WIDTH, HEIGHT, BaseClass>::name[] = "UnitRectLED";
template <const uint8_t WIDTH, const uint8_t HEIGHT, class BaseClass>
const types::uid_t UnitRectLED<WIDTH, HEIGHT, BaseClass>::uid{
    m5::utility::mmh3::calculate("UnitRectLED", sizeof("UnitRectLED") - 1)};
template <const uint8_t WIDTH, const uint8_t HEIGHT, class BaseClass>
const types::attr_t UnitRectLED<WIDTH, HEIGHT, BaseClass>::attr{types::attribute::AccessGPIO};
 
}  // namespace unit
}  // namespace m5
#endif