Assets to Firmware

How PNG artwork becomes native C data, an LVGL descriptor and part of the firmware image.

Conversion pipeline

text

PNG or generated image
  → validation and device-aware preprocessing
  → native C byte array
  → LVGL image descriptor
  → CMake source registration
  → compiled firmware image

Dimensions, alpha and fitting

ForgeUI records intrinsic dimensions, validates required state artwork and uses contain-fit geometry so technical UI images preserve their aspect ratio. Alpha metadata is used by visible-artwork fitting; generated descriptors provide native dimensions to LVGL.

Runtime consequences

—No runtime filesystem is required for generated image assets.
—No external image-conversion dependency runs on the device.
—Assets increase application and flash size because pixel data is compiled into firmware.
—Large or numerous ARGB8888 assets should be reviewed against partition and flash constraints.