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

Kaynak: https://3dsinifi.com/haber/v-ray-sdkde-bitmap-filtreleme-ve-doku-firinlama-rehberi · Kategori: İpuçları · Yayın: 7 Ekim 2026

> Chaos’ın V-Ray SDK belgeleri, bitmap filtreleme ve doku fırınlama için kullanılabilen özellikleri açıklıyor. Bu rehber, renk uzayı ve filtre seçimini bake parametreleriyle birlikte ele alıyor.

## Kısaca
- BitmapBuffer, doku dosyalarını TexBitmap eklentisinde kullanılmak üzere sağlar.
- filter_type değerleri arasında mip-map, summed area table, eliptik ve keskin mip-map filtreleme bulunur.
- Bitmap filtrelemenin doğru çalışması için transfer_function parametresinin ayarlanması gerekir.
- BakeView; UV aralığı, ışın ofseti ve projeksiyon bake seçenekleri sunar.

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.

| Ayar | Önerilen değer | Etkisi |
|---|---|---|
| `filter_type` | `-1` | En yakın komşu filtreleme |
| `filter_type` | `0` | Filtreleme yok |
| `filter_type` | `1` | Mip-map filtreleme |
| `filter_type` | `2` | Summed area table filtreleme |
| `filter_type` | `3` | Eliptik filtreleme |
| `filter_type` | `4` | Eski seçenek; belgeler kullanılmamasını söylüyor |
| `filter_type` | `5` | Keskin mip-map filtreleme |

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.
2. Filtreleme istemediğiniz bir durumda `0` seçeneğini, en yakın komşu davranışı gerektiğinde `-1` seçeneğini değerlendirin. Belgeler bu seçenekleri tanımlar ancak her sahne veya doku türü için tek bir ideal değer önermez.
3. `4` değerini yeni bir kurulumda kullanmayın. SDK belgesi bu seçeneği kullanımdan kaldırılmış olarak işaretliyor.
4. `filter_blur` da BitmapBuffer özelliği olarak listeleniyor; ancak sağlanan doküman metni bu parametre için önerilen bir değer veya davranış açıklaması vermiyor. Bu nedenle sabit bir blur değeri varsaymak yerine kullanılan uygulamanın belgelerini ayrıca kontrol edin.

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.

## Pro ipucu
Bitmap filtrelemesini etkinleştirmeden önce `transfer_function` değerini belirleyin; Chaos belgeleri bu parametre ayarlanmadığında filtrelemenin doğru çalışmayabileceğini belirtiyor.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve görselleştirme ekipleri için bu dokümanın pratik değeri, hazır bir render ayarı sunmasından değil, doku ve bake adımlarını SDK üzerinden açıkça tarif etmeye imkân vermesinden geliyor. Özellikle tekrarlanan varlık hazırlama süreçlerinde parametrelerin doğru eşleştirilmesi, hatalı renk yorumlarını ve bake kapsamı karışıklıklarını azaltmaya yardımcı olabilir.

Bununla birlikte donanım, lisans ve uygulama sürümü hakkında burada karar vermeye yetecek bilgi yok. Üretim hattına eklemeden önce kullanılan V-Ray SDK sürümünü doğrulamak, `transfer_function` ile renk uzayını test etmek ve `max_depth` gibi ışın ayarlarını küçük bir deneme sahnesinde kontrol etmek en sağlıklı yaklaşım. Belgede bulunmayan varsayılan değerleri kopyalamamak da önemli.

## Kaynaklar
- [docs.chaos.com](https://docs.chaos.com/vray_app_sdk/doc/csharp/namespace_v_ray_1_1_plugins.html) (ö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ı_