mirror of
https://github.com/daveallie/crosspoint-reader.git
synced 2026-02-06 23:57:39 +03:00
68ce6db291
Allow users to select custom fonts (.epdfont files) from the /.crosspoint/fonts/ directory on the SD card for EPUB/TXT reading. Features: - New FontSelectionActivity for browsing and selecting fonts - SdFont and SdFontFamily classes for loading fonts from SD card - Dynamic font reloading without device reboot - Reader cache invalidation when font changes - Hash-based font ID generation for proper cache management The custom fonts use the .epdfont binary format which supports: - 2-bit antialiasing for smooth text rendering - Efficient on-demand glyph loading with LRU cache - Memory-optimized design for ESP32-C3 constraints
116 lines
4.0 KiB
C++
116 lines
4.0 KiB
C++
#pragma once
|
|
|
|
#include "EpdFontFamily.h"
|
|
#include "SdFont.h"
|
|
|
|
/**
|
|
* SD Card font family - similar interface to EpdFontFamily but uses SdFont.
|
|
* Supports regular, bold, italic, and bold-italic variants.
|
|
*/
|
|
class SdFontFamily {
|
|
private:
|
|
SdFont* regular;
|
|
SdFont* bold;
|
|
SdFont* italic;
|
|
SdFont* boldItalic;
|
|
bool ownsPointers;
|
|
|
|
SdFont* getFont(EpdFontStyle style) const;
|
|
|
|
public:
|
|
// Constructor with raw pointers (does not take ownership)
|
|
explicit SdFontFamily(SdFont* regular, SdFont* bold = nullptr, SdFont* italic = nullptr, SdFont* boldItalic = nullptr)
|
|
: regular(regular), bold(bold), italic(italic), boldItalic(boldItalic), ownsPointers(false) {}
|
|
|
|
// Constructor with file paths (creates and owns SdFont objects)
|
|
explicit SdFontFamily(const char* regularPath, const char* boldPath = nullptr, const char* italicPath = nullptr,
|
|
const char* boldItalicPath = nullptr);
|
|
|
|
~SdFontFamily();
|
|
|
|
// Disable copy
|
|
SdFontFamily(const SdFontFamily&) = delete;
|
|
SdFontFamily& operator=(const SdFontFamily&) = delete;
|
|
|
|
// Enable move
|
|
SdFontFamily(SdFontFamily&& other) noexcept;
|
|
SdFontFamily& operator=(SdFontFamily&& other) noexcept;
|
|
|
|
// Load all fonts in the family
|
|
bool load();
|
|
bool isLoaded() const;
|
|
|
|
// EpdFontFamily-compatible interface
|
|
void getTextDimensions(const char* string, int* w, int* h, EpdFontStyle style = REGULAR) const;
|
|
bool hasPrintableChars(const char* string, EpdFontStyle style = REGULAR) const;
|
|
|
|
// Get glyph (metadata only, no bitmap)
|
|
const EpdGlyph* getGlyph(uint32_t cp, EpdFontStyle style = REGULAR) const;
|
|
|
|
// Get glyph bitmap data (loaded on demand from SD)
|
|
const uint8_t* getGlyphBitmap(uint32_t cp, EpdFontStyle style = REGULAR) const;
|
|
|
|
// Font metadata
|
|
uint8_t getAdvanceY(EpdFontStyle style = REGULAR) const;
|
|
int8_t getAscender(EpdFontStyle style = REGULAR) const;
|
|
int8_t getDescender(EpdFontStyle style = REGULAR) const;
|
|
bool is2Bit(EpdFontStyle style = REGULAR) const;
|
|
|
|
// Check if bold variant is available
|
|
bool hasBold() const { return bold != nullptr; }
|
|
};
|
|
|
|
/**
|
|
* Unified font family that can hold either EpdFontFamily (flash) or SdFontFamily (SD card).
|
|
* This allows GfxRenderer to work with both types transparently.
|
|
*/
|
|
class UnifiedFontFamily {
|
|
public:
|
|
enum class Type { FLASH, SD };
|
|
|
|
private:
|
|
Type type;
|
|
const EpdFontFamily* flashFont; // Non-owning pointer for flash fonts (they're global)
|
|
SdFontFamily* sdFont; // Owned pointer for SD fonts
|
|
|
|
public:
|
|
// Construct from flash font (EpdFontFamily) - stores pointer, does not copy
|
|
explicit UnifiedFontFamily(const EpdFontFamily* font);
|
|
|
|
// Construct from SD font family (takes ownership)
|
|
explicit UnifiedFontFamily(SdFontFamily* font);
|
|
|
|
~UnifiedFontFamily();
|
|
|
|
// Disable copy
|
|
UnifiedFontFamily(const UnifiedFontFamily&) = delete;
|
|
UnifiedFontFamily& operator=(const UnifiedFontFamily&) = delete;
|
|
|
|
// Enable move
|
|
UnifiedFontFamily(UnifiedFontFamily&& other) noexcept;
|
|
UnifiedFontFamily& operator=(UnifiedFontFamily&& other) noexcept;
|
|
|
|
Type getType() const { return type; }
|
|
bool isSdFont() const { return type == Type::SD; }
|
|
|
|
// Unified interface
|
|
void getTextDimensions(const char* string, int* w, int* h, EpdFontStyle style = REGULAR) const;
|
|
bool hasPrintableChars(const char* string, EpdFontStyle style = REGULAR) const;
|
|
const EpdGlyph* getGlyph(uint32_t cp, EpdFontStyle style = REGULAR) const;
|
|
|
|
// For SD fonts: get bitmap data (for flash fonts, use getData()->bitmap[offset])
|
|
const uint8_t* getGlyphBitmap(uint32_t cp, EpdFontStyle style = REGULAR) const;
|
|
|
|
// Metadata (common interface)
|
|
uint8_t getAdvanceY(EpdFontStyle style = REGULAR) const;
|
|
int8_t getAscender(EpdFontStyle style = REGULAR) const;
|
|
int8_t getDescender(EpdFontStyle style = REGULAR) const;
|
|
bool is2Bit(EpdFontStyle style = REGULAR) const;
|
|
|
|
// Flash font specific (returns nullptr for SD fonts)
|
|
const EpdFontData* getFlashData(EpdFontStyle style = REGULAR) const;
|
|
|
|
// Check if bold variant is available (for synthetic bold decision)
|
|
bool hasBold() const;
|
|
};
|