feat: Initial support for fan-, progress-, & pointer-sensors (#8)

* feat: support progress, fan, pointer sensor types Initial implementation, not yet fully working. * only use one rendering layer per sensor type instead one per sensor Each layer uses > 1 MB and a panel can contain easily over 20 sensors! * support custom panels with --panels cli argument This includes one or more additional custom panels into the base configuration. Multiple --panels arguments are supported * update docs
2025-08-24 17:12:59 +02:00
parent e85d616da7
commit 98941a00fe
32 changed files with 1830 additions and 435 deletions
@@ -0,0 +1,112 @@
+# Sensor Mode 3 Progress
+
+A progress sensor crops a progress image based on the corresponding sensor value and alpha-blends it with the panel image.
+
+Sensor configuration fields:
+- `mode`: 3 (for progress)
+- `label`: label identifier, also used as sensor value data source identifier
+- `direction`: 1 = left to right, 2 = right to left, 3 = top to bottom, 4 = bottom to top
+- `x`, `y`: position on the panel
+- `pic`: progress image to crop and overlay
+- `minValue`, `maxValue`: clamp sensor value to this range
+
+## Example
+
+Example `panel.json` with two "progress" indicator sensor and the following (partial) background image in `img`:
+
+<img src="img/sensor_mode3_background.png" alt="sensor mode 3 background image example">
+
+The background image and sensor definitions are taken from the default system panel configuration in the AOOSTAR-X app.
+
+```json
+{
+  "name": "Progress test panel",
+  "img": "background.png",
+  "sensor": [
+    {
+      "mode": 3,
+      "type": 2,
+      "name": "SSD 4 usage",
+      "label": "storage_ssd4_usage",
+      "x": 400,
+      "y": 45,
+      "direction": 1,
+      "value": "35",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "fontColor": -1,
+      "textAlign": "center",
+      "minValue": 0,
+      "maxValue": 100,
+      "pic": "progress.png"
+    },
+    {
+      "mode": 3,
+      "type": 2,
+      "name": "SSD 5 usage",
+      "label": "storage_ssd5_usage",
+      "x": 400,
+      "y": 106,
+      "direction": 1,
+      "value": "80",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "fontColor": -1,
+      "textAlign": "center",
+      "minValue": 0,
+      "maxValue": 100,
+      "pic": "progress.png"
+    },
+    {
+      "mode": 1,
+      "type": 2,
+      "name": "SSD 4 temp",
+      "label": "storage_ssd4_temperature",
+      "x": 580,
+      "y": 70,
+      "direction": 1,
+      "value": "34",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "fontColor": -1,
+      "textAlign": "center",
+      "integerDigits": -1,
+      "decimalDigits": 0,
+      "unit": " ℃"
+    },
+    {
+      "mode": 1,
+      "type": 2,
+      "name": "SSD 5 temp",
+      "label": "storage_ssd5_temperature",
+      "x": 580,
+      "y": 130,
+      "direction": 1,
+      "value": "35",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "fontColor": -1,
+      "textAlign": "center",
+      "integerDigits": -1,
+      "decimalDigits": 0,
+      "unit": " ℃"
+    }
+  ]
+}
+```
+
+Progress image `"pic": "progress.png"`:
+
+![progress graphic](img/progress.png)
+
+The following graphic is rendered for progress example above:
+
+<img src="img/sensor_mode3.png" alt="sensor mode 3 example">
+
+
+## Known Issues
+
+Progress sensor rendering has been reverse engineered from the AOOSTAR-X app. Not all options are supported.
+
+- Work in progress, not yet fully tested
+- `widht`, `height` should be considered and auto-resized as for mode 4