V-Ray SDK

2 dakika okuma

İçindekiler

Genel Bakış
Kurulum
Klasör Yapısı
Örneklerin Derlenmesi
- V-Ray Next ve 3ds Max'in eski sürümlerini kullanıyorsanız, örnekleri nasıl derleyeceğinizi görmek için buraya tıklayın.

Bu sayfa V-Ray SDK hakkında bilgi vermektedir.

Genel Bakış #

V-Ray SDK, 3ds Max için V-Ray kurulumuyla birlikte gelir ve V-Ray uyumlu materyaller, dokular, ışıklar, atmosferik efektler, kameralar ve özel geometrik şekiller oluşturmaya olanak tanır. Ek olarak, V-Ray SDK, bazı ek V-Ray eklentilerinin kaynak kodunu da içerir; örneğin, VRayDomeCamera eklentisi.

Kurulum #

V-Ray SDK, İş İstasyonu kurulum türüyle birlikte yüklenir ve normalde C:\Program Files\Chaos\V-Ray\3ds Max #### klasörüne kurulur; burada ####, 3ds Max sürümünü (2021, 2022, vb.) temsil eder.

V-Ray 7 öncesi sürümler için V-Ray SDK’nın varsayılan olarak C:\Program Files\Chaos Group\V-Ray\3ds Max #### klasörüne yüklendiğini unutmayın.

Klasör Yapısı #

V-Ray SDK aşağıdaki klasörleri içermektedir:

\docs – V-Ray mimarisi hakkında genel bilgilerin yanı sıra SDK’daki çeşitli sınıfların dokümantasyonunu içeren vrayclasses.chm adlı bir yardım dosyası içerir. vrayclasses.chm dosyası, SDK ile birlikte gelen başlık dosyalarından otomatik olarak oluşturulur.

\include – V-Ray SDK kullanan 3ds Max eklentilerini derlemek için gereken V-Ray SDK başlık dosyalarını içerir.

\lib – V-Ray SDK kullanan eklentilerin bağlanması için gerekli kütüphane dosyalarını içerir.

\samples – V-Ray ile birlikte gelen bazı eklentilerin (örneğin VRayDomeCamera eklentisi) kaynak kodunu ve ayrıca bazı ek örnekleri (örneğin VRayBlinnMtl) içerir.

Örneklerin Derlenmesi #

Örnek projeler, Microsoft Visual Studio çözümleri veya Ninja projeleri oluşturmak için kullanılabilen bir CMake projesiyle birlikte gelir. Kullanılacak araç seti sürümü, MSVC çalışma zamanı sürümü 14.2x olan Microsoft Visual Studio 2019 olmalıdır.

Örnek projeleri oluşturmak için uyumlu bir 3ds Max SDK’sına ihtiyaç duyulmaktadır. Kurulum için CMake değişkeni 3DSMAX_SDK_ROOT’un 3ds Max SDK kök dizinine işaret edecek şekilde ayarlanması gerekmektedir.

V-Ray çözümlerinde, CMake yapılandırma sürecinin birkaç aşamasında koşullu olarak tanımlanan bazı seçenekler bulunur. Bu nedenle, CMake GUI’sini kullanırken, tüm seçeneklerin ayarlanması için yapılandırma adımını birkaç kez tekrarlamak gerekebilir.

3ds Max 2022 örneklerine başlamak için:

Komut istemini örnekler dizininde açın, örneğin, C:\Program Files\Chaos\V-Ray\3ds Max 2022\samples
CMake komutunu çalıştırın, örneğin: cmake -B”C:\build\VRay3dsMax2022Samples” -H”.” -G”Visual Studio 16 2019″ -A”x64″ -T”v142″ -D”3DSMAX_SDK_ROOT=C:\conan\pack\Max2022SDK”

Herhangi bir hata oluşmadıysa, çözümler “-B” ile belirtilen çıktı dizininde olmalıdır.

V-Ray Next ve 3ds Max’in eski sürümlerini kullanıyorsanız, örnekleri nasıl derleyeceğinizi görmek için buraya tıklayın. #

Örneklerin proje dosyaları .dsp dosya formatındadır ve Visual Studio’nun daha yeni sürümlerine dönüştürülmeleri gerekmektedir.

3ds Max 2013 ve sonraki sürümler için örnekleri oluşturmak için şu adımları izleyin:

İlgili 3ds Max sürümü için gereken Visual Studio sürümünü açın (3ds Max 2013 ve 3ds Max 2014 için Visual Studio 2010, 3ds Max 2015 için Visual Studio 2012);
Dosya > Aç > Proje/çözüm… seçeneğine tıklayın ve derlemek istediğiniz projenin .dsp dosyasını seçin;
Visual Studio, projeyi yükseltmek isteyip istemediğinizi sorar. Tamam’ı tıklayın ve Visual Studio’nun dönüştürme işlemini yapmasına izin verin;
Çözüm Gezgini’nde projeye sağ tıklayın ve Özellikler’i seçin ;
Yapılandırma Yöneticisi… düğmesine tıklayın ;
Etkin çözüm yapılandırması açılır menüsüne tıklayın ve <Yeni…> öğesini seçin ;
Yeni yapılandırma için bir ad yazın, örneğin “max 2013 sürümü”;
Kopyala ayarlarını açılır menüden Max Release Official yapılandırmasına göre ayarlayın . Yeni yapılandırmanın Max Release Official yapılandırmasına dayanması önemlidir, çünkü diğer yapılandırmalar düzgün derlenmez;
Yeni proje yapılandırmaları oluştur seçeneğinin etkinleştirildiğinden emin olun ;
Yeni yapılandırmayı oluşturmak için Tamam’a tıklayın ;
Aktif çözüm platformu açılır menüsüne tıklayın ve <Yeni…> seçeneğini belirleyin ;
x64 platformunu seçin ;
“Kopyala ayarları” açılır menüsünden Win32’yi seçin ;
Yeni proje platformları oluştur seçeneğinin işaretli olduğundan emin olun ;
Yeni platformu eklemek için Tamam’a tıklayın ;
Yapılandırma özelliklerinin Genel bölümünde , Karakter Kümesi özelliğini Unicode Karakter Kümesini Kullan olarak ayarlayın (3ds Max 2012 ve öncesi için bunu Çok Baytlı Karakter Kümesini Kullan olarak bırakın );
Yapılandırmanın C/C++ bölümünde, “Addition Include Directories” özelliğinde, k:\3dsmax\maxsdk2013 ifadelerini 3ds Max SDK kurulumunuzun yoluyla değiştirin;
Yapılandırmanın Bağlayıcı bölümünde , Ek Kütüphane Dizinleri özelliğinde, k:\3dsmax\max2014\Lib\x64 ifadesini 3ds Max SDK kurulumunuzdaki kütüphane dosyalarının yoluyla değiştirin.