Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides information on the Chaos Phoenix application programming interface (API).

Overview

...

The Chaos Phoenix FD API is included with the installation of Phoenix FD for Autodesk® Maya®. It provides C++ API for several different purposes:

  • Loading of grid and particle data stored in AUR, VDB or F3D cache files.
  • Runtime access to different Phoenix nodes, allowing you to prepare them for rendering on demand, start and stop a simulation, access the parameters of different nodes, load and save presets.
  • Access to the Phoenix FD color gradients and diagram curves, allowing you to embed them in your own application.

 

Installation

...

Phoenix FD API is normally installed in the folder C:\Program Files\Chaos Group\Phoenix FD\Maya NNNN for x64\SDK where NNNN is the version of Maya (2020, 2019, etc).

 

Structure

...

The Phoenix FD API includes the following folders:

Fancy Bullets
typecircle
  • \include – Contains the header files needed to interface with Phoenix FD API.
  • \lib – Contains the Phoenix FD API binaries for both static and dynamically linked versions of the Phoenix FD API. 
  • \samples Contains example projects that use different functions of the Phoenix FD API.

 

Anchor
UsingPhoenixFDSDK
UsingPhoenixFDSDK

Using the Phoenix

...

API

...

The Phoenix FD API is provided as a static and dynamic library. Depending on your project, you may pick the static or dynamic version of the library. Usually the dynamic version is preferred when there is a dependency to any version of V-Ray SDK, as Phoenix FD API API depends on vutils_s.lib.

Using Phoenix FD API as a static library requires:

Fancy Bullets
typecircle
  • \lib\aurloader_s.lib and \lib\vutils_s.lib to be added as an additional dependency to the linker.

Using Phoenix FD API API as a dynamic library requires:

...

Depending on the version of Maya, Phoenix FD API is built with the respective version of Microsoft Visual C++ Runtime:

...

With "/MD" Runtime Library flag.


Samples

...

The Phoenix FD API comes with two code sample projects: GridView and CSVParticles.

...

See the License Agreements and Copyrights page for copyright notices.

...

Fancy Bullets
typecircle
  • Place all external libraries in GridView/external_libs
  • Use CMake to generate project files that best suite you needs. Please take in account the C++ Platform Toolset that is used by your version of Phoenix FD API. See the Using Phoenix FD API section.
  • Set PHOENIX_SDK_DIR to Phoenix FD API, for example C:\Program Files\Chaos Group\Phoenix FD\Maya NNNN for x64\SDK.
  • Generate the project files and build.

...

CSVParticles exports particle groups stored in Phoenix FD Phoenix *.aur files to *.csv recognized by Thinkbox Krakatoa (http://www.thinkboxsoftware.com/krak-csv-file-format/).

...

Fancy Bullets
typecircle
  • Place all external libraries in the folder CSVParticles/external_libs.
  • Use CMake to generate project files that best suite you needs. Please take in account the C++ Platform Toolset that is used by your version of Phoenix FD API. See the Using Phoenix FD API section.
  • Set PHOENIX_SDK_DIR to Phoenix FD API, for example C:\Program Files\Chaos Group\Phoenix FD\Maya NNNN for x64\SDK.
  • Generate the project files and build.

...