V-Ray App SDK ile render otomasyonu: sahneden çıktıya 6 adım

V-Ray App SDK, V-Ray motorunu bir uygulama içinden ya da ayrı bir süreçte kullanarak render başlatıp yönetmeye yönelik bir API sunuyor. Chaos’un resmi belgelerine göre bu akışta sahne V-Ray eklentileriyle bellekte oluşturulabiliyor veya .vrscene dosyasından yüklenebiliyor. Bu rehber, App SDK’nın temel render döngüsünü ve farklı sahne aşamalarında hangi render modunun işe yarayacağını açıklıyor. Belgelerde App SDK için geçerli bir yazılım sürümü belirtilmediğinden, anlatılanlar dokümantasyonda gösterilen genel iş akışına dayanıyor.

1. Ortamı hazırlayın

1. App SDK dosyalarının konumunu belirleyin. Belgeler, SDK’nın kullanılabilmesi için VRAY_SDK ortam değişkeninin tanımlanmasını istiyor. Python bağlaması kullanılacaksa python klasörünün Python modül arama yollarına eklenmesi gerekiyor; dokümantasyon bunu PYTHONPATH üzerinden örneklendiriyor. Bu hazırlık, uygulamanın SDK bileşenlerini bulabilmesi için gerekli.

2. Hazır ortam betiğini çalıştırın veya alternatif yolu değerlendirin. Belgelerde Windows için setenv.bat, Linux ve macOS için source setenv.sh kullanımı gösteriliyor. Bu betikler ilgili ortam değişkenlerini ayarlıyor. SDK ikili dosyaları ürünün /bin klasör yapısında bulunmuyorsa, belgeler VRAY_APPSDK_BIN değişkeninin kullanılabileceğini belirtiyor. Ortam değişkenleri kullanılamadığında API içinden arama yolu belirleme seçeneği de sunuluyor.

Bu aşamada bilgisayardaki klasör yapısı ile uygulamanın SDK kitaplığını aradığı konumun uyuştuğunu doğrulamak gerekir. Belgeler belirli bir işletim sistemi kurulumu veya donanım gereksinimi listelemiyor; bu nedenle kurulum ayrıntılarında kullanılan bağlamanın kendi API dokümantasyonu esas alınmalı.

2. Sahneyi oluşturun veya yükleyin

1. Render denetleyicisini başlatın. App SDK’daki VRayRenderer sınıfı render sürecini başlatıp yönetiyor. Sahne, V-Ray eklenti nesneleri oluşturup parametreleri ayarlanarak bellekte kurulabiliyor; diğer seçenek, V-Ray’in sahne biçimi olan .vrscene dosyasını yüklemek. Belgeler iki yöntemin birlikte kullanılabileceğini de belirtiyor.

Sahne oluşturma biçimi, mevcut üretim zincirine bağlıdır. Örneğin bir uygulama kendi sahne verisini V-Ray eklentilerine dönüştürebilir veya önceden dışa aktarılmış bir .vrscene dosyasını açabilir. App SDK’nın amacı belirli bir modelleme yazılımını zorunlu kılmak değil, V-Ray render motoruyla bu tür bir entegrasyon kurmaktır.

1. Sahne hazırlandıktan sonra render modunu seçin. Belgelerde iki temel seçenek anlatılıyor:

İki mod da CPU ve GPU seçenekleriyle destekleniyor. Belgeler GPU tarafında CUDA ve OptiX’in yalnızca NVIDIA, Metal ve MetalRT’nin yalnızca Apple için olduğunu belirtiyor. Render türü VRayRenderer nesnesinin renderMode özelliğiyle seçiliyor. Belgelerde sınıf için varsayılan mod Interactive (CPU) olarak açıklanmış; bu nedenle kullanılması gereken mod, uygulamanın amacına ve sistemdeki desteğe göre açıkça belirlenmeli.

3. Renderı başlatın ve sonucu alın

1. Render işlemini başlatın. start() yöntemi, render sürecini ayrı bir iş parçacığında çalıştıran ve beklemeden geri dönen çağrıdır. Bu sayede uygulama, render sürerken başka işlemleri yürütebilir veya ilerleme görüntüsü almak için hazır kalabilir. Belgelerdeki Python örneği, sahneyi yükleyip renderı başlatıyor, sonlanmasını bekliyor ve elde edilen görüntüyü PNG olarak kaydediyor:

