set_and_transfer_context()

MAYAFLUX_API void MayaFlux::set_and_transfer_context

(

Core::Engine

instance

)

Replaces the default engine with a new instance.

Parameters

instance

New engine instance to use as default

Transfers state from the old engine to the new one if possible.

Warning

This function uses move semantics. After calling this function, the engine instance passed as parameter will be left in a moved-from state and should not be used further. This is intentional to avoid resource duplication and ensure proper transfer of ownership. Users should be careful to not access the moved-from instance after calling this function.

This function is intended for advanced use cases where custom engine configuration is required beyond what the standard initialization functions provide.

Definition at line 73 of file Core.cpp.

{
    bool is_same_instance = false;
 
    {
        std::lock_guard<std::recursive_mutex> lock(internal::engine_mutex);
        is_same_instance = (&instance == internal::engine_ref.get());
        if (internal::engine_ref && !is_same_instance && internal::engine_ref->is_running()) {
            internal::engine_ref->Pause();
        }
    }
 
    if (internal::engine_ref && !is_same_instance) {
        internal::engine_ref->End();
    }
 
    if (!is_same_instance) {
        std::lock_guard<std::recursive_mutex> lock(internal::engine_mutex);
        internal::engine_ref = std::make_unique<Core::Engine>(std::move(instance));
        internal::initialized = true;
    }
}

References MayaFlux::internal::engine_mutex, MayaFlux::internal::engine_ref, MayaFlux::internal::initialized, and instance.