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

Kaynak: https://3dsinifi.com/haber/v-ray-app-sdk-ile-render-otomasyonu-sahneden-ciktiya-6-adim · Kategori: İpuçları · Yayın: 11 Kasım 2026

> Chaos’un V-Ray App SDK belgeleri, V-Ray motoruyla render sürecinin bir uygulama içinden veya dışında yönetilebildiğini açıklıyor. Bu rehber, sahne yüklemeden görseli kaydetmeye uzanan temel akışı ele alıyor.

## Kısaca
- V-Ray App SDK, V-Ray sahnesi oluşturma veya .vrscene dosyası yükleyerek render başlatma olanağı sunuyor.
- Interactive mod hızlı önizleme ve sahne ayarlarını denemek için; Production modu nihai görüntü için tanımlanıyor.
- Render işlemi start() ile arka planda başlatılabiliyor; süreç sürerken ara görüntüler alınabiliyor.
- Belgeler, App SDK için belirli bir yazılım sürümü veya lisans fiyatı belirtmiyor.

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

3. **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.

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

| Render modu | Belgelerde belirtilen kullanım | İş akışındaki yeri |
|---|---|---|
| Interactive | Hızlı görüntü önizlemesi ve görüntü kalitesinin aşamalı iyileştirilmesi | Sahne içeriğini veya ayarlarını denerken geri bildirim almak |
| Production | Dikkatle yapılandırılmış sahneden nihai görüntü elde etmek; görüntünün tamamlanması zaman alabilir | Sonuç görselini üretmek |

İ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

5. **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:

```python
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ı.

6. **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.

## Pro ipucu
Render başladıktan sonra `start()` çağrısının tamamlanmayı beklemediğini unutmayın; görüntüyü ve durumu süreç boyunca izleyin, nihai çıktıyı renderer `IDLE_DONE` durumuna ulaştığında alın.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ve görselleştirme ofisleri için App SDK’nın pratik değeri, V-Ray renderını mevcut bir uygulama ya da otomasyon akışına bağlayabilmesinde yatıyor. Interactive ve Production modlarının aynı renderer üzerinden değiştirilebilmesi, önizleme ile son görüntü süreçlerini ayrı araçlara bölmeden yönetme olanağı sunuyor.

Öte yandan bu belgeler fiyat, lisans koşulu, donanım gereksinimi veya belirli yazılımlarla uyumluluk bilgisi vermiyor. Bu nedenle yatırım kararı öncesinde SDK kurulumu ve kullanılan bağlamanın API kapsamı netleştirilmeli. En sık operasyonel riskler, ortam değişkenlerini yanlış ayarlamak ve eşzamansız renderın bittiğini varsaymak gibi görünüyor.

## Kaynaklar
- [docs.chaos.com](https://docs.chaos.com/vray_app_sdk/) (özet)
- [docs.chaos.com](https://docs.chaos.com/vray_app_sdk/doc/nodejs_plugins/index.html) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_