fix: add guidance for bionic/guide dots during memory pressure

Author: uxjulia

CHANGELOG.md

@@ -19,6 +19,7 @@
 - EPUB layout now honors publisher page-break CSS, avoids stretching justified spaces before closing punctuation, and keeps large CSS rule sets in a smaller disk-backed lookup cache.
 - EPUB first-open conversion now uses more compact OPF manifest lookups and streams cover-wrapper parsing to avoid large temporary heap buffers on books with huge manifests.
 - EPUB chapters that run out of memory during full CrossInk layout now retry with `Balanced` and then `Light` rendering before showing a low-memory error, and save the first successful fallback for that book.
+- EPUB low-memory layout errors now suggest turning off Bionic Reading or Guide Dots when either reading aid is adding memory pressure.
 - EPUB next-chapter pre-indexing now uses the same render-mode fallbacks as visible chapter loading when layout runs low on memory.
 - EPUB reader font-size changes now restore the current chapter position by content instead of jumping far backward after re-indexing.
 - Reading Stats now use the reader's last live book time-left estimate instead of showing a separate fallback estimate.

lib/I18n/translations/english.yaml

@@ -587,6 +587,9 @@ STR_LOW_MEMORY_IMAGES_TITLE: "Chapter loaded without some or all images"
 STR_LOW_MEMORY_IMAGES_BODY: "Available memory was too low to extract every image for this chapter."
 STR_EPUB_LAYOUT_MEMORY_TITLE: "Chapter needs too much memory"
 STR_EPUB_LAYOUT_MEMORY_BODY: "This chapter needs more memory to lay out than this device can safely spare."
+STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_BOTH: "Try again with Bionic Reading and Guide Dots off."
+STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_BIONIC: "Try again with Bionic Reading off."
+STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_GUIDE: "Try again with Guide Dots off."
 STR_EPUB_FALLBACK_FONT_TITLE: "Chapter using built-in font"
 STR_EPUB_FALLBACK_FONT_BODY: "Available memory was too low to lay out this chapter with the SD-card font, so it was loaded with the built-in font."
 STR_SD_FIRMWARE_UPDATE: "SD Card Firmware Update"

src/activities/reader/EpubReaderActivity.cpp

@@ -3333,7 +3333,20 @@ void EpubReaderActivity::render(RenderLock&& lock) {
 
   const auto showLowMemoryLayoutError = [this]() {
     snprintf(APP_STATE.pendingAlertTitle, sizeof(APP_STATE.pendingAlertTitle), "%s", tr(STR_EPUB_LAYOUT_MEMORY_TITLE));
-    snprintf(APP_STATE.pendingAlertBody, sizeof(APP_STATE.pendingAlertBody), "%s", tr(STR_EPUB_LAYOUT_MEMORY_BODY));
+    const char* readingAidHint = nullptr;
+    if (SETTINGS.bionicReadingEnabled && SETTINGS.guideReadingEnabled) {
+      readingAidHint = tr(STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_BOTH);
+    } else if (SETTINGS.bionicReadingEnabled) {
+      readingAidHint = tr(STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_BIONIC);
+    } else if (SETTINGS.guideReadingEnabled) {
+      readingAidHint = tr(STR_EPUB_LAYOUT_MEMORY_READING_AIDS_HINT_GUIDE);
+    }
+    if (readingAidHint) {
+      snprintf(APP_STATE.pendingAlertBody, sizeof(APP_STATE.pendingAlertBody), "%s %s", tr(STR_EPUB_LAYOUT_MEMORY_BODY),
+               readingAidHint);
+    } else {
+      snprintf(APP_STATE.pendingAlertBody, sizeof(APP_STATE.pendingAlertBody), "%s", tr(STR_EPUB_LAYOUT_MEMORY_BODY));
+    }
     APP_STATE.pendingAlertGoHomeOnBack.store(true, std::memory_order_relaxed);
     APP_STATE.hasPendingAlert.store(true, std::memory_order_release);
     GUI.drawPopup(renderer, tr(STR_EPUB_LAYOUT_MEMORY_TITLE));