import vray

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

Kod örneğindeki 6000 değeri, belgelerde waitForRenderEnd çağrısına verilen örnek argümandır; her sahne için önerilen veya zorunlu bir süre olarak sunulmuyor. Üretim kodunda bekleme davranışı, kullanılan API bağlamasının belgelerine göre ele alınmalı.

1. Görüntüyü render sürerken de değerlendirin ve kaynakları kapatın. App SDK, render tamamlanmadan önce de mevcut görüntü verisinin alınabildiğini belirtiyor. Bu özellik, özellikle Interactive modda önizlemeyi uygulama arayüzünde göstermek veya süreci izlemek için yararlı olabilir. Nihai görüntünün hazır olduğu durum ise renderer IDLE_DONE durumuna ulaştığında belgelerde açıklanıyor. İş tamamlandığında renderer kapatılmalı; Python örneğinde with bloğu bu yaşam döngüsünü yönetiyor.

Belgeler ayrıca render durumu değiştiğinde, V-Ray mesaj ürettiğinde veya görev ve ilerleme bilgisi bildirildiğinde olayların dinlenebildiğini anlatıyor. Bu bildirimler, bir entegrasyonun yükleme, render ve tamamlanma aşamalarında uygulama tarafındaki davranışları düzenlemesine yardımcı olur. Ancak geri çağırım işlevleri ayrı bir iş parçacığında çalışır; yavaş kullanıcı kodu diğer geri çağırımların yürütülmesini geciktirebilir.

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

App SDK, tekrar eden render adımlarını bir uygulamaya entegre etmek veya V-Ray sahnesini farklı bir süreçten yönetmek isteyen ekipler için anlamlıdır. Mimarlık ofisleri ve archviz üreticileri Interactive modu sahne ve içerik denemelerinde, Production modunu ise nihai görüntü aşamasında değerlendirebilir. Böylece önizleme ile son çıktı arasındaki çalışma biçimi aynı renderer üzerinden değiştirilebilir.

Bununla birlikte kaynaklar, belirli bir 3D yazılımıyla uyumluluk matrisi, donanım gereksinimleri, lisans koşulları veya fiyat bilgisi vermiyor. CPU ya da GPU seçimi yapılırken yalnızca belgelerde belirtilen işleme seçenekleri ve ilgili GPU teknolojilerinin platform sınırlamaları dikkate alınabilir; performans sonucu hakkında bir çıkarım yapılamaz. Uygulama entegrasyonu kurulmadan önce kullanılan dil bağlamasının API belgeleri ve SDK kitaplıklarının bulunacağı klasör yapısı kontrol edilmeli.

Sık yapılan hatalar

• VRAY_SDK veya uygun alternatif yol ayarlanmadan SDK bağlamasını başlatmak, kitaplıkların bulunamamasına yol açabilir.

• start() çağrısını renderın tamamlandığı şeklinde yorumlamak doğru değildir; bu yöntem belgelerde eşzamansız ve beklemeden dönen bir çağrı olarak tanımlanıyor.

• Render sürerken PREPARING durumunda sahne veya renderer üzerinde değişiklik yapmaya çalışmak reddedilebilir. Belgeler bu uyarıyı startSync() yerine start() kullanıldığı durum için veriyor.

• V-Ray olaylarına bağlanan yavaş geri çağırımlar, başka geri çağırımların çalışmasını geciktirebilir; bu nedenle olay işleyicilerinin yaptığı iş gözden geçirilmeli.

• Örnek koddaki bekleme argümanını her projeye uygulanacak sabit bir ayar gibi kullanmak, belgelerin verdiği bilginin ötesine geçer.

Bu dokümantasyon, kullanıcı arayüzündeki belirli render ayarlarının nasıl seçileceğini değil, App SDK üzerinden sahne yükleme ve render yönetiminin temelini anlatıyor. Uygulama içindeki ayrıntılı ayarlar için ilgili bağlamanın API referansı incelenmeli.