V-Ray App SDK ile render iş akışı: sahne yükleme, önizleme ve çıktı

V-Ray App SDK, Chaos’un belgelerine göre üçüncü taraf yazılımların V-Ray motorunu başlatıp yönetmesini sağlayan bir arayüz sunuyor. Bu rehber, SDK üzerinden bir sahneyi yükleyip render alma, ara görüntüyü izleme ve sonucu dosyaya kaydetme adımlarını ele alıyor. Belgeler belirli bir SDK sürümünü belirtmediğinden, aşağıdaki bilgiler belgelerde tanımlanan genel iş akışına dayanıyor.

V-Ray App SDK hangi işlerde kullanılabilir?

SDK, bir V-Ray sahnesini başka bir uygulamanın sürecinde ya da o uygulamadan bağımsız biçimde oluşturup render etmeye imkân veriyor. Sahne, yerel bir proje biçiminden V-Ray eklentilerine dönüştürülerek bellekte kurulabiliyor veya V-Ray’in sahne biçimi olan .vrscene dosyasından yüklenebiliyor. Dağıtık render desteği de belgelenen kullanım alanları arasında.

Bu yapı, render işini kendi araçlarına veya otomasyon akışına bağlamak isteyen yazılım geliştiriciler için anlamlı. SDK, 3ds Max ya da başka bir modelleme yazılımında kullanılan standart bir kullanıcı arayüzü kılavuzu değil; V-Ray motoruyla çalışan entegrasyonlar geliştirmek için sunulan bir API. Dolayısıyla mimarlık ofislerinde doğrudan yarar, kullanılan yazılımın SDK üzerinden kurulan bir entegrasyona sahip olup olmadığına bağlı.

Kurulumdan görüntü almaya: adım adım

1. SDK yollarını hazırlayın. Belgeler, VRAY_SDK ortam değişkeninin ayarlanmasını istiyor. Python bağlaması kullanılacaksa SDK içindeki python klasörü, Python’ın modül arama yoluna eklenmeli. Belgelerde Windows için setenv.bat, Linux ve macOS için source setenv.sh çalıştırılması örnekleniyor. Bu betikler ilgili ortam değişkenlerini ayarlıyor.

2. Kütüphane konumunu doğrulayın. VRAY_SDK ayarlandığında SDK bağlaması, gerekli ikili dosyaları ve bağımlılıkları VRAY_SDK/bin altında arıyor. Ürünün klasör yapısında bin dizini yoksa VRAY_APPSDK_BIN kullanılabiliyor; bu durumda arama belirtilen klasörde yapılıyor. Ortam değişkeni kullanılamadığında, belgeler çalışma anında kütüphane arama yolunun ayarlanabildiğini de belirtiyor.

3. Renderer oluşturup sahneyi yükleyin. VRayRenderer, render sürecini başlatıp kontrol eden ana sınıf. Yeni eklenti nesneleri ve parametreleriyle sahne oluşturmak veya .vrscene dosyasını yüklemek mümkün. İki yaklaşım birlikte de kullanılabiliyor. Bir entegrasyon geliştirirken bu aşamada sahne verisinin nasıl sağlanacağı netleştirilmeli.

4. İşleme modunu seçip render’ı başlatın. Belgelerde varsayılan mod Interactive (CPU). start() çağrısı eşzamansız çalışıyor; render ayrı bir iş parçacığında devam ederken uygulama başka işlemler yapabiliyor. Render sürerken ara görüntü alınabilmesi, önizleme akışında ilerlemeyi takip etmeye yarıyor. Render tamamlandığında nihai görüntü hazır oluyor.

5. Görüntüyü alın ve kaynakları kapatın. SDK, eldeki render görüntüsünü bir görüntü nesnesi olarak sunuyor; bu nesne ekranda gösterilebiliyor veya desteklenen biçimlerde dosyaya yazılabiliyor. İş tamamlandığında renderer’ın kapatılması ve kullanılan bellek kaynaklarının temizlenmesi, belgelerdeki temel akışın son adımı.

