png2lvgl-0.2.3 is not a library.

png2lvgl

Convert PNG images to LVGL C arrays with support for multiple color formats.

Features

🎨 Multiple color format support (True Color, Indexed, Alpha)
🚀 Fast and efficient Rust implementation
📦 Zero runtime dependencies in generated C code
🔧 Automatic format detection
💾 Safe file handling (no accidental overwrites)

Installation

Cargo (Recommended)

cargo install png2lvgl

Homebrew (macOS)

# Add the tap
brew tap metaneutrons/tap

# Install png2lvgl
brew install png2lvgl

Pre-built Binaries

Download the latest release for your platform from GitHub Releases.

From Source

cargo install --git https://github.com/metaneutrons/png2lvgl

Usage

# Basic usage (auto-detects format, defaults to LVGL 9.0)
png2lvgl input.png

# Target LVGL 8.x
png2lvgl input.png --lvgl-v8

# Specify output file
png2lvgl input.png -o output.c

# Use 4-bit indexed grayscale (16 colors)
png2lvgl input.png -f indexed4

# Overwrite existing file
png2lvgl input.png --overwrite

LVGL Version Compatibility

png2lvgl supports both LVGL 8.x and 9.x APIs:

Flag	LVGL Version	Format Constants
`--lvgl-v9` (default)	LVGL 9.x	`LV_COLOR_FORMAT_RGB565`, `LV_COLOR_FORMAT_I4`, `LV_COLOR_FORMAT_A8`
`--lvgl-v8`	LVGL 8.x	`LV_IMG_CF_TRUE_COLOR`, `LV_IMG_CF_INDEXED_4BIT`, `LV_IMG_CF_ALPHA_8BIT`

Default: LVGL 9.x format constants are used if no flag is specified.

Example:

# For LVGL 9.x projects (default)
png2lvgl icon.png -o ui/icon.c

# For LVGL 8.x projects
png2lvgl icon.png --lvgl-v8 -o ui/icon.c

Supported Formats

Format	Description	Use Case
`true-color`	RGB565	Full color images
`true-color-alpha`	RGB565 + Alpha	Images with transparency
`true-color-chroma`	RGB565 + Chroma key	Transparent color key
`indexed1/2/4/8`	Palette (2/4/16/256 colors)	Small images, icons
`alpha1/2/4/8`	Alpha only (1/2/4/8 bit)	Masks, monochrome icons

Output Format

Generated C files are compatible with LVGL and include:

Proper header guards
Memory alignment attributes
Color palette (for indexed formats)
Image descriptor structure

Example output:

const lv_img_dsc_t my_image = {
  .header.cf = LV_IMG_CF_INDEXED_4BIT,
  .header.w = 540,
  .header.h = 960,
  .data_size = 259200,
  .data = my_image_map,
};

Building from Source

git clone https://github.com/metaneturons/png2lvgl
cd png2lvgl
cargo build --release

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

png2lvgl 0.2.3