Bölüm 3 — Ayarlar

NEREDE

Settings → General → Interface → Default Mode seçici. Varsayılan: „Simple Mode".

TEKNİK

Uygulamanın bir sonraki başlangıçta hangi iki UI modundan açılacağını belirler. „Simple Mode", 4 adımlı yönlendirmeli sihirbaz iş akışıdır (Import → Processing → Preview → Export, Bölüm 10'da Z1–Z4 altında belgelenmiştir), „Expert Mode" ise Bölüm 2'den bilinen Navigator, 3D Viewport ve Expert Inspector'dan oluşan klasik üç panelli düzendir. Değer, yeniden başlatmalar arasında hatırlanır. Menüdeki Mode → Simple Mode (⌘1) / Mode → Expert Mode (⌘2) ile aynı etkiye sahiptir, tek fark menünün mevcut oturumu değiştirmesi, bu seçicinin ise gelecek oturumlar için varsayılanı belirlemesidir. Her iki mod da aynı proje durumuna erişir — proje, kameralar ve eğitim yapılandırması mod değişiminde korunur. Moda özgü araç çubuğu düğmeleri hemen yeniden render edilir.

NEREDE

Settings → General → Interface → „Pause after frame extraction (Expert)" anahtarı. Varsayılan: kapalı.

TEKNİK

Yalnızca Expert modunu ve orada da yalnızca video materyalini etkiler. Anahtar kapalıyken (varsayılan), büyük düğmenin adı „Start Processing"dir ve süreç tek seferde ilerler: videodan görüntüleri çıkar, görüntü kalitesini kontrol et, kameraları hizala, eğit. Açıkken aynı düğmenin adı „Extract Frames" olur ve süreç, tek tek görüntülerin çıkarılıp gözden geçirilmesinden sonra durur. Bu duraklamada, geri kalanı kendin başlatmadan önce Navigator'daki görüntü setini gözden geçirebilir, tek tek görüntüleri kaldırabilir ve eğitim ayarlarını değiştirebilirsin. Değer, yeniden başlatmalar arasında hatırlanır. Simple moduna ve zaten tekil görüntülerden oluşan içe aktarmalara bir etkisi yoktur — orada çıkarılacak bir şey yoktur.

NEREDE

Settings → General → Interface → „Show marker recipe suggestions" anahtarı. Varsayılan: açık.

TEKNİK

Uygulamanın bir içe aktarmadan sonra sessizce görüntülerinde AprilTag işaretleri araması ve gerekirse sana farklı bir SfM tarifi önermesine izin verir. Bu uyarı, Expert Inspector'da Cameras & Capture bölümünün üstünde bir banner olarak görünür ve tekrar eden işaretleri daha doğru kamera konumları için sabit çapa olarak kullanan Professional'a geçmeyi teklif eder. Yalnızca kullanılabilir olan sayılır: bir işaret kimliğinin en az üç görüntüde görünmesi gerekir, aksi halde kullanılabilir bir iz oluşturmaz ve sayılmaz — yani her biri yalnızca bir kez görünen birden çok farklı kimlik hiçbir şey tetiklemez. Uyarı ayrıca yalnızca native SfM gerçekten çalışıyorsa ve henüz daha üst düzey bir tarif ayarlanmamışsa görünür ve bir süreç başlar başlamaz kaybolur. Anahtar, banner'ın kendisindeki „Don't suggest again"in kalıcı biçimidir; oradaki bir tıklama burada onu kapatır. Tersine, burada tekrar açmak kesin bir yeniden başlangıç olarak kabul edilir: mevcut içe aktarma için kapatılmış bir uyarı bile yeniden kontrol edilir.

NEREDE

Settings → General → Interface → Language seçici. Varsayılan: „System Default" (macOS dilini takip eder).

TEKNİK

