ldk_scene_manager_load
Replaces all current ECS contents with the registered scene at index.
During an engine update the request is deferred to the safe frame boundary.
A successful deferred request returns the target descriptor, but current()
continues to report the old scene until the switch completes. Failures
during deferred execution are logged. A failed target preflight leaves the
old scene running; a failure after replacement begins ends the session.
LDK_API const LDKScene * ldk_scene_manager_load(
LDKSceneManager *manager,
u32 index,
LDKSceneResult *result
);
Parameters
LDKSceneManager *manager- Asset manager that owns or resolves the asset.
u32 index- Zero-based index of the selected item.
LDKSceneResult *result- Optional result structure populated with error details.
Returns
Pointer to the requested object or data; NULL when unavailable.
ldk_scene_manager_load_next
Loads the catalog entry immediately after the current scene.
LDK_API const LDKScene * ldk_scene_manager_load_next(
LDKSceneManager *manager,
LDKSceneResult *result
);
Parameters
LDKSceneManager *manager- Asset manager that owns or resolves the asset.
LDKSceneResult *result- Optional result structure populated with error details.
Returns
Pointer to the requested object or data; NULL when unavailable.
ldk_scene_manager_load_path
Loads a registered path, with the same deferred semantics as load().
LDK_API const LDKScene * ldk_scene_manager_load_path(
LDKSceneManager *manager,
const char *path,
LDKSceneResult *result
);
Parameters
LDKSceneManager *manager- Asset manager that owns or resolves the asset.
const char *path- Path identifying the file or resource.
LDKSceneResult *result- Optional result structure populated with error details.
Returns
Pointer to the requested object or data; NULL when unavailable.
ldk_scene_manager_unload
Removes all current ECS contents and clears current_scene.
LDK_API bool ldk_scene_manager_unload(LDKSceneManager *manager);
Parameters
LDKSceneManager *manager- Asset manager that owns or resolves the asset.
Returns
True if the operation succeeds; false otherwise.