V-Ray SDK’de bitmap filtreleme ve doku fırınlama rehberi

Chaos’ın V-Ray SDK belgeleri, 7 Ekim 2026 itibarıyla bitmap dokuların filtrelenmesi ve BakeView ile doku fırınlama için kullanılabilen parametreleri listeliyor. Bu rehber, arayüz menülerinden ziyade SDK özelliklerini kullanan teknik sanatçılar ve geliştiriciler için hazırlanmıştır. Belgelerde bu özelliklerin hangi V-Ray yazılım sürümüne uygulandığı belirtilmiyor; dolayısıyla burada belirli bir sürüm uyumluluğu varsayılmamalı. Amaç, parametrelerin ne yaptığını ayırt ederek doku ve bake süreçlerini daha bilinçli kurmak.

1. Bitmap dokuda filtreleme türünü seçin

BitmapBuffer, bir dosyadaki bitmap verisini TexBitmap doku eklentisine sağlamak için kullanılıyor. Filtreleme tercihi filter_type parametresinden yapılıyor. Belgede seçenekler sayısal değerlerle tanımlanmış; bu nedenle SDK entegrasyonunda sayının hangi yönteme karşılık geldiğini kontrol etmek önemli.

1. Önce doku kullanımına uygun filtre yöntemini belirleyin; ardından filter_type değerinin seçilen yöntemle eşleştiğini doğrulayın. Örneğin 1, mip-map filtrelemedir; 5 ise keskin mip-map filtrelemedir. Bunlar aynı ayar değildir.

Filtre seçiminin görüntüye etkisi, yalnızca bu sayısal seçimi yapmaktan ibaret değildir. Renk aktarımı ve renk uzayı bilgisi de bitmap’in nasıl ele alınacağını etkileyebilir. Bu nedenle filtre parametrelerini renk yönetiminden bağımsız düşünmeyin.

2. Transfer function ve renk uzayını birlikte ayarlayın

BitmapBuffer içindeki transfer_function, dokunun aktarım biçimini belirtir: 0 linear, 1 gamma corrected, 2 sRGB, 3 ise auto anlamına gelir. Belgeler kritik bir uyarı da veriyor: transfer_function ayarlanmazsa doku filtreleme doğru çalışmayabilir. Dolayısıyla filtre türü belirlenirken bu alanın da açıkça ele alınması gerekir.

1. Doku kaynağı için uygun transfer işlevini belirleyin ve transfer_function değerini buna göre verin. Belgede seçeneklerin adları ve sayısal karşılıkları açıkça listeleniyor; ancak hangi dosya türünde hangi değerin kullanılacağına dair genel bir reçete sunulmuyor.

2. rgb_color_space alanını dokunun doğrusal RGB renk uzayı olarak değerlendirin. Varsayılan değer raw olarak belirtilmiş; bu değer dönüşüm yapılmaması anlamına geliyor.

3. Yerleşik renk uzayı adları arasında lin_srgb ve acescg bulunuyor. Belge, lin_srgb seçeneğini sRGB için doğrusal RGB uzayı olarak açıklıyor. OCIO ortam değişkeni tanımlıysa veya SettingsUnitsInfo içindeki ocio_config_file parametresi ayarlanmışsa, ilgili OCIO yapılandırmasında bulunan başka renk uzayı adları da kullanılabiliyor.

4. Dönüşüm sırasını hesaba katın: belgeye göre renk uzayı dönüşümü, transfer function uygulandıktan sonra gerçekleşiyor. Bu nedenle iki parametreyi birbiriyle uyumsuz bırakmak, beklenen renk işleme sonucunu bozabilir.

Bu ayrıntılar, farklı kaynaklardan gelen dokuların aynı sahnede kullanıldığı SDK tabanlı iş akışlarında özellikle önemlidir. Ancak belgeler belirli bir sahne için renk uzayı veya transfer function değeri önermiyor; seçim, kaynak dokunun niteliği ve projede kullanılan OCIO yapılandırmasıyla doğrulanmalı.

3. BakeView ile bake kapsamını tanımlayın

