V-Ray App SDK ile render otomasyonu: sahne yükleme ve çıktı alma

V-Ray Application SDK (App SDK), üçüncü taraf uygulamalara V-Ray motorunu başlatıp kontrol etme olanağı veriyor. Chaos’ın App SDK belgeleri; bir sahnenin bellekte V-Ray eklentilerine çevrilmesini veya .vrscene dosyasından yüklenmesini, render’ın başlatılmasını ve sonucun görüntü olarak alınmasını anlatıyor. Bu rehber, mimarlık ve görselleştirme araçlarına render entegrasyonu geliştiren ekipler için SDK’nın temel akışını ele alıyor. Belgelerde belirli bir V-Ray ya da App SDK sürümü belirtilmediğinden adımlar, dokümante edilen App SDK arayüzü için geçerlidir.

1. SDK’yı çalışma ortamına hazırlayın

App SDK’nın temel bileşeni VRayRenderer sınıfı. Bu sınıf sahne yükleme, render başlatma ve görüntüye erişme gibi işlemleri bir araya getiriyor. Başlamadan önce kütüphane dosyalarının bulunacağı konumun uygulama tarafından görülebilmesi gerekiyor.

1. SDK’nın bulunduğu konumu göstermek için VRAY_SDK ortam değişkenini ayarlayın. Python bağlamasını kullanacaksanız SDK içindeki python klasörünün Python modül arama yollarında olması gerekiyor; belgeler, bu amaçla PYTHONPATH kullanımını örnek veriyor.

Bu hazırlık özellikle başka bir yazılımın içine gömülen veya bağımsız çalışan bir entegrasyonda önem taşıyor: SDK bağlaması, render başlamadan önce V-Ray kütüphanelerini ve gerekli bağımlılıkları bulabilmeli. Kullanılan dilin kendi bağlama belgeleri, ilgili başlatma yönteminin ayrıntıları için ayrıca incelenmeli.

2. Sahneyi yükleyip render alın

Temel iş akışı; VRayRenderer oluşturmak, bir sahne hazırlamak veya dosyadan yüklemek, render’ı başlatmak, görüntüyü almak ve kaynakları kapatmaktan oluşuyor. Sahne, V-Ray eklentilerinin parametreleri ayarlanarak bellekte kurulabilir ya da .vrscene dosyasından okunabilir. Örnekte Python ile dosya yükleme ve PNG çıktısı alma gösteriliyor:

import vray
with vray.VRayRenderer() as renderer:
    renderer.load('./intro.vrscene')
    renderer.start()
    renderer.waitForRenderEnd(6000)
    image = renderer.getImage()
    image.save('intro.png')

start() eşzamansız çalışıyor: V-Ray motoru ayrı bir iş parçacığında render’a devam ederken ana uygulamanın akışı bütünüyle render’a bağlanmıyor. getImage() yalnızca işlem tamamlandığında değil, render sürerken de o andaki görüntü verisini alabiliyor. Böylece uygulama, ara görüntüyü gösterebilir veya desteklenen sıkıştırma biçimlerinden biriyle dosyaya kaydedebilir. Render tamamlanmasını beklemek için belgelerde waitForRenderEnd() kullanılıyor; örneklerdeki parametrenin birimi kaynakta açıklanmıyor, bu nedenle burada bir zaman birimi varsayılmamalı.

Uygulama işini bitirdiğinde renderer kapatılmalı ve ayrılan bellek kaynakları serbest bırakılmalı. Python’daki bağlam yöneticisi örneği renderer yaşam döngüsünü yönetiyor; diğer dil bağlamalarında kapatma adımının ilgili API’deki karşılığı kullanılmalı.

3. Önizleme ve son render için modu seçin

App SDK, iki temel render modu sunuyor. Interactive, görüntüyü hızlıca önizlemek ve içerik ya da sahne ayarları üzerinde deneme yaparken ilerlemeyi görmek için tasarlanmış. Production ise sahne dikkatlice yapılandırıldıktan sonra hedeflenen son görüntüyü almak için kullanılıyor; bütün görüntünün hazır olması daha uzun sürebiliyor.

