Initial BeeOS simulator and asset pipeline

2026-08-25 20:29:05 +00:00
commit 7d4d683a8f
265 changed files with 16676 additions and 0 deletions
@@ -0,0 +1,43 @@
+# BeeOS Phase 7 Notes
+
+## Completed in this phase
+
+Phase 7 adds the first BeeOS asset conversion pipeline.
+
+New files:
+
+```text
+tools/convert_icons_for_lvgl.py
+beeos/core/asset_build.py
+beeos/generated/icons/icon_build_index.json
+beeos/generated/icons/bitmap_json/
+beeos/generated/icons/lvgl/
+beeos/generated/icons/previews/
+```
+
+## Why this matters
+
+The desktop simulator can use PNG icons, but the PineTime Pro firmware/LVGL port will need compact generated assets.
+
+Phase 7 creates an intermediate format:
+
+- compact JSON bitmap rows
+- packed 1-bit byte buffers
+- C header/source files
+- preview sheets
+
+## Not final LVGL descriptors yet
+
+The generated C files are firmware-friendly icon buffers, not full `lv_image_dsc_t` declarations yet.
+
+A future phase can wrap these buffers in LVGL-specific image descriptors once the exact LVGL version and color format are chosen.
+
+## Next possible phase
+
+Phase 8 should probably add:
+
+- actual LVGL image descriptor export option
+- theme export tool
+- watch face package runtime
+- HiveStore update simulation
+- app settings pages