is31fl3733_rgb_matrix.hpp

/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Cal Abel. All rights reserved.
 *  Licensed under the MIT License. See LICENSE in the project root for license information.
 *
 *  Based on the original IS31FL3733 C++ library by Neil Enns
 *  (https://github.com/neilenns/is31fl3733).
 *  RGB matrix helper - part of async DMA rewrite for Arduino SAMD.
 *
 *  IS31FL3733 RGB matrix helper utilities.
 *--------------------------------------------------------------------------------------------*/
#pragma once
 
#include "is31fl3733.hpp"
#include "is31fl3733_color_utils.hpp"
 
namespace IS31FL3733 {
class IS31FL3733RgbMatrix : public IS31FL3733 {
  public:
    static constexpr uint8_t kRows = 4;
    static constexpr uint8_t kCols = 16;
    IS31FL3733RgbMatrix(TwoWire *wire, uint8_t addr = 0x50, uint8_t sdbPin = 0xFF,
                        uint8_t irqPin = 0xFF, ColorOrder order = ColorOrder::GRB)
        : IS31FL3733(wire, addr, sdbPin, irqPin) {
        SetColorOrder(order);
    }
    using IS31FL3733::GetColorOrder;
    using IS31FL3733::SetColorOrder;
 
    static bool IsValidRow(uint8_t row) {
        return row >= 1 && row <= kRows;
    }
 
    static bool IsValidCol(uint8_t col) {
        return col >= 1 && col <= kCols;
    }
    void SetPixelColor32(uint8_t row, uint8_t col, uint32_t packedRgb, bool gamma = false) {
        if (!IsValidRow(row) || !IsValidCol(col)) {
            return;
        }
 
        uint32_t color = gamma ? ColorUtils::Gamma32(packedRgb) : packedRgb;
 
        const uint8_t r = static_cast<uint8_t>((color >> 16) & 0xFF);
        const uint8_t g = static_cast<uint8_t>((color >> 8) & 0xFF);
        const uint8_t b = static_cast<uint8_t>(color & 0xFF);
 
        IS31FL3733::SetPixelColor(row, col, r, g, b);
    }
 
    void SetPixelHSV(uint8_t row, uint8_t col, uint16_t hue, uint8_t sat = 255, uint8_t val = 255,
                     bool gamma = true) {
        uint32_t color = ColorUtils::ColorHSV(hue, sat, val);
        SetPixelColor32(row, col, color, gamma);
    }
 
    void FillColor32(uint32_t packedRgb, bool gamma = false) {
        for (uint8_t row = 1; row <= kRows; row++) {
            for (uint8_t col = 1; col <= kCols; col++) {
                SetPixelColor32(row, col, packedRgb, gamma);
            }
        }
    }
 
    void FillHSV(uint16_t hue, uint8_t sat = 255, uint8_t val = 255, bool gamma = true) {
        const uint32_t color = ColorUtils::ColorHSV(hue, sat, val);
        FillColor32(color, gamma);
    }
};
} // namespace IS31FL3733