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

Kaynak: https://3dsinifi.com/haber/v-ray-app-sdk-ile-render-is-akisi-sahne-yukleme-onizleme-ve · Kategori: İpuçları · Yayın: 10 Ekim 2026

> Chaos’un V-Ray App SDK belgeleri, V-Ray motorunu uygulama içinden veya ayrı bir süreçte yönetmek için sahne yükleme, render başlatma ve görüntü kaydetme akışını açıklıyor. Rehber, bu adımları mimari görselleştirme işlerine uyarlıyor.

## Kısaca
- V-Ray App SDK, V-Ray sahnelerini oluşturmak veya dosyadan yüklemek ve render sürecini yönetmek için API sunuyor.
- SDK belgelerinde varsayılan render modu Interactive (CPU) olarak belirtiliyor.
- Üretim modu final görüntü için; Interactive modu ise hızlı önizleme ve ayar denemeleri için tanımlanıyor.
- Python kullanımı için `VRAY_SDK` ortam değişkeninin ve Python modül yolunun ayarlanması gerekiyor.

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:

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

| Ayar | Önerilen değer | Etkisi |
|---|---|---|
| Render modu | Ayar denemeleri ve hızlı önizleme için Interactive | Render sürerken görüntüyü takip etmeye ve içeriği denemeye yarar. |
| Render modu | Hazırlanmış sahnenin final görüntüsü için Production | Son görüntüyü elde etmeye yöneliktir; tamamlanması daha uzun sürebilir. |
| İşlemci türü | İş yüküne göre CPU veya GPU | CPU modu işlemci kaynaklarını, GPU modu grafik kartı hesaplama gücünü kullanır. |

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.

## Pro ipucu
Önce örnek bir `.vrscene` dosyasıyla ortam değişkenlerini, `start()` akışını ve görüntü kaydını doğrulayın; üretim sahnelerine geçmeden hedef GPU yolundaki eklenti desteğini kontrol edin.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve görselleştirme ekipleri için SDK’nın pratik değeri, render sürecini mevcut araçlara bağlayabilme ihtimalinde. Tekrarlanan sahne yükleme, önizleme ve çıktı alma adımları bir entegrasyona taşınırsa iş akışı daha düzenli yönetilebilir; ancak belgeler doğrudan zaman kazancı ölçümü sunmuyor.

Karar verirken donanım yolunu ve sahnede kullanılan eklentilerin desteğini deneme sahnesiyle sınamak gerekir. SDK belgelerinde fiyat veya lisans koşulları açıklanmıyor; dolayısıyla maliyet değerlendirmesi için ayrı doğrulama gerekir. Sürüm belirtilmemesi de kullanılan entegrasyon ve V-Ray ortamıyla uyumluluğun ayrıca kontrol edilmesini önemli kılı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)
- [docs.chaos.com](https://docs.chaos.com/vray_app_sdk/doc/csharp/namespace_v_ray_1_1_plugins.html) (özet)

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