Architecture
Fenix8V3View had grown to 632 lines mixing layout constants, font
metrics, icon drawing, data lookup and orchestration. Split into:
Layout the 500-canvas constants, scaling, font choice and text drawing
Icons the three bitmap icons plus the primitive glyphs
Settings every stored preference and its default, in one place
Fields unchanged in scope, but value() is now seven category
functions that each return null for ids they do not own --
the ids interleave, so dispatching on ranges does not work
View what is left: the drawing order
The view is down to 359 lines and no longer reaches for a property or a
font metric directly.
Verification
Added a harness that walks all 75 ids in the simulator and reports each
rendered value with its pixel width. It caught a real one: pushDistance
and pushes compile on every device but throw "Symbol Not Found" at
runtime on a fenix 8 -- they are wheelchair counters that only some
firmware carries. Every optional ActivityMonitor, UserProfile, Weather
and Activity member is now behind a `has` check.
The same run showed two date fields overflowing their slot, so long
values now step down a font size rather than running into the ring.
Always-on mode checked against the simulator's Always-On display mode:
band fill gone, unlit ticks gone, slots hidden, time and date dimmed.
Also: Chinese "Day Date" was missing its 日, since it built the string by
hand instead of going through the localised date format.
All 17 devices build.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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>
