# lv_gltf_model.h (/api/libs/gltf/gltf_data/lv_gltf_model_h)
Functions [#functions]
lv_gltf_model_set_animation_speed [#lv_gltf_model_set_animation_speed]
Set the animation speed ratio
The actual ratio is the value parameter / LV\_GLTF\_ANIM\_SPEED\_NORMAL Values greater than LV\_GLTF\_ANIM\_SPEED\_NORMAL will speed-up the animation Values less than LV\_GLTF\_ANIM\_SPEED\_NORMAL will slow down the animation
```c title=" " lineNumbers=1
void lv_gltf_model_set_animation_speed(lv_gltf_model_t *model, uint32_t value)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ------------------------------- |
| `model` | | pointer to a glTF model |
| `value` | | speed-up ratio of the animation |
lv_gltf_model_get_image_count [#lv_gltf_model_get_image_count]
Get the number of images in the glTF model.
Images in glTF are used as sources for textures and can be stored either as external files or embedded as base64-encoded model within the glTF file.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_image_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of images in the model
lv_gltf_model_get_texture_count [#lv_gltf_model_get_texture_count]
Get the number of textures in the glTF model.
Textures define how images are sampled and applied to materials. Each texture references an image and may specify sampling parameters like filtering and wrapping modes.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_texture_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of textures in the model
lv_gltf_model_get_material_count [#lv_gltf_model_get_material_count]
Get the number of materials in the glTF model.
Materials define the visual appearance of mesh primitives, including properties like base color, metallic/roughness values, normal maps, and other surface characteristics.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_material_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of materials in the model
lv_gltf_model_get_camera_count [#lv_gltf_model_get_camera_count]
Get the number of cameras in the glTF model.
Cameras define viewpoints within the 3D scene and can be either perspective or orthographic. They are typically attached to nodes in the scene graph.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_camera_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of cameras in the model
lv_gltf_model_get_mesh_count [#lv_gltf_model_get_mesh_count]
Get the number of meshes in the glTF model.
Meshes contain the geometric model for 3D objects, including vertex positions, normals, texture coordinates, and indices. Each mesh can have multiple primitives with different materials.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_mesh_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of meshes in the model
lv_gltf_model_get_scene_count [#lv_gltf_model_get_scene_count]
Get the number of scenes in the glTF model.
Scenes define the root nodes of the scene graph. A glTF file can contain multiple scenes, though typically only one is designated as the default scene to be displayed.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_scene_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of scenes in the model
lv_gltf_model_get_animation_count [#lv_gltf_model_get_animation_count]
Get the number of animations in the glTF model.
Animations define keyframe-based motion for nodes in the scene, including transformations like translation, rotation, and scaling over time.
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_animation_count(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ---------------------------------------- |
| `model` | | Pointer to the glTF model data structure |
**Returns:** — Number of animations in the model
lv_gltf_model_get_animation [#lv_gltf_model_get_animation]
Get the current selected animation. To see if it's playing see `lv_gltf_model_is_animation_paused`
```c title=" " lineNumbers=1
size_t lv_gltf_model_get_animation(lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ----------------------------------- |
| `model` | | Pointer to the glTF model structure |
lv_gltf_model_get_animation_speed [#lv_gltf_model_get_animation_speed]
Get the animation speed ratio
The actual ratio is the return value / LV\_GLTF\_ANIM\_SPEED\_NORMAL
```c title=" " lineNumbers=1
uint32_t lv_gltf_model_get_animation_speed(const lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------------- | ----------------------- |
| `model` | | pointer to a glTF model |
lv_gltf_data_load_from_file [#lv_gltf_data_load_from_file]
Load a glTF model from a file
```c title=" " lineNumbers=1
lv_gltf_model_t * lv_gltf_data_load_from_file(const char *file_path, lv_gltf_model_loader_t *loader)
```
Parameters
| Name | Type | Description |
| ----------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `file_path` | `const char *` | path to the glTF file to load |
| `loader` | | pointer to the glTF model loader instance, or NULL to create a new one |
**Returns:** — pointer to the loaded glTF model, or NULL on failure
If loader is NULL, an internal loader will be created and managed automatically
lv_gltf_data_load_from_bytes [#lv_gltf_data_load_from_bytes]
Load a glTF model from a byte array
```c title=" " lineNumbers=1
lv_gltf_model_t * lv_gltf_data_load_from_bytes(const uint8_t *data, size_t data_size, lv_gltf_model_loader_t *loader)
```
Parameters
| Name | Type | Description |
| ----------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `data` | | pointer to the glTF data buffer |
| `data_size` | | size of the data buffer in bytes |
| `loader` | | pointer to the glTF model loader instance, or NULL to create a new one |
**Returns:** — pointer to the loaded glTF model, or NULL on failure
If loader is NULL, an internal loader will be created and managed automatically
lv_gltf_model_delete [#lv_gltf_model_delete]
Delete a glTF model
```c title=" " lineNumbers=1
void lv_gltf_model_delete(lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ------------------------ |
| `model` | | the gltf model to delete |
lv_gltf_model_play_animation [#lv_gltf_model_play_animation]
Select and start playing an animation.
```c title=" " lineNumbers=1
lv_result_t lv_gltf_model_play_animation(lv_gltf_model_t *model, size_t index)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ----------------------------------- |
| `model` | | Pointer to the glTF model structure |
| `index` | | Animation number to start playing |
**Returns:** — LV\_RESULT\_OK if the animation was started else LV\_RESULT\_INVALID
lv_gltf_model_pause_animation [#lv_gltf_model_pause_animation]
Pause the current animation.
```c title=" " lineNumbers=1
void lv_gltf_model_pause_animation(lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ----------------------------------- |
| `model` | | Pointer to the glTF model structure |
lv_gltf_model_is_animation_paused [#lv_gltf_model_is_animation_paused]
Check if an animation is currently being played.
```c title=" " lineNumbers=1
bool lv_gltf_model_is_animation_paused(lv_gltf_model_t *model)
```
Parameters
| Name | Type | Description |
| ------- | -------------------------------------------------------------- | ----------------------------------- |
| `model` | | Pointer to the glTF model structure |
Dependencies [#dependencies]