# lv_gltf_model_node.h (/api/libs/gltf/gltf_data/lv_gltf_model_node_h) Functions [#functions] lv_gltf_model_node_set_position_x [#lv_gltf_model_node_set_position_x] Set the X position of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_position_x(lv_gltf_model_node_t *node, float x) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `x` | `float` | The X position value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_position_y [#lv_gltf_model_node_set_position_y] Set the Y position of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_position_y(lv_gltf_model_node_t *node, float y) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `y` | `float` | The Y position value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_position_z [#lv_gltf_model_node_set_position_z] Set the Z position of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_position_z(lv_gltf_model_node_t *node, float z) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `z` | `float` | The Z position value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_rotation_x [#lv_gltf_model_node_set_rotation_x] Set the X component of a glTF model node's rotation quaternion. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_rotation_x(lv_gltf_model_node_t *node, float x) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `x` | `float` | The X rotation component value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_rotation_y [#lv_gltf_model_node_set_rotation_y] Set the Y component of a glTF model node's rotation quaternion. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_rotation_y(lv_gltf_model_node_t *node, float y) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `y` | `float` | The Y rotation component value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_rotation_z [#lv_gltf_model_node_set_rotation_z] Set the Z component of a glTF model node's rotation quaternion. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_rotation_z(lv_gltf_model_node_t *node, float z) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `z` | `float` | The Z rotation component value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_scale_x [#lv_gltf_model_node_set_scale_x] Set the X scale of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_scale_x(lv_gltf_model_node_t *node, float x) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `x` | `float` | The X scale value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_scale_y [#lv_gltf_model_node_set_scale_y] Set the Y scale of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_scale_y(lv_gltf_model_node_t *node, float y) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `y` | `float` | The Y scale value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_set_scale_z [#lv_gltf_model_node_set_scale_z] Set the Z scale of a glTF model node. The operation is queued and applied on the next rendering phase. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_set_scale_z(lv_gltf_model_node_t *node, float z) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `z` | `float` | The Z scale value | **Returns:** — LV\_RESULT\_OK if the operation is queued successfully, LV\_RESULT\_INVALID if node is null or no more memory to queue the operation lv_gltf_model_node_get_by_index [#lv_gltf_model_node_get_by_index] Get a glTF model node by its index. ```c title=" " lineNumbers=1 lv_gltf_model_node_t * lv_gltf_model_node_get_by_index(lv_gltf_model_t *data, size_t index) ``` Parameters | Name | Type | Description | | ------- | -------------------------------------------------------------- | ----------------------------------- | | `data` | | Pointer to the glTF model structure | | `index` | | The index of the node to retrieve | **Returns:** — Pointer to the glTF model node, or NULL if not found lv_gltf_model_node_get_by_numeric_path [#lv_gltf_model_node_get_by_numeric_path] Get a glTF model node by its numeric path. ```c title=" " lineNumbers=1 lv_gltf_model_node_t * lv_gltf_model_node_get_by_numeric_path(lv_gltf_model_t *data, const char *num_path) ``` Parameters | Name | Type | Description | | ---------- | -------------------------------------------------------------- | ---------------------------------------------------------- | | `data` | | Pointer to the glTF model structure | | `num_path` | `const char *` | The numeric path string of the node to retrieve (eg. ".0") | **Returns:** — Pointer to the glTF model node, or NULL if not found lv_gltf_model_node_get_by_path [#lv_gltf_model_node_get_by_path] Get a glTF model node by its path. ```c title=" " lineNumbers=1 lv_gltf_model_node_t * lv_gltf_model_node_get_by_path(lv_gltf_model_t *data, const char *path) ``` Parameters | Name | Type | Description | | ------ | -------------------------------------------------------------- | --------------------------------------- | | `data` | | Pointer to the glTF model structure | | `path` | `const char *` | The path string of the node to retrieve | **Returns:** — Pointer to the glTF model node, or NULL if not found lv_gltf_model_node_get_path [#lv_gltf_model_node_get_path] Get the path of a glTF model node. ```c title=" " lineNumbers=1 const char * lv_gltf_model_node_get_path(lv_gltf_model_node_t *node) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | **Returns:** `const char *` — The path string of the node, or NULL if node is invalid lv_gltf_model_node_get_ip [#lv_gltf_model_node_get_ip] Get the IP (internal pointer/identifier) of a glTF model node. ```c title=" " lineNumbers=1 const char * lv_gltf_model_node_get_ip(lv_gltf_model_node_t *node) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------------------------------ | ---------------------------------------- | | `node` | | Pointer to the glTF model node structure | **Returns:** `const char *` — The IP string of the node, or NULL if node is invalid lv_gltf_model_get_node_count [#lv_gltf_model_get_node_count] Get the number of nodes in the glTF model. Nodes form the scene graph hierarchy and can contain transformations, meshes, cameras, or other nodes as children. They define the spatial relationships between objects in the scene. ```c title=" " lineNumbers=1 size_t lv_gltf_model_get_node_count(const lv_gltf_model_t *model) ``` Parameters | Name | Type | Description | | ------- | -------------------------------------------------------------------- | ---------------------------------------- | | `model` | | Pointer to the glTF model data structure | **Returns:** — Number of nodes in the model lv_gltf_model_node_get_local_position [#lv_gltf_model_node_get_local_position] Get the local position of a glTF model node. Must be called from within an LV\_EVENT\_VALUE\_CHANGED callback. Local position is relative to the node's parent. This function is only valid when called from an event callback registered. See and ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_get_local_position(lv_event_t *e, lv_3dpoint_t *result) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `e` | | Pointer to the event structure from the callback | | `result` | | Pointer to structure to store the position (x, y, z) | **Returns:** — LV\_RESULT\_OK if successful, LV\_RESULT\_INVALID if called outside event callback or if parameters are null lv_gltf_model_node_get_world_position [#lv_gltf_model_node_get_world_position] Get the world position of a glTF model node. Must be called from within an LV\_EVENT\_VALUE\_CHANGED callback registered with world position enabled. World position is the absolute position in global scene coordinates. This function requires the event callback to be registered with as it involves complex matrix calculations that are computed on-demand. ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_get_world_position(lv_event_t *e, lv_3dpoint_t *result) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `e` | | Pointer to the event structure from the callback | | `result` | | Pointer to structure to store the position (x, y, z) | **Returns:** — LV\_RESULT\_OK if successful, LV\_RESULT\_INVALID if called outside event callback, world position not enabled, or if parameters are null lv_gltf_model_node_get_scale [#lv_gltf_model_node_get_scale] Get the scale of a glTF model node. Must be called from within an LV\_EVENT\_VALUE\_CHANGED callback. Returns the scale factors for each axis. This function is only valid when called from an event callback registered. See and ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_get_scale(lv_event_t *e, lv_3dpoint_t *result) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------- | --------------------------------------------------------------------------------- | | `e` | | Pointer to the event structure from the callback | | `result` | | Pointer to structure to store the scale (x, y, z) | **Returns:** — LV\_RESULT\_OK if successful, LV\_RESULT\_INVALID if called outside event callback or if parameters are null lv_gltf_model_node_get_euler_rotation [#lv_gltf_model_node_get_euler_rotation] Get the Euler rotation of a glTF model node. Must be called from within an LV\_EVENT\_VALUE\_CHANGED callback. Returns rotation as Euler angles in radians (x, y, z). This function is only valid when called from an event callback registered. See and ```c title=" " lineNumbers=1 lv_result_t lv_gltf_model_node_get_euler_rotation(lv_event_t *e, lv_3dpoint_t *result) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `e` | | Pointer to the event structure from the callback | | `result` | | Pointer to structure to store the rotation in radians (x, y, z) | **Returns:** — LV\_RESULT\_OK if successful, LV\_RESULT\_INVALID if called outside event callback or if parameters are null lv_gltf_model_node_add_event_cb [#lv_gltf_model_node_add_event_cb] Add an event callback to a glTF model node. ```c title=" " lineNumbers=1 lv_event_dsc_t * lv_gltf_model_node_add_event_cb(lv_gltf_model_node_t *node, lv_event_cb_t cb, lv_event_code_t filter_list, void *user_data) ``` Parameters | Name | Type | Description | | ------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `cb` | | The event callback function to add. Use to retrieve lv\_gltf\_node\_data\_t with the node's data. | | `filter_list` | | Event code filter for the callback | | `user_data` | `void *` | User data to pass to the callback | **Returns:** — Pointer to the event descriptor, or NULL if allocation failed lv_gltf_model_node_add_event_cb_with_world_position [#lv_gltf_model_node_add_event_cb_with_world_position] Add an event callback to a glTF model node with world position computation enabled. Use this only when world position is needed, as computing it is an expensive operation. ```c title=" " lineNumbers=1 lv_event_dsc_t * lv_gltf_model_node_add_event_cb_with_world_position(lv_gltf_model_node_t *node, lv_event_cb_t cb, lv_event_code_t filter_list, void *user_data) ``` Parameters | Name | Type | Description | | ------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `node` | | Pointer to the glTF model node structure | | `cb` | | The event callback function to add. Use to retrieve lv\_gltf\_node\_data\_t with the node's data. | | `filter_list` | | Event code filter for the callback | | `user_data` | `void *` | User data to pass to the callback | **Returns:** — Pointer to the event descriptor, or NULL if allocation failed Macros [#macros] LV_GLTF_ANIM_SPEED_TENTH [#lv_gltf_anim_speed_tenth] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_TENTH 100 ``` LV_GLTF_ANIM_SPEED_QUARTER [#lv_gltf_anim_speed_quarter] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_QUARTER 250 ``` LV_GLTF_ANIM_SPEED_HALF [#lv_gltf_anim_speed_half] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_HALF 500 ``` LV_GLTF_ANIM_SPEED_NORMAL [#lv_gltf_anim_speed_normal] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_NORMAL 1000 ``` LV_GLTF_ANIM_SPEED_2X [#lv_gltf_anim_speed_2x] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_2X 2000 ``` LV_GLTF_ANIM_SPEED_3X [#lv_gltf_anim_speed_3x] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_3X 3000 ``` LV_GLTF_ANIM_SPEED_4X [#lv_gltf_anim_speed_4x] ```c title=" " lineNumbers=1 #define LV_GLTF_ANIM_SPEED_4X 4000 ``` LV_GLTF_DEFAULT_CAMERA [#lv_gltf_default_camera] ```c title=" " lineNumbers=1 #define LV_GLTF_DEFAULT_CAMERA 0 ``` Dependencies [#dependencies]