Struct ImageConfig 

pub struct ImageConfig {
    pub lv_conf_dir: PathBuf,
    pub lvgl_include_dir: PathBuf,
    pub converter: PathBuf,
}

Build-time configuration for LVGL image asset compilation.

Fields

lv_conf_dir: PathBuf

Path to directory containing lv_conf.h.

lvgl_include_dir: PathBuf

Path to LVGL header root (directory containing lvgl.h).

converter: PathBuf

Path to LVGLImage.py converter script.

Implementations

impl ImageConfig

pub fn from_env() -> Self

Create config from environment.

• lv_conf_dir from DEP_LV_CONFIG_PATH env var
• lvgl_include_dir and converter discovered from the oxivgl_sys cargo git checkout or thirdparty fallback.

Panics

If DEP_LV_CONFIG_PATH is not set or LVGL source tree not found.

pub fn image_asset(&self, name: &str, png_path: &str)

Convert a PNG to an LVGL C image source, compile it, and link it.

• name: C symbol name (e.g. "cogwheel"). Must be a valid C identifier.
• png_path: path to PNG file, relative to CARGO_MANIFEST_DIR.

Color format is derived from LV_COLOR_DEPTH in lv_conf.h.

Build requirements

Python 3 with pypng and lz4 packages.

Panics

• PNG file not found
• LVGLImage.py exits non-zero
• cc compilation fails