Markus Zehnder
84455e9254
Automatically round decimal values for sensor.x and .y to an integer. Make fields optional which are not used in every sensor.
99 lines
2.5 KiB
Markdown
99 lines
2.5 KiB
Markdown
# 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,
|
|
"name": "SSD 4 usage",
|
|
"label": "storage_ssd4_usage",
|
|
"x": 400,
|
|
"y": 45,
|
|
"direction": 1,
|
|
"value": "35",
|
|
"minValue": 0,
|
|
"maxValue": 100,
|
|
"pic": "progress.png"
|
|
},
|
|
{
|
|
"mode": 3,
|
|
"name": "SSD 5 usage",
|
|
"label": "storage_ssd5_usage",
|
|
"x": 400,
|
|
"y": 106,
|
|
"direction": 1,
|
|
"value": "80",
|
|
"minValue": 0,
|
|
"maxValue": 100,
|
|
"pic": "progress.png"
|
|
},
|
|
{
|
|
"mode": 1,
|
|
"name": "SSD 4 temp",
|
|
"label": "storage_ssd4_temperature",
|
|
"x": 580,
|
|
"y": 70,
|
|
"direction": 1,
|
|
"value": "34",
|
|
"fontFamily": "HarmonyOS_Sans_SC_Bold",
|
|
"fontSize": 24,
|
|
"textAlign": "center",
|
|
"integerDigits": -1,
|
|
"decimalDigits": 0,
|
|
"unit": " ℃"
|
|
},
|
|
{
|
|
"mode": 1,
|
|
"name": "SSD 5 temp",
|
|
"label": "storage_ssd5_temperature",
|
|
"x": 580,
|
|
"y": 130,
|
|
"direction": 1,
|
|
"value": "35",
|
|
"fontFamily": "HarmonyOS_Sans_SC_Bold",
|
|
"fontSize": 24,
|
|
"textAlign": "center",
|
|
"integerDigits": -1,
|
|
"decimalDigits": 0,
|
|
"unit": " ℃"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
Progress image `"pic": "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
|