6.8 KiB
6.8 KiB
Product and screen spec
UI language: English (prepare for localisation; Hungarian likely next). Dark UI everywhere: capture happens in daylight but the app is also used next to the telescope at dusk. Phone portrait only. No fake status bar: respect safe areas.
Flow
Sites ──New survey──▶ Setup ──Start capture──▶ Capture ──Finish──▶ Review ──Export──▶ Export
▲ └─tap finished site──────────────────────────────────────────▶ Review
│ └─tap in-progress site──────────────▶ Capture (resume)
└──────────────── close (X) from Capture / back from Setup
Data model (per site): name, location (lat, lon, elevation, GPS accuracy), north settings (declination, user offset), recorded session (frames + sensor stream), sky mask edits, derived horizon profile (alt per 1° az), export settings (margin, chosen formats).
1 · Sites (design/screens/01-sites.png)
Home screen listing surveyed sites.
- Header: title "Horizons", subtitle "Artificial horizons for NINA & Stellarium", settings icon button (44 px).
- Overline "SITES · n".
- Site card (tap opens Review for complete sites, Capture to resume in-progress ones):
- Name (19/600), coordinates in mono (12), chevron.
- Horizon sparkline: area + line of the profile, 0–40° altitude, x = azimuth 0–360 with N E S W N labels under it.
- Footer: "24 frames · full 360°" and chips for formats already exported (NINA, Stellarium) with a check icon.
- In-progress variant: "In progress" amber badge, sparkline only up to the covered azimuth with the remainder dashed, progress bar, "210° of 360° covered", "Continue survey" link.
- Bottom, fixed: primary "New horizon survey" (56 px, amber) and secondary "Import existing .hrz" (48 px, outline). Import parses a NINA file into a profile-only site (no panorama).
2 · Setup (02-setup.png)
- Back, title "New survey".
- Site name text input (prefilled with a suggestion).
- Location row: pin icon, lat/lon in mono, "112 m · GPS ±4 m", Refresh button. Allow manual edit on long-press (not drawn).
- North row: compass icon, "North from compass", "Declination +5.6° applied automatically". Declination comes from a magnetic model (WMM) evaluated at the GPS position and date, inside the core.
- "How to capture" illustration (ring around the phone, highlighted band, "sky not needed") and three numbered steps:
- Stand where the telescope stands.
- Hold the phone upright, tilted slightly above the horizon.
- Turn once around slowly. Frames are taken automatically.
- Bottom primary: "Start capture". Request camera, motion/orientation and location permissions here (iOS web requires a user gesture for
DeviceOrientationEvent.requestPermission()).
3 · Capture (03-capture.png)
Full-bleed camera preview (top 610 px), control panel below.
- Top bar over the camera: close (X → back to Sites, keeps progress), title chip "Backyard pier / frame 10 of 24", undo button (retake last frame).
- Panorama progress strip under the top bar: 24 cells over 0–360° with N E S W N labels. Captured part shows a mini preview of the detected silhouette; the next cell is outlined in the accent colour.
- Hint chip: "Turn right until the dot is in the circle" (auto mode) or "Line up the dot, then tap the shutter" (manual mode).
- Live sky edge: the detected sky/obstruction boundary is drawn as an accent line on the preview, so the user sees what will become transparent.
- Targeting: fixed white circle in the centre. The accent dot shows where the next frame's target is, relative to the current orientation, with a dashed leader. When the dot is inside the circle, the tilt is within tolerance and the phone is steady, the frame is taken automatically (see ARCHITECTURE: auto-shutter).
- 0° horizon reference line with label (dashed).
- "Tree reaches the frame top at 125°" warning bar with "Add higher shot": shown when obstruction touches the top edge of a frame. It asks for one extra frame at that azimuth tilted higher (about +35°). Coverage then extends upward locally.
- Readouts: HEADING (true, degrees), TILT (target +10°, blue when within tolerance), COVERS (vertical coverage of the current frame, e.g. "−22…+42°").
- Controls: "Auto on/off" toggle (left), shutter (80 px ring, always usable manually), "Finish" (right, goes to Review; allowed with partial coverage, which is then shown as in-progress).
- Haptic tick on each auto capture. Keep the screen awake.
4 · Review (04a-review-nina-horizon.png, 04b-review-panorama-mask.png)
Two tabs. "NINA horizon" is the default.
NINA horizon tab
- Profile chart: x = azimuth 0–360 (N E S W N), y = altitude 0–40°. Filled area + solid accent line = detected sky edge. Dashed blue line = what is written to
.hrz(edge + margin). - Legend under the chart.
- Safety margin slider 0–5° in 0.5° steps (default +2.0°). Caption: "Keeps NINA targets clear of tree tips and compass error". Updates the dashed line live.
Panorama tab
- Zoomed panorama (pan and pinch): checkered = transparent sky, photo = obstruction, accent line = edge.
- Overview strip of the whole 360° with the viewport outlined (drag it to navigate).
- Legend: "Transparent sky in Stellarium".
- Mask tools: "Auto edge" (default; tap re-runs detection locally), "Paint sky", "Paint ground". Brush shows as a dashed circle; brush size by pinch or a later setting. Strokes are stored as edits, not baked pixels, so detection can be re-run.
Both tabs
- North offset row: −/+ in 0.5° steps, "Applies to .hrz and panorama". Rotates the whole result if a known object sits off.
- Primary "Export".
5 · Export (05a-export-hrz.png, 05b-export-landscape-ini.png)
- Subtitle summarises settings: "Backyard pier · margin +2.0° · north offset 0.0°".
- Format cards (checkbox + title + extension badge + description), selected card has an accent border:
- NINA custom horizon
.hrz, on by default. - Stellarium panorama
.zip, on by default if the panorama is complete: spherical landscape, 8192 × 2048 PNG with transparent sky. - Stellarium outline only
.zip, off by default: polygonal landscape.
- NINA custom horizon
- Preview with tabs
.hrz/landscape.ini(mono, scrollable). - Help text: "NINA: Options › General › Astrometry › Custom Horizon. Stellarium: install the .zip under Sky and viewing options › Landscape › Add/remove landscapes."
- Buttons: "Save" (to device files) and primary "Share n files" (system share sheet).
Copy and units
- Degrees with one decimal in readouts and files (
137.4°), azimuth 0–360 clockwise from true north. - Use the minus sign
−in UI, ASCII-in files. - Numbers in IBM Plex Mono, everything else in Barlow.