Phoenix API

3 dakika okuma

İçindekiler

Genel Bakış
Kurulum
Yapı
Phoenix API'sini kullanma
Örnekler
- Izgara Görünümü
- CSVParçacıkları

Bu sayfa, Chaos Phoenix uygulama programlama arayüzü (API) hakkında bilgi vermektedir.

Genel Bakış #

Chaos Phoenix API, Autodesk ® 3ds Max® için Phoenix kurulumuna dahildir . Çeşitli amaçlar için C++ API’si sağlar:

AUR, VDB veya F3D önbellek dosyalarında saklanan ızgara ve parçacık verilerinin yüklenmesi.
3ds Max’te bir Phoenix Simulator düğümünün ızgara hacmine ve parçacık gölgelendirme çekirdeğine çalışma zamanında erişim sağlayarak, bu verileri kendi eklentinizde okumanıza ve gölgelendirmenize olanak tanır.
Phoenix düğümlerine çalışma zamanında erişim sağlayarak, bunları isteğe bağlı olarak render için hazırlayabilir, simülasyonu başlatıp durdurabilir, farklı düğümlerin parametrelerine erişebilir, ön ayarları yükleyip kaydedebilirsiniz.
Phoenix renk geçişlerine ve diyagram eğrilerine erişim sayesinde bunları kendi uygulamanıza entegre edebilirsiniz.

Kurulum #

Phoenix API normalde “C:\Program Files\Chaos Group\Phoenix FD\3ds Max NNNN for x64\SDK” klasörüne yüklenir; burada NNNN, 3ds Max’in sürümünü (2021, 2020, vb.) temsil eder.

Yapı #

Phoenix API’si aşağıdaki klasörleri içerir:

\include – Phoenix API ile arayüz oluşturmak için gereken başlık dosyalarını içerir.
\lib – Phoenix API’nin hem statik hem de dinamik olarak bağlantılı sürümlerine ait ikili dosyalarını içerir.
\samples – Phoenix API’nin farklı işlevlerini kullanan örnek projeler içerir.

Phoenix API’sini kullanma #

Phoenix API’si statik ve dinamik kütüphane olarak sağlanmaktadır. Projenize bağlı olarak, kütüphanenin statik veya dinamik sürümünü seçebilirsiniz. Genellikle, Phoenix API’si vutils_s.lib’e bağımlı olduğundan, V-Ray SDK’nın herhangi bir sürümüne bağımlılık söz konusu olduğunda dinamik sürüm tercih edilir .

Phoenix API’yi statik bir kütüphane olarak kullanmak şunları gerektirir:

Bağlayıcıya ek bir bağımlılık olarak \lib\aurloader_s.lib ve \lib\vutils_s.lib eklenecektir.

Phoenix API’yi dinamik bir kütüphane olarak kullanmak şunları gerektirir:

AURLOADER_DYNAMIC_LIB, derleyici ayarlarına önişlemci tanımı olarak eklenecektir.
\lib\aurloader.lib dosyasının bağlayıcıya ek bir bağımlılık olarak eklenmesi gerekiyor.
\lib\aurloader.dll dosyasının, \lib\aurloader.lib dosyasına bağlı yürütülebilir dosya tarafından çalışma zamanında kullanılabilir olması .

Phoenix API , tüm 3ds Max sürümleri ve hem V-Ray Next hem de V-Ray 5 için “/MD” Çalışma Zamanı Kütüphanesi bayrağıyla vc14 C++ Platform Araç Seti kullanılarak oluşturulmuştur .

Örnekler #

Phoenix API’si iki örnek kod projesiyle birlikte gelir: GridView ve CSVParticles.

Önkoşullar:

Proje, proje dosyalarını oluşturmak için CMake kullanmaktadır. Ayrıca aşağıdaki üçüncü taraf kütüphaneler de kullanılmıştır:

GLEW ( http://glew.sourceforge.net/ ).
GLFW ( http://www.glfw.org/ ) GLFW Sürüm 3.0.4 ile test edilmiştir.
Zlib ( http://www.zlib.net/ ). Phoenix API’nin statik sürümü kullanılıyorsa gereklidir.

İşte bu kütüphaneleri içeren arşiv:harici_kütüphaneler.

Not : Bu, ilgili resmi sitelerden indirdiğimiz kütüphanelerin bir derlemesidir. Kütüphanelerin gerçekte nasıl çalıştığı veya bilgisayarınızı nasıl etkilediği konusunda herhangi bir sorumluluk kabul etmiyoruz.

Izgara Görünümü #

GridView, OpenGL ile geliştirilmiş basit bir duman efektidir. \samples\GridView dizininde yer almaktadır.

Önkoşullar:

Bu örneği oluşturmak için, tüm harici kütüphanelerin GridView/external_libs klasöründe bulunması gerekir .

Yapım aşamaları:

Tüm harici kütüphaneleri GridView/external_libs klasörüne yerleştirin .
İhtiyaçlarınıza en uygun proje dosyalarını oluşturmak için CMake’i kullanın. Lütfen Phoenix API sürümünüz tarafından kullanılan C++ Platform Araç Setini dikkate alın. Phoenix FD API Kullanımı bölümüne bakın.
PHOENIX_SDK_DIR’i Phoenix API’ye ayarlayın, örneğin “C:\Program Files\Chaos Group\Phoenix FD\3ds Max NNNN for x64\SDK”.
Proje dosyalarını oluşturun ve derleyin.

CSVParçacıkları #

CSVParticles, Phoenix *.aur dosyalarında depolanan parçacık gruplarını Thinkbox Krakatoa ™ tarafından tanınan *.csv dosyalarına ( CSV Dosya Biçimi ) aktarır.

Önkoşullar:

Bu örneği oluşturmak için, tüm harici kütüphanelerin CSVParticles/external_libs klasöründe bulunması gerekmektedir .

Yapım aşamaları:

Tüm harici kütüphaneleri CSVParticles/external_libs klasörüne yerleştirin .
İhtiyaçlarınıza en uygun proje dosyalarını oluşturmak için CMake’i kullanın. Lütfen Phoenix API sürümünüz tarafından kullanılan C++ Platform Araç Setini dikkate alın. Phoenix API Kullanımı bölümüne bakın.
PHOENIX_SDK_DIR’i Phoenix API’ye ayarlayın, örneğin “C:\Program Files\Chaos Group\Phoenix FD\3ds Max NNNN for x64\SDK”.
Proje dosyalarını oluşturun ve derleyin.