RealityScan komut satırı rehberi: Fotoğraftan 3D modele iş akışı

Bu rehberde ne öğreneceksiniz?

RealityScan’in komut satırı arayüzü, uygulamadaki bazı işlemleri komutlarla sıraya koymaya ve tekrar eden işleri bir toplu iş dosyasıyla yürütmeye imkân veriyor. Bu rehberde mimari bir mekânın fotoğraflarını projeye ekleyip hizalayacak, projeyi kaydedecek, uygulamada ayarlanmış işlem adımlarını çalıştıracak ve bir modeli sadeleştirerek dışa aktaracaksınız. Komutlar örnek klasör adlarıyla verilmiştir; bunlar gerçek çalışma klasörlerine göre düzenlenmelidir.

Bu yöntem, her işlemi otomatikleştirme garantisi vermez. Örneğin -start komutu, RealityScan içindeki Start düğmesi için önceden yapılandırılmış işlemleri çalıştırır. Dolayısıyla uygulamadaki ayarlar ile komut satırı adımlarının birlikte düşünülmesi gerekir.

Gereksinimler

Resmî belgelerde komut satırı örnekleri RealityScan.exe üzerinden anlatılıyor. Aşağıdaki adımlar Windows Komut İstemi ve .bat dosyaları içindir. Belgelerde gereken belirli bir sürüm, donanım seviyesi, hesap türü veya fiyat bilgisi belirtilmiyor; bu nedenle projeye başlamadan önce kullanılan kurulumun ve lisans koşullarının ayrıca kontrol edilmesi gerekir.

Fotoğraf klasörü ve proje dosyası için örnekte C:\RS\Images ve C:\RS\Interior.rsproj yolları kullanılıyor. Kendi bilgisayarında bu klasörleri oluşturup görselleri uygun konuma yerleştir. Komutlarda boşluk bulunan dosya yolları kullanılıyorsa parametrelerin nasıl ayrıştırılacağını kurulum üzerinde doğrula; örneklerde boşluksuz yollar tercih edilmiştir.

RealityScan klasörünü sistemin PATH değişkenine eklemek, komutlarda uygulamanın tam yolunu tekrar tekrar yazma ihtiyacını azaltır. Resmî doküman, aşağıdaki PATH satırının yalnızca açık olan komut satırı oturumu için geçerli olduğunu belirtiyor.

Numaralı uygulama adımları

1. Fotoğrafları taslak modda hizalayın

Önce görselleri ekleyip hızlı bir taslak hizalama çalıştırın. Bu örnekte uygulama klasörü PATH’e ekleniyor, ardından fotoğraflar klasörden alınıyor ve proje kaydediliyor:

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

-draft hizalamayı taslak modda çalıştırır. Bu ilk kontrol, fotoğraf setinin bir araya gelip gelmediğini görmeye yarar; sonucu incelemeden tam hizalamaya geçmek yerine projeyi uygulamada açıp kontrol etmek daha güvenli bir iş akışıdır.

2. Alt klasörleri gerekiyorsa dahil edin

Görseller ana klasörün alt dizinlerine dağılmışsa, ekleme işleminden önce alt dizinleri tarama ayarını etkinleştirin:

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Bu ayar, -addFolder komutunun alt klasörleri de kapsamasını sağlar. Görseller zaten tek klasördeyse bu ek ayara ihtiyaç yoktur. İki örneği aynı proje üzerinde art arda çalıştırmak yerine, kullanılacak fotoğraf yapısına uygun tek akış seçilmelidir.

3. Tam hizalama çalıştırın

Taslak sonucu gözden geçirdikten sonra kaydedilmiş projeyi yeniden yükleyip tam hizalamayı başlatın:

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

Komutlar sırayla yürütülür: proje açılır, hizalama yapılır ve sonuç aynı proje dosyasına kaydedilir. Komut satırı parametreleri uygulamanın yaptığı işlemlere benzer biçimde çalışır; uygulama normal şekilde açılabilir ve işlem sırasında kullanıcı etkileşimine izin verir. Arayüzü gizlemek için -headless seçeneği de belgelenmiştir, ancak ilk denemelerde sonucu görünür biçimde kontrol etmek daha anlaşılır olabilir.

4. Uygulamada tanımlı işlem akışını çalıştırın

Hizalamanın ardından model üretimi için RealityScan’in Start düğmesinde gerekli işlemleri yapılandırın. Resmî belgeye göre -start, o düğme için ayarlanmış süreçleri çalıştırır; bu nedenle yalnızca komut ekleyerek hangi modelleme adımlarının yapılacağını varsaymayın.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

