Bölüm 3 — Ayarlar

NEREDE

Ayarlar → General → Arayüz → Default Mode seçici. Bağlı:. Varsayılan: .simple.

TEKNİK

Uygulamanın bir sonraki başlatmada iki UI modundan hangisinde açılacağını kontrol eder. „Simple Mode", 4 adımdaki rehberli sihirbaz iş akışıdır (İçe aktarma → İşleme → Önizleme → Dışa aktarma, Bölüm 10'da Z1–Z4 olarak belgelenmiştir), „Expert Mode" ise Bölüm 2'deki Navigator, 3D görüntüleyici ve Expert Inspector ile klasik üç panel düzenidir. Değer yeniden başlatmalar arasında hatırlanır. Mode → Simple Mode (⌘1) / Mode → Expert Mode (⌘2) menüsüyle aynı etkiyi yapar; sadece menü çalışan oturumu değiştirirken bu seçici gelecekteki oturumlar için varsayılanı belirler. Her iki mod da aynı proje durumuna erişir — projeler, kameralar ve eğitim yapılandırması mod değişiminde korunur. Moda özel araç çubuğu düğmeleri hemen yeniden çizilir.

NEREDE

Ayarlar → General → Arayüz → Dil seçici. Bağlı:. Varsayılan: .system (macOS dilini izler).

TEKNİK

Uygulama UI'ının tamamının görüntü dilini, macOS sistem dilinden bağımsız olarak seçer. RadianceKit 17 dile yerelleştirilmiştir (de, en, pl, en-AU, ar-SA, artı 12 dil daha). „System" seçildiğinde uygulama macOS dilini izler. Açıkça bir seçim yapıldığında dil ayarı yeniden başlatmalar arasında hatırlanır; tam etki genellikle uygulamanın yeniden başlatılmasını gerektirir, çünkü yerelleştirme paketleri yalnızca başlangıçta yüklenir. Projede belgelenen 298 yerelleştirme anahtarının tümü, alt görünümlerdeki ve yardım ipuçlarındaki tüm metinler dahil olmak üzere dikkate alınır.

NEREDE

Ayarlar → General → Görüntüleyici → Arka plan seçici. Bağlı:. Varsayılan: .darkGray (RGB 0.1, 0.1, 0.1).

TEKNİK

3D görüntüleyici için standart arka plan rengini ayarlar. Üç seçenek: „Dark Gray" (RGB 0.1, 0.1, 0.1 — varsayılan), „Black" (0, 0, 0) ve „White" (1, 1, 1). Ayar, yeni projeler ve oturumlar için varsayılanı yeniden başlatmalar arasında kalıcı kılar ve aynı zamanda çalışan Metal render'cısını hemen günceller. Aynı seçenekler Viewport → Background menüsünde de bulunur (M21, M22, M23), ancak Ayarlar seçicisi varsayılanı belirlerken menü çalışan görüntüyü değiştirir. Ekran görüntüleri ve demo videoları için önemli: beyaz arka planlar yeşil/mavi floater'ları daha güçlü vurgular, koyu arka planlar temiz render çekimleri için daha iyidir.

NEREDE

Ayarlar → General → Görüntüleyici → „Auto-Rotate After Training" anahtarı. Bağlı:. Varsayılan: false.

TEKNİK

Eğitim biter bitmez görüntüleyici kamerasının sahne ağırlık merkezi etrafında sürekli bir turntable dönüşünü başlatır (standart dönüş hızı ~0.3 rad/sn). Demo oturumları, A/B karşılaştırmaları ve 360° görünümden „floater"ların sahne kenarında oluşup oluşmadığını doğrudan değerlendirmek için pratiktir. Görsel olarak Viewport → Toggle Auto-Rotation menüsüyle (M16, ⌘⌥T) aynı etkidir, sadece buradaki anahtar davranışı manuel olarak değil, eğitim bittiğinde otomatik olarak tetikler. Daha sonra istediğin zaman menü üzerinden veya görüntüleyiciye tıklayarak (bu dönüşü duraklatır) durdurabilirsin. Eğitim performansına etkisi yoktur — döndürme yalnızca eğitim bittiğinde başlar.

NEREDE

Ayarlar → General → Eğitim → Live Preview seçici. Bağlı: AppState.trainingConfig.livePreviewInterval. Varsayılan: 0 (Kapalı).

TEKNİK