BakeView, belgede doku fırınlama sırasında RenderView yerine kullanılan eklenti olarak tanımlanıyor. Bake işleminin hedefi bake_node, projeksiyon bake için hedef nesneler ise target_nodes üzerinden belirtiliyor. UV üretimi bake_uvwgen ile bağlanabiliyor; u_min, v_min, u_max ve v_max alanları bake edilecek UV aralığının sınırlarını tanımlıyor.

1. Hangi nesnenin bake edileceğini ve projeksiyon hedeflerini belirleyin. Projeksiyon bake etkinleştirilirken projection_baking için 0 normal bake, 1 projeksiyon bake anlamına geliyor.

2. UV üreticisini BakeView’a bağlayın. Birden fazla nesneyi tek görüntüye yerleştirmek için mapped_bake_nodes ve her nesneye karşılık gelen UV üreticileri kullanılabiliyor. Alternatif olarak aynı UV üreticisi bütün düğümlere bake_uvwgen üzerinden atanabiliyor.

3. Bake bölgelerini tek tek tanımlayacaksanız mapped_x0, mapped_y0, mapped_x1 ve mapped_y1 alanlarının her nesnenin çıktı bölgesini belirttiğini dikkate alın. Otomatik bölge yerleşimi için mapped_bake_nodes_auto özelliği bulunuyor; belge bunun düğümleri bölge tanımlamadan tek görüntüye bake ettiğini söylüyor.

4. Işın davranışını kontrol edin. max_depth, ışın boyunca bu mesafeden daha uzaktaki geometrinin yok sayılmasını sağlıyor; değer 0 olduğunda herhangi bir geometri bu nedenle dışarıda bırakılmıyor. ray_offset ise ışının başlangıç noktasının normal boyunca ne kadar kaydırılacağını belirtiyor. Belgeler bu alanlar için genel bir ideal değer önermiyor.

5. Normal türünü ve bake yönünü ihtiyaca göre belirleyin. normal değeri 0 olduğunda smooth normal, 1 olduğunda geometry normal kullanılıyor. from_camera için 0, yüzey normali boyunca ışınlardan yansıma ve benzeri gölgeleme; 1 ise kameradan çıkan ışınlarla bake anlamına geliyor. Bu seçenekleri değiştirmeden önce hedeflenen bake yöntemini netleştirin.

Sık yapılan hatalar

En önemli hata, filtre seçip transfer_function değerini ayarlamayı atlamaktır; SDK belgesi bu durumda filtrelemenin doğru çalışmayabileceğini açıkça belirtiyor. Bir diğer hata, filter_type için sayısal değeri yanlış yorumlamak veya artık kullanılmaması belirtilen 4 seçeneğini tercih etmektir.

Bake tarafında ise max_depth değerini sıfırdan farklı bir değere ayarlamanın uzak geometriyi etkileyebileceği unutulmamalı. Ayrıca mapped_bake_nodes kullanıldığında her nesneye karşılık gelen UV üreticisi ve çıktı bölgesi mantığı tutarlı kurulmalı. Belgelerde SDK parametreleri veriliyor, ancak 3ds Max veya başka bir uygulama için menü yolu, sürüm numarası ya da hazır bir kalite ayarı sunulmuyor.

Mimari ve görselleştirme iş akışına etkisi

Bu parametreler, V-Ray SDK üzerinden doku yükleme ve bake sürecini otomatikleştiren ekipler için anlamlı. Mimari görselleştirme araçları geliştiren teknik sanatçılar, bitmap renk uzayı ile transfer bilgisini açıkça tanımlayabilir; sahne varlıkları için bake kapsamını ve UV bölgelerini kod düzeyinde yönetebilir. Mimarlık ve iç mekân ekipleri açısından fayda, doğrudan yeni bir görsel özellikten çok, varlıkların hazırlanışını daha denetlenebilir kılma potansiyelidir.

Donanım gereksinimleri, lisans koşulları ve belirli V-Ray sürümleri bu kaynaklarda açıklanmıyor. Bu nedenle üretim hattına geçmeden önce kullanılan SDK’nın sürüm uyumluluğu, lisans kapsamı ve projedeki renk yönetimi yapılandırması ayrıca doğrulanmalı. Belgede listelenen özellikler, otomatik bir kalite veya hız artışı garantisi olarak değerlendirilmemeli.