What's New in Bifrost 2.13.0.0 SDK shipping with Bifrost 2.13.0.0 for Maya

Bifrost 2.13.0.0 SDK CMake files use CMake 3.20 and up.

Bifrost 2.13.0.0 SDK contains API breaking changes

Amino

Cpp

• Amino cancellation annotations have been deprecated. See Core below

Core

• Amino cancellation annotations have been deprecated. These annotations were signaling to Amino that a C++ operator was able to handle safely the cancellation signals.

• Now, C++ operators that wish to handle cancellation should use Amino's stop token.

• For example, C++ that were declaring

    void NODEDEF_DECL my_cpp_perator(
        /*... some parameters ...*/)
    AMINO_ANNOTATE("Amino::Node cancellation=safe"); // to handle Amino/Bifrost's cancellation

  should now pass to their node the Amino::StopToken const& stopTokenparameter

    void NODEDEF_DECL my_cpp_perator(
        /*... some parameters ...*/
        Amino::StopToken const& stop_token /* to handle Amino/Bifrost's cancellation */)
    AMINO_ANNOTATE("Amino::Node); 

• A stop token can be explicitly tested:

  if (stopToken.stopRequested()) { /* some cleanup and exit code*/ }

• A callback (same as std::stop_callback) can now be attached to an Amino::StopToken. See <...>/sdk/include/Amino/Core/StopToken.h

Bifrost

Geometry

• struct AMINO_ANNOTATE("Amino::Struct") TimelineInfo

  • New structure to pass to Bifrost information about the timeline (startFrame, endFrame, minFrame, maxFrame, frameStep). See <...>/sdk/include/Bifrost/Geometry/GeometryTypes.h

• Initial support of Flip Liquid Geometry objects (see <...>/sdk/include/Bifrost/Geometry/Primitives.h)

  • getFlipLiquidPrototype() // to use with Bifrost::Object::isA
  • populateFlipLiquid( Bifrost::Object& object) // to create a proper empty Flip Liquid.

Examples

• <...>/sdk/examples/ExecutorWatchpoint enhanced SDK example on how to use watch points.