firmware/src/graphics/niche/InkHUD/Tile.h

#ifdef MESHTASTIC_INCLUDE_INKHUD

/*

    Class which represents a region of the display area
    Applets are assigned to a tile
    Tile controls the Applet's dimensions
    Tile receives pixel output from the applet, and translates it to the correct display region

*/

#pragma once

#include "configuration.h"

#include "./Applet.h"

#include "./InkHUD.h"

namespace NicheGraphics::InkHUD
{

class Tile
{
  public:
    Tile();
    Tile(int16_t left, int16_t top, uint16_t width, uint16_t height);

    void setRegion(uint8_t layoutSize, uint8_t tileIndex);                      // Assign region automatically, based on layout
    void setRegion(int16_t left, int16_t top, uint16_t width, uint16_t height); // Assign region manually
    void handleAppletPixel(int16_t x, int16_t y, Color c);                      // Receive px output from assigned applet
    uint16_t getWidth();
    uint16_t getHeight();
    static uint16_t maxDisplayDimension(); // Largest possible width / height any tile may ever encounter

    void assignApplet(Applet *a); // Link an applet with this tile
    Applet *getAssignedApplet();  // Applet which is currently linked with this tile

    void requestHighlight();              // Ask for this tile to be highlighted
    static void startHighlightTimeout();  // Start the auto-dismissal timer
    static void cancelHighlightTimeout(); // Cancel the auto-dismissal timer early; already dismissed

    static Tile *highlightTarget; // Which tile are we highlighting? (Intending to highlight?)
    static bool highlightShown;   // Is the tile highlighted yet? Controls highlight vs dismiss

  private:
    InkHUD *inkhud = nullptr;

    int16_t left = 0;
    int16_t top = 0;
    uint16_t width = 0;
    uint16_t height = 0;

    Applet *assignedApplet = nullptr; // Pointer to the applet which is currently linked with the tile
};

} // namespace NicheGraphics::InkHUD

#endif