Xteink-X4-crosspoint-reader/lib/GfxRenderer/GfxRenderer.h

#pragma once

#include <EpdFontFamily.h>
#include <HalDisplay.h>

#include <map>

#include "Bitmap.h"

class GfxRenderer {
public:
  enum RenderMode { BW, GRAYSCALE_LSB, GRAYSCALE_MSB };

  // Logical screen orientation from the perspective of callers
  enum Orientation {
    Portrait,           // 480x800 logical coordinates (current default)
    LandscapeClockwise, // 800x480 logical coordinates, rotated 180° (swap
                        // top/bottom)
    PortraitInverted,   // 480x800 logical coordinates, inverted
    LandscapeCounterClockwise // 800x480 logical coordinates, native panel
                              // orientation
  };

 private:
  static constexpr size_t BW_BUFFER_CHUNK_SIZE = 8000;  // 8KB chunks to allow for non-contiguous memory
  static constexpr size_t BW_BUFFER_NUM_CHUNKS = HalDisplay::BUFFER_SIZE / BW_BUFFER_CHUNK_SIZE;
  static_assert(BW_BUFFER_CHUNK_SIZE * BW_BUFFER_NUM_CHUNKS == HalDisplay::BUFFER_SIZE,
                "BW buffer chunking does not line up with display buffer size");

  HalDisplay& display;
  RenderMode renderMode;
  Orientation orientation;
  uint8_t *bwBufferChunks[BW_BUFFER_NUM_CHUNKS] = {nullptr};
  std::map<int, EpdFontFamily> fontMap;
  void renderChar(const EpdFontFamily &fontFamily, uint32_t cp, int *x,
                  const int *y, bool pixelState,
                  EpdFontFamily::Style style) const;
  void freeBwBufferChunks();
  void rotateCoordinates(int x, int y, int *rotatedX, int *rotatedY) const;

 public:
  explicit GfxRenderer(HalDisplay& halDisplay) : display(halDisplay), renderMode(BW), orientation(Portrait) {}
  ~GfxRenderer() { freeBwBufferChunks(); }

  static constexpr int VIEWABLE_MARGIN_TOP = 9;
  static constexpr int VIEWABLE_MARGIN_RIGHT = 3;
  static constexpr int VIEWABLE_MARGIN_BOTTOM = 3;
  static constexpr int VIEWABLE_MARGIN_LEFT = 3;

  // Setup
  void insertFont(int fontId, EpdFontFamily font);

  // Orientation control (affects logical width/height and coordinate
  // transforms)
  void setOrientation(const Orientation o) { orientation = o; }
  Orientation getOrientation() const { return orientation; }

  // Screen ops
  int getScreenWidth() const;
  int getScreenHeight() const;
  void displayBuffer(HalDisplay::RefreshMode refreshMode = HalDisplay::FAST_REFRESH) const;
  // EXPERIMENTAL: Windowed update - display only a rectangular region
  void displayWindow(int x, int y, int width, int height) const;
  void invertScreen() const;
  void clearScreen(uint8_t color = 0xFF) const;

  // Drawing
  void drawPixel(int x, int y, bool state = true) const;
  bool readPixel(int x, int y) const; // Returns true if pixel is black
  void drawLine(int x1, int y1, int x2, int y2, bool state = true) const;
  void drawRect(int x, int y, int width, int height, bool state = true) const;
  void fillRect(int x, int y, int width, int height, bool state = true) const;
  void fillRectDithered(int x, int y, int width, int height, uint8_t grayLevel) const;
  void drawRoundedRect(int x, int y, int width, int height, int radius, bool state = true) const;
  void fillRoundedRect(int x, int y, int width, int height, int radius, bool state = true) const;
  void fillRoundedRectDithered(int x, int y, int width, int height, int radius, uint8_t grayLevel) const;
  void drawImage(const uint8_t bitmap[], int x, int y, int width,
                 int height) const;
  void drawBitmap(const Bitmap &bitmap, int x, int y, int maxWidth,
                  int maxHeight, float cropX = 0, float cropY = 0) const;
  void drawBitmap1Bit(const Bitmap &bitmap, int x, int y, int maxWidth,
                      int maxHeight) const;
  void drawTransparentBitmap(const Bitmap& bitmap, int x, int y, int w, int h) const;
  void draw2BitImage(const uint8_t data[], int x, int y, int w, int h) const;
  void fillPolygon(const int *xPoints, const int *yPoints, int numPoints,
                   bool state = true) const;

  // Region caching - copies a rectangular region to/from a buffer
  // Returns allocated buffer on success, nullptr on failure. Caller owns the
  // memory.
  uint8_t *captureRegion(int x, int y, int width, int height,
                         size_t *outSize) const;
  // Restores a previously captured region. Buffer must match dimensions.
  void restoreRegion(const uint8_t *buffer, int x, int y, int width,
                     int height) const;

  // Text
  int getTextWidth(int fontId, const char *text,
                   EpdFontFamily::Style style = EpdFontFamily::REGULAR) const;
  void
  drawCenteredText(int fontId, int y, const char *text, bool black = true,
                   EpdFontFamily::Style style = EpdFontFamily::REGULAR) const;
  void drawText(int fontId, int x, int y, const char *text, bool black = true,
                EpdFontFamily::Style style = EpdFontFamily::REGULAR) const;
  int getSpaceWidth(int fontId) const;
  int getFontAscenderSize(int fontId) const;
  int getLineHeight(int fontId) const;
  std::string
  truncatedText(int fontId, const char *text, int maxWidth,
                EpdFontFamily::Style style = EpdFontFamily::REGULAR) const;

  // UI Components
  void drawButtonHints(int fontId, const char *btn1, const char *btn2,
                       const char *btn3, const char *btn4);
  void drawSideButtonHints(int fontId, const char *topBtn,
                           const char *bottomBtn) const;

private:
  // Helper for drawing rotated text (90 degrees clockwise, for side buttons)
  void drawTextRotated90CW(
      int fontId, int x, int y, const char *text, bool black = true,
      EpdFontFamily::Style style = EpdFontFamily::REGULAR) const;
  int getTextHeight(int fontId) const;

public:
  // Grayscale functions
  void setRenderMode(const RenderMode mode) { this->renderMode = mode; }
  void copyGrayscaleLsbBuffers() const;
  void copyGrayscaleMsbBuffers() const;
  void displayGrayBuffer() const;
  bool storeBwBuffer();   // Returns true if buffer was stored successfully
  void restoreBwBuffer(); // Restore and free the stored buffer
  void cleanupGrayscaleWithFrameBuffer() const;

  // Low level functions
  uint8_t *getFrameBuffer() const;
  static size_t getBufferSize();
  void grayscaleRevert() const;
  void getOrientedViewableTRBL(int *outTop, int *outRight, int *outBottom,
                               int *outLeft) const;
};