lightswitch: whitespace

master
Rob Pilling 2023-01-29 22:48:14 +00:00
parent bddef2ef0f
commit 1a97f2bf41
2 changed files with 31 additions and 31 deletions

View File

@ -1,6 +1,6 @@
# Light Switch Widget # Light Switch Widget
With this widget I wanted to create a solution to quickly en-/disable the LCD backlight and even change the brightness. With this widget I wanted to create a solution to quickly en-/disable the LCD backlight and even change the brightness.
In addition it shows the lock status with the option to personalize the lock icon with a tiny image. In addition it shows the lock status with the option to personalize the lock icon with a tiny image.
All touch and drag inputs related to this widget are cached/masked to prevent actions in the active app. All touch and drag inputs related to this widget are cached/masked to prevent actions in the active app.
@ -9,32 +9,32 @@ All touch and drag inputs related to this widget are cached/masked to prevent ac
--- ---
### Control ### Control
--- ---
* __On / off__ * __On / off__
Single touch the widget to en-/disable the backlight. Single touch the widget to en-/disable the backlight.
* __Change brightness__ _(can be disabled)_ * __Change brightness__ _(can be disabled)_
First touch the widget, then quickly touch the screen again and drag up/down until you reach your wished brigthness. First touch the widget, then quickly touch the screen again and drag up/down until you reach your wished brigthness.
* __Double tap to flash backlight__ _(can be disabled)_ * __Double tap to flash backlight__ _(can be disabled)_
By defaut you can double tap on the right side of your bangle to flash the backlight for a short duration. By defaut you can double tap on the right side of your bangle to flash the backlight for a short duration.
(While the backlight is active your bangle will be unlocked.) (While the backlight is active your bangle will be unlocked.)
* __Double tap to unlock__ _(disabled by default)_ * __Double tap to unlock__ _(disabled by default)_
If a side is defined in the app settings, your bangle will be unlocked if you double tap on that side. If a side is defined in the app settings, your bangle will be unlocked if you double tap on that side.
--- ---
### Settings ### Settings
--- ---
#### Widget - Change the apperance of the widget: #### Widget - Change the apperance of the widget:
* __Bulb col__ * __Bulb col__
_red_ / _yellow_ / _green_ / __cyan__ / _blue_ / _magenta_ _red_ / _yellow_ / _green_ / __cyan__ / _blue_ / _magenta_
Define the color used for the lightbulbs inner circle. Define the color used for the lightbulbs inner circle.
The selected color will be dimmed depending on the actual brightness value. The selected color will be dimmed depending on the actual brightness value.
* __Image__ * __Image__
__default__ / _random_ / _..._ __default__ / _random_ / _..._
Set your favourite lock icon image. (If no image file is found _no image_ will be displayed.) Set your favourite lock icon image. (If no image file is found _no image_ will be displayed.)
* _random_ -> Select a random image on each time the widget is drawn. * _random_ -> Select a random image on each time the widget is drawn.
#### Control - Change when and how to use the widget: #### Control - Change when and how to use the widget:
* __Touch__ * __Touch__
_on def clk_ / _on all clk_ / _clk+setting_ / _clk+launch_ / _except apps_ / __always on__ _on def clk_ / _on all clk_ / _clk+setting_ / _clk+launch_ / _except apps_ / __always on__
Select when touching the widget is active to en-/disable the backlight. Select when touching the widget is active to en-/disable the backlight.
* _on def clk_ -> only on your selected main clock face * _on def clk_ -> only on your selected main clock face
* _on all clk_ -> on all apps of the type _clock_ * _on all clk_ -> on all apps of the type _clock_
@ -42,32 +42,32 @@ All touch and drag inputs related to this widget are cached/masked to prevent ac
* _clk+launch_ -> on all apps of the types _clock_ and _launch_ * _clk+launch_ -> on all apps of the types _clock_ and _launch_
* _except apps_ -> on all apps of the types _clock_ and _launch_ and in the settings * _except apps_ -> on all apps of the types _clock_ and _launch_ and in the settings
* _always on_ -> always enabled when the widget is displayed * _always on_ -> always enabled when the widget is displayed
* __Oversize__ * __Oversize__
_0px_ / _1px_ / _..._ / __20px__ / _..._ / _50px_ _0px_ / _1px_ / _..._ / __20px__ / _..._ / _50px_
To make it easier to hit the widget, this value extends the touch area of the widget in all directions. To make it easier to hit the widget, this value extends the touch area of the widget in all directions.
* __Drag Delay__ * __Drag Delay__
_off_ / _50ms_ / _100ms_ / _..._ / __500ms__ / _..._ / _1000ms_ _off_ / _50ms_ / _100ms_ / _..._ / __500ms__ / _..._ / _1000ms_
Change the maximum delay between first touch and re-touch/drag to change the brightness or disable changing the brightness completely. Change the maximum delay between first touch and re-touch/drag to change the brightness or disable changing the brightness completely.
* __Min Value__ * __Min Value__
_1%_ / _2%_ / _..._ / __10%__ / _..._ / _100%_ _1%_ / _2%_ / _..._ / __10%__ / _..._ / _100%_
Set the minimal level of brightness you can change to. Set the minimal level of brightness you can change to.
#### Unlock - Set double tap side to unlock: #### Unlock - Set double tap side to unlock:
* __TapSide__ * __TapSide__
__off__ / _left_ / _right_ / _top_ / _bottom_ / _front_ / _back_ __off__ / _left_ / _right_ / _top_ / _bottom_ / _front_ / _back_
#### Flash - Change if and how to flash the backlight: #### Flash - Change if and how to flash the backlight:
* __TapSide__ * __TapSide__
_off_ / _left_ / __right__ / _top_ / _bottom_ / _front_ / _back_ _off_ / _left_ / __right__ / _top_ / _bottom_ / _front_ / _back_
Set double tap side to flash the backlight or disable completely. Set double tap side to flash the backlight or disable completely.
* __Tap__ * __Tap__
_on locked_ / _on unlocked_ / __always on__ _on locked_ / _on unlocked_ / __always on__
Select when a double tap is recognised. Select when a double tap is recognised.
* __Timeout__ * __Timeout__
_0.5s_ / _1s_ / _..._ / __2s__ / _..._ / _10s_ _0.5s_ / _1s_ / _..._ / __2s__ / _..._ / _10s_
Change how long the backlight will be activated on a flash. Change how long the backlight will be activated on a flash.
* __Min Value__ * __Min Value__
_1%_ / _2%_ / _..._ / __20%__ / _..._ / _100%_ _1%_ / _2%_ / _..._ / __20%__ / _..._ / _100%_
Set the minimal level of brightness for the backlight on a flash. Set the minimal level of brightness for the backlight on a flash.
--- ---
@ -81,7 +81,7 @@ All touch and drag inputs related to this widget are cached/masked to prevent ac
Examples in default light and dark theme. Examples in default light and dark theme.
| Lock | Heart | Invader | JS | Smiley | Skull | Storm | | Lock | Heart | Invader | JS | Smiley | Skull | Storm |
|:----:|:-----:|:-------:|:--:|:------:|:-----:|:-----:| |:----:|:-----:|:-------:|:--:|:------:|:-----:|:-----:|
| ![](images/image_lock.png) | ![](images/image_heart.png) | ![](images/image_invader.png) | ![](images/image_js.png) | ![](images/image_smiley.png) | ![](images/image_skull.png) | ![](images/image_storm.png) | | ![](images/image_lock.png) | ![](images/image_heart.png) | ![](images/image_invader.png) | ![](images/image_js.png) | ![](images/image_smiley.png) | ![](images/image_skull.png) | ![](images/image_storm.png) |

View File

@ -251,7 +251,7 @@
w = undefined; w = undefined;
} }
}); });
Bangle.on("lock", locked => { Bangle.on("lock", locked => {
var w = WIDGETS.lightswitch; var w = WIDGETS.lightswitch;
// set lcd brightness on unlocking // set lcd brightness on unlocking