Stats summary¶
| Garmin | Wear OS | Apple Watch | |
|---|---|---|---|
| Status | ✅ | ✅ | ⏳ |
| Code | source/views/StatsSummaryView.mc, source/ActionMenu.mc (:stats), source/TripStore.mc (trip totals) |
wear/…/presentation/views/OtherViews.kt (StatsSummaryView), wear/…/presentation/SailEverApp.kt (Screen.Stats), wear/…/data/TripStore.kt |
— |
Verified against code: 2026-10-11
Purpose¶
A two-page summary opened from Stats in the action menu / Controls page (menus.md). Page 1 compares the current track with the whole trip. Page 2 splits the current track into motored, sailed and motorsailed distance and time.
How the totals are counted (which seconds and miles go to which state): ../shared/calculations.md and recording.md.
Data¶
| Value | Meaning |
|---|---|
| Track distance | Distance of the current track so far, including before any pause |
| Track sailed | Distance in state SAIL |
| Track motored | Distance in state ENGINE |
| Track motorsailed | Distance in state MOTORSAIL |
| Track "eng" / "Engine" | Track motored + track motorsailed |
| Trip distance / sailed / motored | Totals of the trip's stopped tracks (motored = engine + motorsail) plus the current track |
| Motored / sailed / motorsailed time | Unpaused seconds of the current track in that state |
Stationary states add time to none of the rows.
Layout¶
Both pages are black. Positions are fractions of screen width (x) and height (y). Text is anchored at its top edge (not vertically centred).
Shared elements¶
| Element | Position | Font / size | Colour | Content & format |
|---|---|---|---|---|
| Title | x 0.50, y 0.09, centred | FONT_TINY |
White | Page 1 Summary, page 2 Track Details |
| Column headers | y 0.24, centred on each column x | FONT_XTINY |
Light grey 0xAAAAAA |
See each page |
| Row key | x 0.10, left-aligned, at the row's y | FONT_XTINY |
Row colour | See each page |
| Row values | centred on each column x, at the row's y | FONT_XTINY |
Row colour (same as the key) | See each page |
| Page indicator | x 0.50, y 0.78, centred | FONT_XTINY |
Light grey 0xAAAAAA |
1 / 2 or 2 / 2 |
Page 1: track vs trip (trip has stopped tracks)¶
Shown when the trip already has at least one stopped track. Column x: TRACK 0.35, TRIP 0.68.
| Row y | Key | Colour | TRACK | TRIP |
|---|---|---|---|---|
| 0.24 | — | Light grey | TRACK |
TRIP |
| 0.36 | Tot |
White | Track distance | Trip distance + track distance |
| 0.48 | Sail |
Sail blue 0x00AAFF |
Track sailed | Trip sailed + track sailed |
| 0.60 | eng |
Engine red 0xFF5555 |
Track motored + motorsailed | Trip motored + track motored + motorsailed |
Page 1: first track of the trip¶
Shown while the trip has no stopped track yet (the current track is its first). No columns; three centred lines in FONT_TINY:
| y | Colour | Content |
|---|---|---|
| 0.28 | White | Total: <d> nm |
| 0.42 | Sail blue 0x00AAFF |
Sailed: <d> nm |
| 0.56 | Engine red 0xFF5555 |
Engine: <d> nm (motored + motorsailed) |
Page 2: track details¶
Column x: NM 0.48, TIME 0.76.
| Row y | Key | Colour | NM | TIME |
|---|---|---|---|---|
| 0.24 | — | Light grey | NM |
TIME |
| 0.36 | Motored |
Engine red 0xFF5555 |
Track motored | Motored time |
| 0.48 | Sailed |
Sail blue 0x00AAFF |
Track sailed | Sailed time |
| 0.60 | Motorsail |
Motorsail orange 0xFFAA00 |
Track motorsailed | Motorsailed time |
Formats¶
- Distance
<d>: nautical miles without unit in the tables. One decimal below 10 (7.4), no decimals from 10 (23).0.0when there is none. - Time:
<h>h <mm>m, hours without leading zero, minutes two digits:0h 00m,2h 05m,14h 30m.
Behaviour¶
- The view opens on page 1.
- Values update every second while the track records.
- The track keeps recording while the stats are shown; alerts and auto-stats overlays can appear on top.
Inputs (page flip, back to the action menu / Controls page or the instruments): input.md (Other screens per platform).
Wear OS¶
The two pages are a vertical pager; they don't wrap.
Apple Watch¶
⏳ Two-page stats as here (port plan, Phase 3).
States and edge cases¶
- No distance yet: all distance cells show
0.0, all times0h 00m. - Long trips: trip values of 10 nm and more lose their decimal, so three- and four-digit miles still fit the column.
- First-track rule: the single-column layout depends on whether a track of this trip was stopped before, not on how many tracks will follow. After a discarded or crashed first track, the trip still counts as having no stopped track.
Known deviations¶
- Wear OS returns to the instruments, not to the Controls page, on swipe-back, and has no one-step exit like Garmin START (parity.md P8).