macOS sistem dilinden bağımsız olarak tüm uygulama arayüzünün görüntülenme dilini seçer. Seçici, „System Default" girdisini ve 18 sabit dili listeler: English, Deutsch, Français, Español, Português, Italiano, Nederlands, 日本語, 中文, 한국어, Svenska, Norsk, Dansk, Suomi, Polski, Čeština, Русский, Türkçe. „System Default" seçiliyken uygulama macOS dilini takip eder. Açık bir seçim yapıldığında dil ayarı yeniden başlatmalar arasında hatırlanır; tam etki genellikle bir uygulama yeniden başlatması gerektirir, çünkü yerelleştirme paketleri yalnızca başlangıçta yüklenir.

NEREDE

Settings → General → Viewport → Background seçici. Varsayılan: „Dark Gray" (RGB 0.1, 0.1, 0.1).

TEKNİK

3D viewport'un 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). Seçim, çalışan Metal renderer'a hemen etki eder ve kullanıcı varsayılanlarına kaydedilir, yani uygulama yeniden başlatmalarını atlatır. Üç kullanım yolu olan tam olarak tek bir ayar vardır: bu seçici, Viewport → Background menüsü (M21, M22, M23) ve viewport'taki B tuşu hepsi aynı setter üzerinden yazar — menü veya tuş üzerinden değiştiren biri, ardından yeni değeri burada Settings seçicisinde de görür. (v1.7'ye kadar uygulama seçimi hatırlamıyordu ve seçicideki „Default" kelimesi bu anlamda yanıltıcıydı; 2026-07-18'den beri üç yol birbiriyle örtüşüyor.) Bu değişikliğin bilinçli sonucu: beyaz bir arka plan, yeniden başlatmadan sonra da beyaz kalır ve dolayısıyla ekran görüntülerinde ve orbit video dışa aktarımlarında da öyle görünür. Çekimler için hâlâ geçerli olan: beyaz arka planlar yeşil/mavi floaterları daha belirgin gösterir, koyu arka planlar temiz render çekimleri için daha uygundur.

NEREDE

Settings → General → Viewport → „Selection color" renk seçici. Varsayılan: Kırmızı (RGB 1, 0, 0).

TEKNİK

Düzenleme modunda seçilen Gauss noktalarının hangi renk tonuyla boyanacağını belirler — yani fırça veya kesme düzlemi üzerinden şu anda işaretlediğin ve bir sonraki adımda silmek veya doyumsuzlaştırmak isteyeceğin şey. Seçici saydamlık tanımaz. Bir değişiklik hemen kullanıcı varsayılanlarına yazılır ve çalışan renderer'a iletilir, görünüm bir sonraki karede yeniden renklenir; bir yeniden başlatma gerekmez. Ton yalnızca görüntüleme amaçlıdır ve dışa aktarılan hiçbir dosyada yer almaz.

NEREDE

Settings → General → Viewport → „Cylinder color" renk seçici. Varsayılan: Camgöbeği (RGB 0.1, 0.9, 1.0).

TEKNİK

Silindir kırpmasının renk tonunu belirler — hem tel kafesi hem de silindirin çevrelediği içeriği. Dikkat, bu iki ton tam tersini ifade eder: seçim rengi (S39) neyin gideceğini işaretler, silindir rengi ise neyin kalacağını işaretler. Bu yüzden ayrı ayarlanabilirler ve fabrika ayarında belirgin şekilde farklıdırlar. S39 gibi saydamlık olmadan, anında etkili ve yalnızca görüntüleme amaçlıdır.

NEREDE

Settings → General → Viewport → „Invert vertical navigation" anahtarı. Varsayılan: kapalı.

TEKNİK

Viewport gezinmesinin yukarı/aşağı yönünü tersine çevirir. 2026-07-18'den beri kapsam: Kreisen (orbit), uçuş modundaki bakış ve kaydırma (pan) — ikincisi hem hareket hem de sağ fare düğmesiyle sürükleme yoluyla, ki önceden bu bayrağı hiç okumuyordu. Öncesinde anahtar yalnızca yarım etki gösteriyordu, onu açan biri iki hareketi birbirine karşı hareket ettiriyordu. Kaydırmada dikey fare hareketi doğası gereği kreisen'e göre ters işaret taşır, bu yüzden orada kreisen'den kopyalanmak yerine koşullu olarak çevrilir — anahtarı hiç dokunmayan biri bu düzeltmeden hiçbir şey fark etmez. Zoom bilinçli olarak hariç tutulmuştur: orada zaten sistemin kaydırma yönü işaret kararını taşır ve deltalar mesafe ile bakış açısını kontrol eder, dikey gezinmeyi değil.

