Loading

/ Core / Scenes / Serialization / Loading
Function in ldk_scene.h

ldk_scene_from_tml

Loads entities and components from a TML string into the current ECS. This function does not clear existing entities and does not roll back entities created before an error. A caller performing a full scene replace is responsible for clearing the ECS before the call and after a failed call.

LDK_API bool ldk_scene_from_tml(
 const char *source,
 LDKSceneResult *result
);

Parameters

const char *source
Source object or source data for this operation.
LDKSceneResult *result
Optional result structure populated with error details.

Returns

True if the operation succeeds; false otherwise.

Function in ldk_scene.h

ldk_scene_load_tml_file

Reads a TML file and loads it into the current ECS. This function has the same ECS ownership semantics as ldk_scene_from_tml().

LDK_API bool ldk_scene_load_tml_file(
 const char *path,
 LDKSceneResult *result
);

Parameters

const char *path
Path identifying the file or resource.
LDKSceneResult *result
Optional result structure populated with error details.

Returns

True if the operation succeeds; false otherwise.