İşlem sırasında kullanılan seçenekler projeye ve amaca göre uygulamada kontrol edilmelidir. Komut satırı, önceden belirlenmiş bu akışı tekrar çalıştırmayı kolaylaştırır; ayarların uygunluğunu kendiliğinden garanti etmez.

5. Modeli sadeleştirip dışa aktarın

Modelin proje içindeki adını biliyorsanız -selectModel ile seçebilir, -simplify ile hedef üçgen sayısını belirleyebilir ve -exportSelectedModel ile dışa aktarabilirsiniz. Aşağıdaki örnekte Model1 adı ve 1.000.000 hedef üçgen kullanılmıştır; bu değer bir kalite önerisi değil, komutun kullanımını gösteren örnektir.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

Model adını projedeki gerçek adla değiştirin. Sadeleştirme ve dışa aktarma ayarlarını daha ayrıntılı yönetmek gerekiyorsa, uygulamadaki ilgili araçlardan dışa aktarılan params.xml dosyası komutlara isteğe bağlı parametre olarak verilebilir. Hangi ayarların kullanılacağı, dosyanın uygulamada nasıl hazırlandığına bağlıdır.

Sık yapılan hatalar

• Komutları uygulamanın kurulu olduğu klasörden çalıştırmadan RealityScan.exe çağırmak, yürütülebilir dosyanın bulunamamasına yol açabilir. Tam uygulama yolunu kullanın veya PATH satırını etkin komut oturumuna ekleyin.

• Alt klasörlerdeki görsellerin otomatik eklendiğini varsaymayın. Bu davranış gerekiyorsa appIncSubdirs ayarını kullanın.

• Taslak hizalamayı tamamlanmış sonuç olarak değerlendirmeyin. -draft ve -align farklı hizalama komutlarıdır; taslak aşamadan sonra projeyi kontrol edin.

• -start komutunun hangi işlemleri başlatacağını tahmin etmeyin. Start düğmesi ayarlarını uygulamada önceden yapılandırın.

• Modeli yanlış adla seçmek veya proje yolunu yanlış yazmak, komut akışının beklenen dosyayla çalışmasını engelleyebilir. Proje ve model adlarını uygulamadaki karşılıklarıyla eşleştirin.

Mimarlık, iç mekân ve archviz iş akışına etkisi

Mekân veya yapı fotoğraflarından oluşturulan modelleri işleyen ekipler, aynı ekleme ve hizalama adımlarını tekrarlayan projelerde komut satırından yararlanabilir. Sadeleştirme ve dışa aktarma da belgelenen araçlar arasında olduğundan, fotoğraflardan elde edilen modelin farklı aşamalarda hazırlanmasına yönelik bir iş akışı kurulabilir. Bu, mimari kararların yerini alan bir yöntem değil; fotoğraf tabanlı veriyi proje içinde düzenlemeye ve belirli işlemleri tekrarlamaya dönük bir araçtır.

Ofislerde birden fazla kişinin çalıştığı projelerde klasör yapısının, proje adlarının ve uygulamadaki işlem ayarlarının tutarlı tutulması önem taşır. RealityScan belgeleri burada belirli bir archviz yazılımıyla uyumluluk, gereken donanım veya lisans maliyeti hakkında bilgi vermiyor. Bu nedenle dışa aktarılan dosyanın hedef uygulamada nasıl kullanılacağı, donanımın işlem süresine etkisi ve lisans koşulları gerçek proje verisiyle ayrıca sınanmalıdır.

Sonraki adımlar

Temel akış çalıştıktan sonra komut satırında image listesiyle görsel ekleme, proje yükleme ve kaydetme gibi diğer proje komutlarını inceleyebilirsiniz. Hizalama tarafında XMP kamera meta verilerini dışa aktarma ve yeniden kullanma seçenekleri bulunuyor. Model araçlarında ise temizleme, delikleri kapatma, doku hesaplama ve farklı dışa aktarma işlemleri belgelenmiş durumda. Her yeni komutu önce küçük bir kopya proje üzerinde denemek, mevcut çalışmanın üzerine yazma riskini azaltmaya yardımcı olur.

Kaynak ve lisans

Rehber, Epic Games’in RealityScan için yayımladığı komut satırı belgelerindeki proje ve görüntü komutları, hizalama komutları ve model araçları bölümlerine dayanır. Kaynaklar serbest lisanslı olarak işaretlenmiştir; içerik Türkçe anlatımla uyarlanmış, örnekler bu rehber için düzenlenmiştir.