Belgelerde VRayRenderer sınıfının varsayılanı Interactive (CPU) olarak açıklanıyor. GPU tarafında CUDA ve OptiX, NVIDIA; Metal ve MetalRT ise Apple için listelenmiş. Bu seçenekler, her bilgisayarda her render türünün kullanılabileceği anlamına gelmiyor: iş istasyonunun ve SDK kurulumunun seçilen yolu destekleyip desteklemediği kontrol edilmeli.

Mod, VRayRenderer nesnesinin renderMode özelliği üzerinden belirlenebiliyor. Dokümantasyona göre render’lar arasında mod değiştirmek için sahneyi yeniden oluşturmak veya yüklemek gerekmiyor. Bu, tasarım sırasında Interactive ile çalışıp son aşamada Production’a geçişi aynı entegrasyon akışında mümkün kılıyor.

4. Durum ve hata takibini entegrasyona katın

Render arka planda çalışırken SDK olaylar yayımlıyor. Durum değişikliği olayı; render’ın başlaması, tamamlanması veya hata nedeniyle durması gibi geçişleri uygulamaya bildirmek için kullanılabiliyor. Son görüntünün hazır olduğu durum IDLE_DONE; işlem sürerken ara görüntüler de alınabiliyor.

Log mesajı olayında metin ile seviye bilgisi sağlanıyor. Belgelerde seviyeler info, warning, error ve debug olarak sıralanıyor. Uygulama bu mesajları kendi tanılama akışına aktararak sahne yükleme ve render aşamalarındaki sorunları görünür kılabilir.

Olay geri çağrıları render iş parçacığından ayrı bir iş parçacığında yürütülüyor. Bu tasarım, yavaş bir geri çağrının render süresini etkilemesini önlemeyi amaçlıyor; ancak yavaş kullanıcı geri çağrıları diğer geri çağrıların çalışmasını geciktirebilir. Ayrıca eşzamansız start() sonrasında renderer PREPARING durumundan çıkana kadar sahne veya renderer üzerinde değişiklik yapılmamalı; belgeler bu sıradaki değişikliklerin reddedileceğini belirtiyor.

Mimarlık ve archviz iş akışında ne değişir?

App SDK, bir modelleme arayüzündeki belirli bir menü ayarından ziyade V-Ray’i başka bir uygulamanın iş akışına bağlamak için anlamlı. Örneğin bir ekip kendi sahne hazırlama aracında .vrscene yükleme, render başlatma, ilerleme görüntüsünü alma ve sonucu kaydetme adımlarını bir araya getirebilir. Burada fayda, render motorunun uygulama içinden kontrol edilebilmesi ve önizleme ile son render’ın aynı renderer üzerinden yürütülebilmesidir.

Ofislerin önce kullandıkları dil bağlamasını, V-Ray kütüphanelerinin konumunu ve hedef makinedeki CPU/GPU seçeneğini doğrulaması gerekir. Kaynaklar lisans koşulları, fiyat, belirli bir host yazılımıyla uyumluluk veya donanım gereksinimi açıklamıyor; bunlar hakkında varsayım yapılmamalı. Sahne durumunu ve logları izlemek, kullanıcıya yalnızca render düğmesi sunmaktan daha sağlam bir entegrasyon kurmaya yardımcı olur.

Sık yapılan hatalar

• VRAY_SDK veya Python kullanılıyorsa modül yolu ayarlanmadan SDK bağlamasını başlatmak. Kütüphane ya da Python modülü bulunamazsa önce ortam değişkenlerini ve klasör yollarını kontrol edin.

• start() çağrısını eşzamanlı bir işlem gibi ele alıp render’ın hemen tamamlandığını varsaymak. Çağrı arka planda çalışır; uygulamanın tamamlanma durumunu izlemesi gerekir.

• PREPARING aşamasında sahne veya renderer üzerinde değişiklik yapmak. Durum değişikliği olayını kullanarak düzenlemeleri güvenli aşamaya erteleyin.

• Callback içinde uzun süren işlemler yürütmek. Belgeler bunun başka callback’leri geciktirebileceğini belirtiyor; ağır işleri olay işleyicisinden ayrı ele alın.