Fields
75 selectable fields across date/time, activity, body, system,
environment, weather and custom text, numbered to match
watchface.io/docs/datafields so the two catalogues line up. All four
slots (both top, both bottom) pick from the same table and the bottom
captions follow the selection. tools/gen_fields.py owns the table and
emits FieldTable.mc, settings.xml and both languages' strings, so those
cannot drift apart.
Fields.Ctx fetches each API at most once per draw, and only if some slot
asks -- the forecast, user profile and sensor history lookups are lazy.
The rest of that catalogue is deliberately absent: OpenWeatherMap and
StormGlass need network calls and user API keys, the per-sport weekly and
28-day aggregates come from a phone-side Garmin Connect integration rather
than any on-device API, and the app complications need those apps
installed. README section 7 lists what was left out and why.
Permissions
UserProfile and SensorHistory are now declared; without them resting heart
rate, VO2 max, pulse ox and body battery throw at runtime. Sensor turns
out to be rejected outright for type="watchface", so altitude and pressure
read from Activity.Info instead.
Always-on display
AMOLED devices need the lit-pixel count cut while asleep. drawAmbient
drops the band fill and the unlit ticks, dims what remains, hides the
complications, and walks the layout within +/-4 px per minute so nothing
burns in. Gated on requiresBurnInProtection, so MIP devices are untouched.
Icons
The comps' sunrise and weather icons have two- and three-pixel features.
Rebuilding them from circles and lines looked right at 454 px and turned to
mush at 280. They are now rasterised from the design paths once per screen
width and tinted with drawBitmap2(:tintColor) -- which needs
packingFormat="png", since a palettised source is refused at runtime.
Launcher icons are generated at the five sizes the devices ask for.
All 17 devices build; checked on fenix847mm and enduro3 in the simulator.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Vendor the watchface-kit into design/ and derive everything from it instead
of from hand-transcribed constants.
Geometry, from design/rebuild.py and the ink boxes of the traced SVG paths:
- ring ticks are annular sectors (fillPolygon), not radial lines
- top arc is 21 ticks at 6.5+4k, not 22 at 2+4k
- exact radii, tick widths, anchor dots, band and colon rectangles
- element positions taken from measured ink bounding boxes
Colour, generated by tools/gen_themes.py straight out of the comps:
- per-tick colour tables (21+21) replace 9/7 interpolated stops
- 11-stop vertical gradients on the time digits, drawn with clip banding
- per-element accent / value colours and per-theme unlit tick colour
Data: the design's sunrise and hi/lo fields turn out to be available after
all -- Weather.getSunrise and getDailyForecast both exist in SDK 9.1.0 --
so both are restored, and heart rate is added alongside them.
Bugs found on the way:
- Gregorian FORMAT_MEDIUM returns day_of_week/month as strings, so the
date band crashed on every update (caught in the simulator)
- Stats.battery is already 0-100, multiplying by 100 gave "4000%"
- moveBarLevel is an integer level 0..5, not a 0..1 ratio, so the move
bar arc was all-or-nothing
Also: all four field slots are configurable with labels that follow the
selection, temperature unit is a setting, on-face wording moved into
resources with a Simplified Chinese variant, and 24h/distance/temperature
now follow the watch. Fonts are chosen by measured cap height rather than
by ascent.
Verified in the Connect IQ simulator on fenix847mm and by compiling all
17 target devices.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
