mirror of https://github.com/espruino/BangleApps
|
||
---|---|---|
.. | ||
img | ||
ChangeLog | ||
README.md | ||
app.png | ||
interface.html | ||
lib.js | ||
metadata.json | ||
screenshot.png | ||
settings.js |
README.md
Clock Backgrounds
This app provides a library (clockbg
) that can be used by clocks to
provide different backgrounds for them.
Usage
By default the app provides just a red/green/blue background but it can easily be configured.
You can either:
- Go to the Clock Backgrounds app in the App Loader and upload backgrounds
- Go to the
Backgrounds
app on the Bangle itself, and choose between solid color, random colors, or any uploaded images.
Usage in code
Just use the following to use this library within your code:
// once at the start
let background = require("clockbg");
// to fill the whole area
background.fillRect(Bangle.appRect);
// to fill just one part of the screen
background.fillRect(x1, y1, x2, y2);
You should also add "dependencies" : { "clockbg":"module" },
to your app's metadata to
ensure that the clock background library is automatically loaded.
Features to be added
This library/app is still pretty basic right now, but a few features could be added that would really improve functionality:
- Support for >1 image, and choosing randomly between them
- Support for gradients (random colors)
- Storing 'clear' areas of uploaded images so clocks can easily position themselves