NEREDE

Settings → General → Training → Live Preview seçici. Varsayılan: „Every 50 Iterations".

TEKNİK

Çalışan eğitim anlık görüntüsünün hangi iterasyon aralığında 3D viewport'a render edileceğini belirler. Dört ayrı değer: 0 („Off"), 50, 250, 1000 iterasyon. Live Preview etkinken eğitici, Gaussian buffer'ını GPU'dan ayrı bir render buffer'ına kopyalar ve bir viewport yeniden çizimini tetikler. „Off" durumunda viewport ancak eğitim tamamlandıktan 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. Bellek yükü, aralıktan bağımsız olarak anlık görüntü buffer'ı için sabit ~2 GB'dır. Geçerlilik alanı: değer uygulamaya aittir, sahneye değil. Teknik nedenlerle eğitim ayarlarıyla birlikte taşınır, ancak bir sahne dosyası açılırken, ön ayar değişirken ve otomatik 360° geçişinde açıkça korunur — önceden açılmış bir sahne kendi önizleme oranını sahne yazarının değeriyle üzerine yazıyordu, „Off" da dahil. Aynı nedenle tarif karşılaştırmasına dahil edilmez ve ön ayarda „Modified" rozetini tetiklemez. „Continue Training" da orijinal çalışmada geçerli olan değere değil mevcut değere göre hareket eder — bir devam işlemi o zamandan beri bir önizleme gösterir ve ara sırada kapatılmışsa bunu gözetir. Aynı zamanda bu pencerenin uygulama yeniden başlatmasını atlatmayan tek ayarıdır: buradaki diğer tüm girdilerin aksine hiçbir yerde kalıcı olarak saklanmaz, her başlangıç yeniden „Every 50 Iterations" ile başlar. Zaten çalışan bir eğitim oranını artık değiştirmez; bir değişiklik bir sonraki çalışmada devreye girer. 50 aralığında görsel izlenim nokta bulutunun akıcı bir „büyümesi"dir, 1000'de takılıyormuş gibi görünür.

NEREDE

Settings → General → Training → „Save a PLY automatically after each run" anahtarı. Varsayılan: açık.

TEKNİK

Her tamamlanan çalıştırmadan sonra — yeni çalıştırma ve devam — sonucu Exports klasörüne PLY olarak yazar (training_<zaman damgası>.ply). İşlevin kendisi v1.7.0'dan beri mevcuttu, ancak hiçbir gösterge veya anahtar olmadan çalışıyordu; 2026-07-18'den beri görünür ve kapatılabilir durumdadır. Kapatırken dikkat: otomatik yazma işlemi bir güvenlik ağıdır — o olmadan tamamlanmış bir çalıştırma, sen kendin dışa aktarana veya sahne olarak kaydedene kadar yalnızca bellekte bulunur. Açık bırakırken dikkat: detay bakımından zengin sahnelerde bir dosya ~2 GB'a ulaşır. Ayar hiç dokunulmamışsa „açık" geçerlidir: kullanıcı varsayılanlarında eksik bir değer açıkça „açık" olarak okunur, „kapalı" olarak değil — aksi halde her mevcut kullanıcı ağı sessizce kaybederdi. Hedef klasör, derlemeye bağlıdır: sandbox olmadan ~/Documents/RadianceKit/Exports, App Store sürümünde ise ~/Library/Containers/…/Documents/RadianceKit/Exports — bu yüzden yanındaki düğme (S37) vardır.

NEREDE

Settings → General → Training → „Show Exports Folder…" düğmesi. Yalnızca eylem, kaydedilmiş bir değer yok.

TEKNİK

