# lv_lib_gif

**Repository Path**: liuzewen/lv_lib_gif

## Basic Information

- **Project Name**: lv_lib_gif
- **Description**: LVGL播放GIF图片插件
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-02-10
- **Last Updated**: 2023-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GIF decoder for LVGL

**This repository is merged into the lvgl repository. See https://docs.lvgl.io/master/libs/gif.html**

Allow to use of GIF images in LVGL from. 

Based on https://github.com/lecram/gifdec

## Get started
- Download or clone this repository
  - [Download from GitHub](https://github.com/lvgl/lv_lib_gif/archive/master.zip)
  - Clone: `git clone https://github.com/lvgl/lv_lib_gif.git`
- Include the library: `#include "lv_lib_gif/lv_gif.h"`

## Use GIF images from file
```c
lv_obj_t * img = lv_gif_create_from_file(parent, "S/path/to/example.gif");
```

## Use GIF images from flash
If the gif file stored in the flash as a C array: 
```c
extern const uint8_t example_gif_map[];  /*Use the example gif*/
lv_obj_t * img = lv_gif_create_from_data(parent, example_gif_map);
```
### Convert GIF files to C array
To convert a GIF file to byte values array use [LVGL's online converter](https://lvgl.io/tools/imageconverter). Select "Raw" color format and "C array" Output format.