Files
Flipdot-display/src/esp32/logic/page_render.h
T

46 lines
1.9 KiB
C++
Raw Normal View History

#pragma once
#include <stdint.h>
#include "logic/font.h"
2026-10-20 17:52:25 +02:00
#include "logic/life.h"
#include "logic/local_time.h"
#include "logic/page.h"
// Draws a dynamic page into a full screen bitmap (logic/bitmap_format.h). Used for the
// display and for the previews in the web UI. Pure logic, tested in test/test_esp32.
// Where the page gets its bitmaps, fonts, Home Assistant values and the stopwatch
class PageResources
{
public:
// Loads a bitmap (background or image); false when it is gone
virtual bool background(const char *name, uint8_t *bitmap) = 0;
// A font by name; a font without data when it is gone ("Normal" is used then)
virtual Font font(const char *name) = 0;
// The current value of a Home Assistant element; nullptr when not known
virtual const char *haValue(const PageElement &element) = 0;
virtual uint32_t stopwatchMs() { return 0; }
virtual bool stopwatchRunning() { return false; }
2026-10-20 17:52:25 +02:00
// The running Game of Life of the shown page when this element starts like it
// (sameLifeStart); nullptr otherwise (the start is drawn then)
virtual const LifeRunner *life(const PageElement &) { return nullptr; }
};
// The area an element covers on the screen (for the editor), may be partly off screen.
// For scrolling texts, the window.
struct ElementBox
{
int16_t x = 0;
int16_t y = 0;
int16_t width = 0;
int16_t height = 0;
};
// now_ms: a running millisecond counter (millis()), for scrolling. boxes: nullptr, or room
// for page.element_count boxes.
// Returns the ms until the page looks different again (scrolling, seconds, a running
2026-10-20 17:52:25 +02:00
// stopwatch, the next generation of a Game of Life), or 0 when it only changes with the minute or its content (Home Assistant
// values, the stopwatch being started or stopped).
uint32_t renderPage(const DynamicPage &page, const LocalTime &time, uint32_t now_ms, PageResources &resources,
uint8_t *bitmap, ElementBox *boxes = nullptr);