S36'daki otomatik PLY'lerin yazıldığı klasörü Finder'da açar. Yol derlemeye göre farklılık gösterdiği ve dosyalar App Store sürümünde uygulamanın konteynerinde kimsenin bakmadığı bir yerde bulunduğu için mevcuttur — tam da bu yüzden defalarca „kaybolmuş" gibi görünüyordu. Düğme ve yazıcı aynı yol tanımını kullanır, dolayısıyla birbirinden ayrılamaz. Kaydedilmiş bir durum yoktur.

NEREDE

Settings → AI Helpers → ilk bölüm → „AI Helpers enabled" anahtarı. Varsayılan: açık.

TEKNİK

Pipeline'daki tüm AI-Helpers özellikleri üzerinde etkili 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ırma yok. Açıkken, bireysel alt seçenekler (S12–S13) devreye girer. Değer, yeniden başlatmalar arasında hatırlanır. Aşağıdaki aşamaları etkiler: (a) SfM öncesi Frame-Quality-Pre-Check (S12), (b) Loop-Closure tespiti (S13). Önemli: kapalıyken sekmenin tüm alt seçenekleri devre dışı bırakılır ve görsel olarak gri gösterilir. Alt bilgi notu, tüm AI Helpers'ın kesinlikle cihaz üzerinde çalıştığını vurgular — görsel yükleme yok, bulut işleme yok. Gizlilik garantisi, yalnızca yerel olarak Neural Engine üzerinde çalışan Apple Vision Framework'ünün ve doğrudan uygulama paketinde yer alan CoreML modellerinin kullanılmasından kaynaklanır.

NEREDE

Settings → AI Helpers → Available bölümü → „Frame quality check" anahtarı. Varsayılan: açık.

TEKNİK

SfM çağrısından önce içe aktarılan her kareyi analiz eden Frame-Quality-Screener'ı etkinleştirir. Her kare hareket bulanıklığı, aşırı ve yetersiz pozlama, yetersiz görüntü yapısı ve kapalı lens bölgesi açısından kontrol edilir; bulgu ayrıca önem derecesine göre sınıflandırılır (sorunsuz, uyarı, ciddi). Bulgu içermeyen kareler doğrudan geçer. Sorunlu kareler, her problemli kareyi küçük resim ve gerekçeyle listeleyen ve kaldırılıp kaldırılmayacağını soran modal bir onay diyaloğunu tetikler — ister tümünü tut, ister şikayet edilenlerin tümünü kaldır ya da kendi seçimini kaldır. Önemli: otomatik silme yok — diyalog her zaman gereklidir, son karar kullanıcıya aittir. Kapalıyken tüm kareler kontrol edilmeden SfM'e iletilir. Ana anahtar (S11) devre dışıyken bu anahtar görsel olarak gri gösterilir ve etkisizdir.

NEREDE

Settings → AI Helpers → Available bölümü → „Loop closure detection" anahtarı. Varsayılan: açık.

TEKNİK

Apple Vision Feature-Print tabanlı Loop-Closure tespitini etkinleştirir. İçe aktarılan her kare için bir Feature-Print, yani görüntü içeriğinin sinirsel bir gömme (embedding) hesabı yapılır. Ardından Feature-Print'ler ikili olarak karşılaştırılır; çekim sırasında yeterince birbirinden uzak duran (yani doğrudan komşu olmayan) yeterince benzer çiftler „Loop-Closure adayları" olarak tanımlanır ve proje klasöründeki bir yardımcı JSONL dosyasına yazılır. Yalnızca bilgi amaçlıdır — içe aktarılan görsel dizisi değiştirilmez. Amacı: SfM çözücüsüne (özellikle COLMAP'e), bu karelerin 3D uzayda birlikte kümelenmesi gerektiğine dair bir ipucu vermektir. Native SfM için yardımcı bilgi şu anda yalnızca belgeleyicidir; COLMAP bu ipuçlarını dahili olarak özel bir matches dosyası aracılığıyla kullanır (manuel entegrasyon mümkündür, otomatik bağlanmaz). Kapalıyken hiçbir Feature-Print üretilmez. Ana anahtar (S11) devre dışıyken görsel olarak gri gösterilir.