mangayomi-mirror/lib/modules/library/widgets
Mehakdeep Singh 861ee65113 perf(library): decode covers at thumbnail resolution to cut image-cache RAM
Refs #609 (high RAM with stutters).

Manga / anime covers from sources are typically 720x1080 or larger
(~3 MB decoded RGBA per cover). The library grid, library list and
generic browse / search card widgets render those covers at roughly
150x220 logical pixels, but every cover decoded to its full source
resolution and that decoded bitmap landed in Flutter's `imageCache`.
With 30-50 covers in flight during a normal scroll, the default
100 MB cache filled and the engine started evicting + re-decoding
aggressively — exactly the symptom in #609 (stutters + high RAM).

Mangayomi already had `ExtendedResizeImage` available via the
`extended_image_library` package and used it in one place
(`cachedCompressedNetworkImage`, called only from the History
screen). This commit generalises that pattern.

Add a `coverProvider()` helper in `lib/utils/cached_network.dart`
that wraps `CustomExtendedNetworkImageProvider` in
`ExtendedResizeImage` with a 200 KB encoded budget — sharp at
typical thumbnail size on high-DPR screens, ~3.6x smaller decoded
than a full-resolution cover. Pass through the same `cache` /
`cacheMaxAge` knobs the underlying provider exposes so existing
disk-cache behaviour is preserved.

Swap the three high-traffic thumbnail call sites to use it:

* `lib/modules/library/widgets/library_gridview_widget.dart`
* `lib/modules/library/widgets/library_listview_widget.dart`
* `lib/modules/widgets/manga_image_card_widget.dart`
  (both `MangaImageCardWidget` and `MangaImageCardListTileWidget`,
  used by browse and search results)

Deliberately not changed:

* The manga / anime detail page hero cover — large display, full
  resolution is appropriate.
* Reader pages — already memory-managed by `ChapterPreloadManager`
  and need full resolution for actual reading.
* `cachedNetworkImage()` and other lower-traffic thumbnail surfaces
  (tracker results, calendar, recommendation grid). Easy to extend
  in a follow-up if anyone asks; kept narrow here so review is
  manageable.

Verified

* `flutter analyze` clean on every touched file
* `flutter build macos --release` succeeds
* Smoke-tested on macOS with the local-all-fixes build: library
  grid, library list and browse card all render identical-looking
  covers at typical thumbnail sizes; no visible quality regression
  at the displayed scale
2026-05-09 23:37:44 -07:00
..
continue_reader_button.dart rename files manga.dart and chapter.dart 2026-04-23 18:53:25 +02:00
library_app_bar.dart Reduce Code Duplication by Adding Platform Helper 2026-04-26 19:39:14 +02:00
library_body.dart feat: Implement app lock feature with biometric authentication 2026-03-04 11:56:49 +01:00
library_dialogs.dart Change the MangasListStateProvider to Set<int> 2026-04-12 23:03:18 +02:00
library_gridview_widget.dart perf(library): decode covers at thumbnail resolution to cut image-cache RAM 2026-05-09 23:37:44 -07:00
library_listview_widget.dart perf(library): decode covers at thumbnail resolution to cut image-cache RAM 2026-05-09 23:37:44 -07:00
library_settings_sheet.dart feat: Implement app lock feature with biometric authentication 2026-03-04 11:56:49 +01:00
list_tile_manga_category.dart dart format 2025-05-30 17:43:42 +01:00
search_text_form_field.dart Don't focus searchbar when migrating 2025-07-12 20:26:31 +02:00