Stillward DisplayIsland activities
The island is the pill at the top of each screen. An activity is how it shows one thing going on: a widget's items on the two sides of its small form and in its open panel, when it shows, and how the island itself moves. It is data only: words name what the program knows, buttons one of a closed list of actions, pictures come from the activity's own folder.
The easiest way to make one is the widget studio: on the Widgets page, Make a widget, then For the island. The studio lays the items out on the island's two forms, and Publish sends it to the Workshop with a picture the program draws.
The file
An activity is an activity.json beside its pictures. Every part is optional; one that moves the island alone, a glow or a liquid edge, carries no places at all.
| Field | Takes | What it does |
|---|---|---|
aura | object | A glow round the island. An activity may carry this alone. Version 2. |
compact | object | |
edge | object | The island's lower edge made to live, as a liquid. An activity may carry this alone, with no places. Version 2. |
expanded | object | |
family | segoe, bahnschrift, bahnschrift-narrow, montserrat, raleway, unbounded, oswald, exo, mono, cormorant, comfortaa, russo, wet-paint, spray-paint, glitch, stalinist, tektur, jura, rubik-mono | |
jelly | object | The island giving and springing back. An activity may carry this alone. Version 2. |
look | string | The name of the file's own look, when it carries others. Version 2. |
looks | a list | Other ways the activity may look, each picked on the Island page. Version 2. |
name | string | |
sheen | object | Light on the island's rim. An activity may carry this alone. Version 2. |
split | object | A second thing going on leaves the island as a drop on a liquid neck, and goes back into it the same way. Version 2. |
version | 1 to 2 | |
when | always, media.playing, rec.on, timer.on, preset.on, battery.charging, battery.low, game.on, call.on, download.on, shelf.on, agent.on | always; while something plays; while recording; while a timer runs; while a preset runs; while charging; while the battery is low. Shown in place of the island's own for the same thing. |
When it shows
when picks the moment, and an activity shows in place of the island's own for the same thing: always; while something plays; while recording; while a timer runs; while a preset runs; while charging; while the battery is low. Shown in place of the island's own for the same thing.
What an activity cannot do
It cannot run anything, reach the network or read a file outside its folder. It shows only what the program already knows: what is playing, a timer, a recording, the preset, the battery.
Checking and publishing
stillward-display.exe --check activity.json says whether the program takes it and what it left out. Your own activities have Publish on the Island page; the schema is at /schema/activity.json.