Python belgelerindeki çağrı sırasını gösteren kısa örnek:

import vray

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

Buradaki dosya adları belgedeki örnekten alınmıştır. Kod, sahne dosyasının yolunu ve sonuç görüntüsünün kaydedileceği yeri projeye göre düzenleyen bir entegrasyon içinde kullanılmalı.

Önizleme mi, final render mı?

SDK iki render modu tanımlıyor. Interactive modu, hızlı görüntü önizlemesi ve sahne ayarlarını değiştirirken kademeli geri bildirim almak için uygun. Production modu ise sahne dikkatle hazırlandıktan sonra istenen son görüntüyü üretmeye yönelik; tam görüntünün ortaya çıkması daha uzun sürebiliyor. Mod, renderer yeniden oluşturulmadan veya sahne yeniden yüklenmeden render’lar arasında değiştirilebiliyor.

GPU tarafında belgeler CUDA ve OptiX’i NVIDIA’ya, Metal ve MetalRT’yi Apple’a bağlı seçenekler olarak sıralıyor. Bu nedenle donanım ve kullanılan işleme teknolojisinin uyumu, entegrasyonun başında kontrol edilmeli. Eklenti desteği de her yerde aynı değil: API referansındaki bazı bileşenler tam, bazıları kısmi, bazıları ise GPU desteği olmayan biçimde işaretleniyor. Bu bilgi, belirli bir sahne özelliğinin her render yolunda çalışacağı anlamına gelmediğini gösteriyor.

Mimarlık ve görselleştirme iş akışına etkisi

Mimari görselleştirme ekipleri açısından SDK’nın değeri, tekrarlanan render adımlarını bir uygulamaya bağlayabilmesinde yatıyor. Bir proje aracı .vrscene dosyasını yükleyip önizleme sunabilir, render durumunu izleyebilir ve görüntüyü kaydedebilir. Dağıtık render da SDK belgelerinde yer alıyor; ancak ekiplerin hangi yazılım ve donanım yapılandırmasıyla bunu kullanacağı, kendi entegrasyonlarına bağlı.

Render modu seçimi iş akışını sadeleştirebilir: malzeme, ışık ve kadraj denemelerinde Interactive; onaylanmış sahnenin son çıktısında Production tercih edilebilir. Bununla birlikte, SDK belgeleri render süreleri, donanım gereksinimleri veya lisans koşulları için sayısal bir karşılaştırma vermiyor. Bu yüzden ofisler, gerçek proje sahneleriyle uyumluluk ve donanım testini kendi ortamlarında yapmalı.

Sık yapılan hatalar

• Ortam değişkenlerini atlamak: VRAY_SDK tanımlı değilse bağlama gerekli kütüphaneleri bulamayabilir. Python modül yolu da ayrıca hazırlanmalı.

• Eşzamansız akışı göz ardı etmek: start() render’ı arka planda başlatıyor. Belgeler, renderer PREPARING durumundayken sahne ya da renderer üzerinde değişiklik yapılmaması gerektiğini belirtiyor; bu girişimler reddedilebilir.

• Önizleme ile final modu karıştırmak: Interactive hızlı geri bildirim için, Production ise hazırlanmış görüntü için tanımlanıyor. İki modu işin farklı aşamalarında kullanmak daha tutarlı bir akış kurar.

• Eklenti uyumluluğunu varsaymak: API referansında GPU desteği eklentiye göre değişebiliyor. Kullanılan sahne bileşenlerinin hedeflenen render yolu ile uyumu, entegrasyon testinde doğrulanmalı.

Bu rehberdeki iş akışı, Chaos’un V-Ray App SDK belgelerinde anlatılan genel kullanıma dayanıyor; belgeler belirli bir yazılım sürümü belirtmiyor.