feat: klasor tabanli galeri, brightness efekti (Ctrl+Shift+sag tik), .deb guncellendi

docs/rapor-brightness.md

@@ -0,0 +1,62 @@
+# Rapor: Brightness Efekti + Sağ Tık Etkileşim Düzeni
+
+Tarih: 2026-08-03
+Durum: Rapor — uygulama için onay bekleniyor
+
+## 1. Gönderilen Araştırmanın Özeti
+
+- `ColorMatrixHelper`: Rec.709 luma katsayıları (0.2126 / 0.7152 / 0.0722) — projedekiyle aynı.
+- Üç ayrı 4x5 renk matrisi:
+  - **Brightness:** RGB'ye offset ekler (`b` → -255..255)
+  - **Contrast:** `c` ile çarpar + `128*(1-c)` offset (0..2 arası, 1.0 orijinal)
+  - **Saturation:** Rec.709 ağırlıklı karışım (0..2 arası, 1.0 orijinal)
+- Birleştirme: `M_final = M_contrast * M_brightness * M_saturation` — genel 4x5 matris
+  çarpımı; uygulama sırası saturation → brightness → contrast.
+- Uygulama: `ColorFiltered` + `ColorFilter.matrix` ile GPU shader'ı — projedekiyle aynı mekanizma.
+- Örnek widget (`ImageAdjusterWidget`) **slider tabanlı**; bizim uygulama jest tabanlı
+  olduğu için bu kısım direkt uygulanmayacak. Asıl değer matris hesabında.
+
+## 2. Projedeki Mevcut Durum — `lib/widgets/image_canvas.dart`
+
+- State: `_contrast` (1.0), `_saturation` (1.0) — brightness yok.
+- `_buildCombinedFilter()`: saturation × contrast tek matriste elle birleştiriliyor
+  (contrast offset: `t = (1-c)/2` → 255 ölçeğinde 127.5*(1-c)).
+- Cache: `_cachedFilter` + `_cachedSat` / `_cachedCon`.
+- Etkileşim: sağ tık = contrast, Ctrl+sağ tık = saturation, Shift+sağ tık = rotate,
+  sağ çift tık = reset (tüm efektler).
+- Modifier takibi: `_onHardwareKey` yalnızca ctrl ve shift'i izliyor.
+
+## 3. Karşılaştırma — Araştırma vs Mevcut Kod
+
+| Konu | Mevcut | Araştırma | Fark |
+|---|---|---|---|
+| Saturation matrisi | Rec.709, aynı formül | Rec.709, aynı formül | Matematik birebir aynı |
+| Contrast offset | 127.5*(1-c) | 128*(1-c) | ~%0.4, görsel fark yok |
+| Brightness | yok | `b` offset matrisi | **Eklenecek** |
+| Birleştirme | elle 2 matris | genel 4x5 çarpım | 3 efekt için genel çarpım daha temiz |
+| Arayüz | jest (sağ tık + sürükle) | slider | Widget değil, matris katmanı alınacak |
+
+## 4. Uygulama Planı
+
+1. `_brightness` state ekle (varsayılan 0.0, aralık -100..100).
+2. `_onPointerDown`: öncelik sırası — **Ctrl+Shift → brightness**, Ctrl → saturation,
+   Shift → rotate, yoksa contrast. (Başlangıçta Alt denenmişti; XFCE Alt+klik'i
+   pencere hareketine kaptığı için **Ctrl+Shift**'e geçildi.)
+3. `_onPointerMove`: brightness modunda `_brightness = _startBrightness + dy * 0.5`
+   (clamp -100..100; hassasiyet açık soru).
+4. `_buildCombinedFilter`: araştırmadaki 4x5 çarpım mantığıyla 3 efekt birleştir
+   (saturation → brightness → contrast); cache anahtarına `_brightness` ekle.
+5. Reset (sağ çift tık), `_resetView`, `_toggleFillFit`: brightness 0'a döner.
+6. `hasFilter` koşuluna `_brightness != 0` eklenir (ColorFiltered yalnızca gerektiğinde).
+
+## 5. Dikkat Edilecekler
+
+- **Linux/XFCE:** Alt+klik WM tarafından pencere hareketine kaptırıldığı için
+  brightness **Ctrl+Shift+sağ tık**'a alındı (Alt kaldırıldı).
+- **Uygulama sırası:** saturation → brightness → contrast sabit kalacak; farklı sıra farklı sonuç verir.
+- Reset davranışı brightness'i de kapsar.
+
+## 6. Açık Sorular
+
+1. Brightness hassasiyeti: `dy * 0.5`, aralık -100..100 uygun mu?
+2. Rotate Shift+sağ tık'ta kalıyor (değişiklik yok) — onay?