imajviewer/docs/pencere-cascade-yerlesim.md

Pencere Cascade Yerleşimi Planı

Tarih: 2026-08-03 · Değerlendirme + implementasyon planı (henüz kod değişikliği yapılmadı)

1. Sorun

imajViewer'a yeni bir resim açıldığında pencere hep aynı koordinat ve boyutta açılıyor (önceki pencerenin üstüne biniyor). İstenen davranış:

• Yeni pencere, önceki pencerenin x + width kadar sağına açılsın (yan yana)
• Ekrandan taşacaksa alt satıra, satır başından (x baştan) açılsın

Bu, Windows'un klasik "cascade windows" davranışının basit hali.

2. Mevcut Durum Analizi

Pencere açılış akışı (lib/main.dart)

main(args)
  → WindowPersistence.restore()      // window.json'dan son konum/boyut
  → windowOptions = WindowOptions(size: saved ?? 1280x800)
  → waitUntilReadyToShow:
      saved varsa  → setPosition(saved.position) + setSize(saved.size)
      saved yoksa  → center()
  → runApp(ImajViewerApp(initialFiles: args))

Konum kaydetme akışı (lib/screens/viewer_screen.dart + lib/services/window_persistence.dart)

• _startPolling(): 2 saniyede bir windowManager.getBounds() → WindowPersistence.saveSync() → ~/.config/imajviewer/window.json (Linux) / %APPDATA%/imajviewer/window.json (Windows)
• onWindowEvent (move/resize/close) → debounce'lu _doSave()

Sorunun kökü

• Her yeni pencere window.json'daki son kaydedilen konumu okuyor → aynı yere açılıyor
• Cascade mantığı yok; ekran genişliği bilgisi hiç sorgulanmıyor

3. Teknik Araştırma (doğrulandı)

window_manager 0.4.3 (mevcut bağımlılık)

• setPosition, setSize, getBounds, getPosition, getSize, center() → var
• Ekran/display API'si → YOK (getScreen/getPrimaryDisplay yok)

window_manager 0.5.2 (güncel)

• Ekran API'si yine yok — screen_retriever'ı bağımlılık olarak içeriyor ama expose etmiyor

screen_retriever 0.2.2 (pub.dev, window_manager'ın zaten bağımlısı)

• ScreenRetriever.instance.getPrimaryDisplay() → Display
• getAllDisplays() → List<Display>
• Display alanları:
  • size (ekran tam boyutu, logical px)
  • visiblePosition (Offset — çalışma alanı başlangıcı)
  • visibleSize (Size — görev çubuğu hariç çalışma alanı)
  • scaleFactor
• Linux (X11) + Windows desteği var

Karar: screen_retriever doğrudan bağımlılık olarak eklenir (window_manager sürümü değişmez).

4. Önerilen Algoritma

main.dart'ta, windowOptions oluşturulmadan önce:

1. saved = WindowPersistence.restore()
2. display = await ScreenRetriever.instance.getPrimaryDisplay()
   workArea = display.visiblePosition + display.visibleSize  (yoksa display.size)
3. Eğer saved != null:
     newX = saved.x + saved.width        // önceki pencerenin sağına
     newY = saved.y

     // Yatay taşma → alt satıra, satır başına
     if (newX + pencereGenişliği > workArea.right):
         newX = workArea.left
         newY = saved.y + saved.height

     // Dikey taşma da varsa → en başa sar (0,0)
     if (newY + pencereYüksekliği > workArea.bottom):
         newX = workArea.left
         newY = workArea.top

     position = Offset(newX, newY)
4. saved yoksa → center() (mevcut davranış)

Örnek

• Ekran 1920×1080, pencere 1280×800, önceki pencere (100, 50)
• 1. yeni: (1380, 50) — yan yana ✓
• 2. yeni: (100+1280*2 = hesaplanır) → 1380+1280=2660 > 1920 → (0, 850) — alt satır başı ✓

Not: saved her 2 saniyede bir güncellendiği için "önceki pencere" = en son kaydedilmiş konum. Bu, en son açılan pencerenin konumu olur — istenen davranışla uyumlu.

5. Yapılacaklar (sıralı)

1. pubspec.yaml → screen_retriever: ^0.2.2 ekle, flutter pub get
2. lib/main.dart → cascade hesabı ekle (yeni bir servis fonksiyonuna taşınabilir)
3. lib/services/window_persistence.dart → restore() dışında, cascade hesabı için yardımcı fonksiyon:
   • static Future<Offset?> cascadePosition({required Size windowSize}) (opsiyonel, temizlik için)
4. Ekran boyutu alınamazsa (hata / çoklu monitör) → mevcut davranışa düş (saved veya center)
5. Test: ardışık 3-4 resim aç → yan yana dizilim + taşınca alt satır

6. Riskler / Açık Sorular

• Çoklu monitör: getPrimaryDisplay birincil ekranı verir. İmleç hangi ekrandaysa oraya açılsın mı? (başlangıç: primary)
• Pencere kapatılıp yenisi açılırsa: window.json son kapanan pencerenin konumunu tutar; yeni pencere onun yanına açılır — boşluk oluşabilir, kabul edilebilir
• Tam ekran / maximize durumu: saved boyut maximize ise cascade hesabı yine de eski boyutla yapılır; window.json sadece normal durumda yazıldığı için risk düşük
• Pencere ekrandan tamamen dışarıdaysa: restore() zaten x < -1000 || y < -1000 guard'ı var (window_persistence.dart:44) — yine de sağlamlaştırılabilir

7. Kabul Kriterleri

• Ardışık 2 pencere: ikincisi birincinin hemen sağında
• Yatay taşma: yeni pencere alt satıra, satır başından başlar
• İlk açılışta (kayıt yok) pencere yine ortalanır
• Pencere boyutu/konumu kaydetme davranışı bozulmaz
• Linux ve Windows'ta çalışır (screen_retriever her ikisini destekliyor)