imajviewer/docs/rapor-downsampling-swap.md

Durum Raporu: Downsampling + Full-Res Swap + RAM Leak Fix

Tarih: 2026-08-14 Branch: main

Yapılan Değişiklikler

Tek dosya: lib/widgets/image_canvas.dart

1. Downsampling (ilk yüklemede RAM tasarrufu)

• _downsampleTarget = 2048 sabiti eklendi.
• _buildImage() artık ilk yüklemede ResizeImage.resizeIfNeeded(2048, null, ...) kullanıyor. Büyük resimler (ör. 12000px) 2048px'e küçültülerek decode ediliyor.
• Önceki davranış: resim her zaman tam çözünürlükte decode ediliyordu (cacheWidth = longest * _sc * 2), bu da dev resimlerde RAM'i dolduruyordu.

2. Full-Res Swap (zoom'da kalite)

• _checkFullResSwap(): downsampled resmin viewport'a oranı (stretch) 1.5x'i geçince _usingFullRes = true yapılıyor ve doğrudan FileImage (tam çözünürlük) kullanılıyor.
• _handleScroll() içinde _sc güncellendikten sonra çağrılıyor.
• Sonuç: küçük görünümde 2048px (RAM ~1.6MB), zoom ile yakınlaşınca orijinal.

3. RAM Leak Fix (resim geçişlerinde sızıntı)

• didUpdateWidget() içinde old.filePath != widget.filePath kontrolü:
  • _cachedFileImage?.evict(), _cachedProvider?.evict()
  • PaintingBinding.instance.imageCache.evict(FileImage(File(old.filePath)))
  • Tüm cache alanları null'a çekiliyor.
• Önceki davranış: her yüklenen resim Flutter'ın global ImageCache'inde birikiyor, RAM sürekli artıyordu.

4. Görüntü boyutu takibi

• _imageSize, loadingBuilder + ImageStreamListener ile decode edilen gerçek piksel boyutundan dolduruluyor. _checkFullResSwap() bu değeri stretch hesabında kullanıyor.

Temizlik

• Tiled render kodunun tamamı kaldırıldı (Flutter codec API region decode desteklemiyor).
• dart:ui ve dart:typed_data import'ları gereksiz kalınca silindi.
• Kullanılmayan _uiImage, _fullResImage, _fullResLoading alanları kaldırıldı.

Doğrulama

• flutter analyze --no-pub: 0 error.
• flutter build linux --debug: başarılı.
• Kullanıcı testi: onaylandı ("herşey tamam gözüküyor").

Açık Konular / Sonraki Adımlar

• _downsampleTarget ve swap threshold (1.5x) değerleri tune edilebilir.
• LOD (progressive loading) seviyeleri — şimdilik tek kademe (2048 → full) yeterli.
• Android/iOS hedeflerinde ResizeImage davranışı ayrıca test edilmeli.