RenderHelpers.h

Go to the documentation of this file.

#pragma once
 
#include <cstddef>
#include <cstdint>
 
#include <gfxfont.h>
 
#include "cdc_views/LayoutConstants.h"
 
class Adafruit_GFX;
class Gdey029T94;
 
namespace cdc::ui::render {
 
// Backwards-compatible aliases for the shared layout constants.
// Prefer the canonical names in cdc::ui::layout for new code.
constexpr int FOOTER_HEIGHT = cdc::ui::layout::FOOTER_HEIGHT;
constexpr int SCROLL_INDICATOR_WIDTH = cdc::ui::layout::SCROLL_INDICATOR_WIDTH;
 
void drawHeaderLeft(Gdey029T94* gfx, const char* title, int x, int y,
                    uint16_t width, int underlineOffset = 18);
void drawHeaderCentered(Gdey029T94* gfx, const char* title, int y, uint16_t width);
 
void drawFooterBar(Gdey029T94* gfx, uint16_t width, uint16_t height,
                   const char* prefix, const char* hint, bool force = false);
 
void drawScrollIndicator(Gdey029T94* gfx, int x, int y, int listHeight,
                         uint16_t totalItems, uint16_t visibleItems,
                         uint16_t scrollPos);
 
void drawDialogFrame(Gdey029T94* gfx, int x, int y, int w, int h);

void printTruncated(Adafruit_GFX* gfx, const char* text, int maxWidthPx);

uint8_t cp437ToLatin1(uint8_t c);

void utf8ToCp437Inplace(char* buf);

enum class DisplayTarget : uint8_t {
    Cp437  = 0,  
    Latin1 = 1,  
};

void decodeWebText(const char* in, char* out, size_t out_size,
                   DisplayTarget target = DisplayTarget::Cp437);

void drawCp437Text(Adafruit_GFX* gfx, const char* text);

void drawText(Adafruit_GFX* gfx, const char* text, const GFXfont* font);

void printText(Adafruit_GFX* gfx, const char* text);

void measureText(Adafruit_GFX* gfx, const char* text, const GFXfont* font,
                 int16_t x0, int16_t y0, int16_t* x1, int16_t* y1,
                 uint16_t* w, uint16_t* h);

const GFXfont* pickFontThatFits(Adafruit_GFX* gfx,
                                const char* text,
                                int maxWidthPx,
                                const GFXfont* const* candidates,
                                size_t count,
                                bool cp437 = false);

void measureCp437Text(Adafruit_GFX* gfx, const char* text, int16_t x0, int16_t y0,
                      int16_t* x1, int16_t* y1, uint16_t* w, uint16_t* h);

bool ditherOn(int16_t x, int16_t y, uint8_t shade);

void fillRectDither(Adafruit_GFX* gfx, int16_t x, int16_t y, int16_t w, int16_t h,
                    uint8_t shade, uint16_t color);

void fillCircleDither(Adafruit_GFX* gfx, int16_t cx, int16_t cy, int16_t r,
                      uint8_t shade, uint16_t color);

void fillTriangleDither(Adafruit_GFX* gfx, int16_t x0, int16_t y0, int16_t x1, int16_t y1,
                        int16_t x2, int16_t y2, uint8_t shade, uint16_t color);

struct BlitOpts {
    const uint8_t* mask = nullptr;  
    bool     opaque  = false;  
    bool     flipH   = false;
    bool     flipV   = false;
    bool     rot90   = false;  
    uint8_t  scale   = 1;      
    uint16_t srcX    = 0;      
    uint16_t srcW    = 0;      
    uint16_t srcSpan = 0;      
};

void drawBitmapMasked(Adafruit_GFX* gfx, int16_t x, int16_t y,
                      const uint8_t* data, int16_t w, int16_t h,
                      const BlitOpts& opts, uint16_t fg, uint16_t bg);
 
} // namespace cdc::ui::render