2.2 KiB
2.2 KiB
Image Player
Introduction
image_player is a lightweight and efficient image rendering component designed for embedded systems. It enables seamless integration of various image formats into your projects. This module ensures high performance and flexibility for modern embedded applications that require efficient image playback and rendering.
Dependencies
- ESP-IDF
Ensure your project includes ESP-IDF 5.0 or higher. Refer to the ESP-IDF Documentation for setup instructions.
Scripts
GIF to Split BMP Converter (gif_to_split_bmp.py)
This script converts GIF animations into a series of split BMP files optimized for embedded systems.
Usage
python gif_to_split_bmp.py <input_folder> <output_folder> --split <split_height> --depth <bit_depth> [--enable-huffman]
Parameters
input_folder: Directory containing GIF files to processoutput_folder: Directory where processed files will be saved--split: Height of each split block (must be a positive integer)--depth: Bit depth (4 for 4-bit grayscale, 8 for 8-bit color)--enable-huffman: Optional flag to enable Huffman compression (default: disabled)
Example
# Using only RLE compression
python gif_to_split_bmp.py ./gifs ./output --split 16 --depth 4
# Using both RLE and Huffman compression
python gif_to_split_bmp.py ./gifs ./output --split 16 --depth 4 --enable-huffman
GIF Merge Tool (gif_merge.py)
This script merges split BMP files into a single optimized asset file for embedded systems.
Usage
python gif_merge.py <input_dir>
Parameters
input_dir: Directory containing split BMP files to merge
Example
python gif_merge.py ./output
Features
- Automatically detects and handles duplicate frames
- Optimizes storage by referencing repeated frames
- Generates a single asset file with all frames
- Supports both 4-bit and 8-bit color depth
- Includes compression for efficient storage
- Supports both RLE and Huffman compression methods