Çalışan eğitim anlık görüntüsünün hangi iterasyon aralığında 3D görüntüleyiciye render edileceğini belirler. Dört ayrık değer: 0 („Off"), 50, 250, 1000 iterasyon. Canlı Önizleme etkinken eğitici, Gaussian buffer'ını GPU'dan ayrı bir render buffer'a kopyalar ve bir görüntüleyici yeniden çizimini tetikler. „Off"ta görüntüleyici yalnızca eğitim bittikten sonra güncellenir. Performans maliyeti: her 50 iterasyonda M3 Ultra'da ~%5–10 daha yavaş, her 250 iterasyonda ~%1–2 daha yavaş, her 1000 iterasyonda ölçülemez. Anlık görüntü buffer'ı için bellek ek yükü sabit ~2 GB, aralıktan bağımsız. Değer yeni eğitimler için varsayılan görevi görür; eğitim başladıktan sonra Eğitim Inspector'ı bu eğitimin gerçek canlı değerini gösterir. Aralık 50'de görsel izlenim nokta bulutunun akıcı bir „büyümesi"dir, 1000'de takılır.

NEREDE

Ayarlar → General → Eğitim → Throttle seçici. Bağlı: AppState.trainingConfig.throttleDelayMs. Varsayılan: 0 (Kapalı).

TEKNİK

Eğitim iterasyonları arasına milisaniye cinsinden yapay bir gecikme ekler. Dört ayrık değer: 0 („Off"), 2 („Light"), 5 („Moderate"), 10 („Eco"). Anlam: uzun eğitimlerde (birkaç saat) GPU aksi takdirde %100 kullanılır; bu da fark edilir derecede yavaş sistem UI'sına neden olur (fare imleci takılır, diğer uygulamalar ağırlaşır). Throttle gecikmesi GPU'ya diğer görevlerin çalıştırılabileceği duraklar verir. Performans maliyetleri ciddidir: 5 ms throttle'da tipik bir 40K eğitim, throttle olmadan göre yaklaşık %50–80 daha uzun sürer. „Eco" performans modunda (10 ms) iterasyon başına gecikme iterasyondan daha uzundur — 2–3× daha yavaş faktör. Throttle etkinken seçicinin altında bir uyarı görünür: „Throttle is on. Training will be slower than usual." Uygulamanın kendisi fark edilir biçimde daha iyi tepki vermez — yalnızca diğer uygulamalar yararlanır.

NEREDE

Ayarlar → General → Deneysel — Outdoor Floater Azaltma → „Sky Masking" anahtarı. Bağlı: AppState.trainingConfig.skyMaskingEnabled. Varsayılan: false.

TEKNİK

Eğitim öncesi Apple Vision tabanlı gök piksel segmentasyonunu etkinleştirir. Eğitim başlangıcından önce her girdi kamerası için gök bölgesi Apple Vision foreground maskesiyle çıkarılır (Gök = Arka plan) ve ilgili kameraya piksel başına maske olarak atanır. Eğitim sırasında piksel başına kayıp katkısı gök maskesinin tümleyeniyle çarpılır — gök pikselleri gradyana 0 katkı sağlar; böylece göğe projekte olan Gaussian'lar optimizasyon sinyali almaz ve „daha yoğun" ya da „daha parlak" olmaz. Dış mekân/dron sahnelerinde floater'ları (gökte koyu yumakçıklar) önemli ölçüde azaltır. Klasik 40K eğitiminde ~%3 L1 gerilemesine mal olur (bkz. memory/dev_outdoor-floater-reduction.md). Yalnızca açıkça tanınabilen gökle dış mekân sahnelerinde anlamlıdır; iç mekân sahnelerinde veya beyaz arka planda gök segmentasyonu yanlış alanları tanımlar ve geçerli kayıp sinyallerini engeller. Diğer deneysel anahtarların aksine değer uygulama yeniden başlatmalarında hatırlanmaz — bir sonraki uygulama başlatmasında yeniden kapalıdır.

NEREDE

Ayarlar → General → Deneysel — Outdoor Floater Azaltma → „Mid-Training Floater Cleanup" anahtarı. Bağlı:. Varsayılan: false.

TEKNİK

Classic-40K eğitimde („P4 Quality" önayarı) iki ek yoğunluk kontrol geçişi açar: iterasyon 20,000'de ve iterasyon 30,000'de. Her iki geçiş de tüm Gaussian'ları üç kriter için tarar: (a) çok düşük opaklık (standart 0.005), (b) küçücük ekran uzayı boyutu, (c) son 1000 iterasyonda kayıp katkısının olmaması. Üç koşulun tamamını sağlayan Gaussian'lar budanır. Etki: eğitim sonunda ~%5–15 daha az Gaussian, dron/dış mekân sahnelerinde gökte gözle görülür biçimde daha az koyu yumakçık. Yakın çekim iç mekân sahnelerinde ~%1–3 L1 gerilemesine mal olur, bu yüzden varsayılan olarak etkin değildir. Değer yeniden başlatmalar arasında hatırlanır (S7'nin aksine). İki temizlik iterasyonu (20K, 30K) sabit tanımlıdır ve şu anda UI üzerinden değiştirilemez; daha kısa eğitimlerde (ör. P2 Preview 5K) anahtarın etkisi yoktur, çünkü iterasyon işaretlerine asla ulaşmaz. Detaylar: memory/dev_outdoor-floater-reduction.md.

NEREDE

Ayarlar → General → Deneysel — Outdoor Floater Azaltma → „Reduce Elongated Gaussians" anahtarı. Bağlı:. Varsayılan: false.

TEKNİK

Kayıp teriminde ek bir anizotropi regularizasyonunu etkinleştirir. Optimizasyon sırasında her Gaussian için anizotropi en büyük ile en küçük ölçek ekseni arasındaki oran olarak hesaplanır. Oran bir eşiği aşıyorsa (, standart 10.0), aşımla orantılı olarak ölçeklenen bir ceza terimi kayıba eklenir. Etki: çim ve yoğun yapraklardaki çapraz tarama ve şerit eserlerine tipik iğne biçimli Gaussian'lar eğitim sırasında ya daha yuvarlak biçimlere zorlanır ya da budanır. Karşılığında standart iç mekân sahnelerinde ~%6 L1 gerilemesi, sıkı nesne yakalamalarında etkisi yoktur. Sweet spot bitki örtüsü üzerindeki dron uçuş çekimlerindedir. Yazar, ile kalıcı kılar. Uygulama, gradyan hesaplamasında ek bir ceza olarak optimizer.metal içindedir. Proje belleğindeki uyarıya bak: V549d gönderilen sürümdü, daha agresif Scale-Reg ile sonraki V549f catastrophic regression nedeniyle geri çekildi. Detaylar: memory/dev_outdoor-floater-reduction.md ve memory/dev_v549f-needle-reduction.md.

NEREDE

Ayarlar → General → Deneysel — Outdoor Floater Azaltma → „Reconstruct Sky Dome" anahtarı. Bağlı:. Varsayılan: false.

TEKNİK

Eğitim öncesi Sky-Dome projeksiyonunu etkinleştirir (V549e MVP). SfM'den sonra ve eğitim başlangıcından önce her girdi kamerası için S7 ile paylaşılan Apple Vision gök maskesi görüntüden çıkarılır, gök pikselleri kamera intrinsikleriyle sanal bir küre yüzeyine ters projeksiyonlanır (standart yarıçap 8× sahne yarıçapı). Bu küre üzerinde projekte edilen gök piksellerinden gelen renk ortalamaları, çok büyük ölçeklendirme (sahne birimlerinde 1.0) ve başlangıç opaklığı 0.95 ile ~5000 yeni Gaussian başlatılır. Bu 5000 Gaussian klasik anlamda bir gök maskesi değildir — diğerleri gibi eğitilirler, ama yüksek başlangıç opaklığıyla ince bir kabukta bırakılırlar. Sonuç: dış mekân/dron sahnelerinde 360° novel görünümlerde koyu konfeti yumakçıkları yerine gerçek gök rengi ve bulut yapıları görünür. Değer yeniden başlatmalar arasında hatırlanır. Yalnızca en azından 360° kamera kapsamı olan dış mekân sahnelerinde anlamlıdır; gök görünümü olmayan saf nesne yakalamalarında etkisi yoktur. Durum: deneysel, daha geniş A/B doğrulaması ek dış mekân setlerinde bekliyor.

NEREDE

Ayarlar → AI Helpers → ilk bölüm → „AI Helpers enabled" anahtarı. Bağlı:. Varsayılan: true.

TEKNİK

Pipeline'daki tüm AI Helpers özelliklerinin üzerinde ana anahtar. Kapalıyken içe aktarma ve SfM pipeline'ı tüm ML tabanlı ön işleme aşamalarını tamamen atlar — Apple Vision çağrısı yok, CoreML model yüklemesi yok, NPU uyandırması yok. Açıkken bireysel alt anahtarlar (S12–S14) danışılır. Değer yeniden başlatmalar arasında hatırlanır. Şu aşamaları etkiler: (a) SfM'den önce kare kalitesi ön kontrolü (S12), (b) loop closure tespiti (S13), (c) yeni eğitimler için varsayılan değer olarak otomatik gök maskeleme (S14). Önemli: kapalıyken üç alt anahtar devre dışıdır ve görsel olarak griye alınır. Alt bilgi notu, tüm AI Helpers'ın kesinlikle cihaz üzerinde çalıştığını vurgular — görüntü yüklemesi yok, bulut işleme yok. Veri gizliliği garantisi, yalnızca Apple Vision çatısının (Neural Engine üzerinde yerel olarak) ve doğrudan uygulama paketinde bulunan CoreML modellerinin kullanılmasından gelir.

NEREDE

Ayarlar → AI Helpers → Mevcut bölüm → „Frame quality check" anahtarı. Bağlı:. Varsayılan: true.

TEKNİK

SfM çağrısından önce her içe aktarılan kareyi analiz eden Kare Kalitesi Tarayıcısını etkinleştirir (Faz 3.11). Kare başına pipeline adımları: (a) Apple Vision'dan Laplacian Variance filtresi (bulanıklık tespiti — eşik ~150), (b) histogram tabanlı aşırı/yetersiz pozlama kontrolü (eşik: 0 veya 255'te >%5 piksel), (c) Boş kare algılaması (tüm piksellerde standart sapma < 5). Üç kontrolden de geçen kareler doğrudan geçer. En az bir kontrolde başarısız olan kareler, her sorunlu kareyi küçük resim ve gerekçeyle listeleyen ve silinip silinmemesi gerektiğini soran modal bir onay diyaloğunu tetikler. Önemli: otomatik silme yok — diyalog her zaman gereklidir, son kararı kullanıcı verir. Performans: M3 Ultra'da kare başına ~50 ms, paralel çalışır. Kapalıyken tüm kareler kontrol edilmeden SfM'ye iletilir. Ana (S11) devre dışıyken bu anahtar görsel olarak griye alınır ve etkisizdir. Bellek durumuna göre gönderim durumu: SHIPPED 2026-05-23.

NEREDE

Ayarlar → AI Helpers → Mevcut bölüm → „Loop closure detection" anahtarı. Bağlı:. Varsayılan: true.

TEKNİK

Apple Vision Feature-Print tabanlı loop closure algılamasını etkinleştirir. İçe aktarılan her kare için, görüntü içeriğinin nöral bir embedding'ini temsil eden ~768 boyutlu bir özellik vektörü hesaplanır. Ardından tüm Feature-Print'ler çiftler halinde cosine benzerliğiyle karşılaştırılır. Benzerliği > 0.85 ve kare endeksinde mesafesi > 50 (yani komşu olmayan kareler) çiftler „loop closure adayları" olarak tanımlanır ve proje klasöründeki bir sidecar JSONL dosyasına yazılır. Yalnızca bilgilendirici — içe aktarılan görüntü dizisi değiştirilmez. Anlam: SfM çözücüsüne (özellikle COLMAP) bu karelerin 3D uzayda birlikte gruplandığı ipucunu verir. Yerel SfM için sidecar bilgisi şu anda yalnızca belgeleyicidir; COLMAP ipuçlarını özel matches dosyası üzerinden dahili olarak kullanır (manuel entegrasyon mümkün, otomatik bağlı değildir). Performans: M3 Ultra'da kare başına ~200 ms, paralel çalışır. Kapalıyken Feature-Print üretilmez. Ana (S11) devre dışıyken görsel olarak griye alınır.

NEREDE

Ayarlar → AI Helpers → Mevcut bölüm → „Auto sky masking" anahtarı. Bağlı: UserDefaults.standard.bool(forKey: "aiHelpersSkyMaskingDefault") (Özel bağlama ile). Varsayılan: false.

TEKNİK

Yeni eğitim yapılandırmalarında S7'deki gök maskeleme ayarı için varsayılan değeri ayarlar. S11–S13'ün aksine asıl gök maskeleme ayarı eğitim oturumuna göre yaşar ve uygulama yeniden başlatmaları arasında hatırlanmaz (bkz. S7). AI Helpers UI'sı yine de „yeni eğitimler" için kalıcı bir varsayılan sunabilsin diye bu gölge değer vardır: yeniden başlatmalar arasında hatırlanır ve yeni bir eğitim kurulumunda (ör. yeni proje içe aktarma) gök maskeleme için başlangıç varsayılanı olarak alınır. Ana (S11) devre dışıyken görsel olarak griye alınır.