<!-- Markdown mirror of https://pinflag.io/features/on-course-hud — the canonical page is the HTML URL. -->

# On-Course HUD

> Canonical: https://pinflag.io/features/on-course-hud


The PinFlag HUD is a one-thumb, portrait heads-up display over native Apple satellite imagery. It frames every hole the same way, reads your lie from real geometry — including a neighbouring hole’s fairway — and tells you plainly when it can’t vouch for the ground you’re on.


*The PinFlag iOS app is in pre-release. Leave your email and we’ll tell you the moment it’s available.*


Every hole opens perfectly framed on Apple satellite imagery. Aim by panning the map under a fixed reticle; read carry and leave live; set today’s pin on the real green; and log shots with one gesture. The HUD knows your lie — even on a neighbouring hole’s fairway — and says so honestly when the map can’t vouch for the ground you’re on.


## Why it matters

- Distances alone don’t make decisions — position, lie, and pin context do.
- A display you can run with one thumb, mid-round, without breaking pace of play.
- Honesty when it matters: a dash instead of a confident wrong number.


## How it works

1. **Every hole, framed once** — A deterministic camera opens the hole tee-at-bottom, green-at-top, computed purely from verified tee and green geometry.
2. **Aim under the crosshair** — Pan the map; the reticle stays fixed. Carry to the aim and what it leaves to the pin update live.
3. **Set today’s pin** — Scroll the green under the crosshair and tap Done — pin placement is clamped to the real green polygon.
4. **Play with awareness** — GPS position, lie classification, penalty confirmation, and per-hole navigation ride along as you play.


## Everything On-Course HUD does

- Set-once hole framing — tee at the bottom, green at the top, every time
- Pan-to-aim with a fixed crosshair; taps never hijack the camera
- Live carry and leave readouts; front/center/back green yardages from the real green ring
- Set today’s pin — clamped to the real green polygon
- GPS lie and position awareness, including cross-hole lie classification
- Lie-support disclosure: no geometric basis, no number — a dash instead
- User-confirmed penalty flow — water is never auto-penalised
- Tournament mode: every advice-class aid off for the round, by design
- One-tap 3D flyover of the hole, and straight back to your exact 2D aim
- Honest environmental dashes — no invented wind or elevation numbers

## Who it’s for

Players who want a real on-course instrument: tournament golfers (there’s a mode for that), fast players who log with one thumb, and anyone who has been burned by a confident number over ground the map didn’t actually know.


## What’s different

- Tournament mode turns every advice-class aid off for the round — by design, not by omission.
- Cross-hole lie classification: hit onto the neighbouring fairway and the HUD still knows.
- No invented environment: with no wind or elevation model shipped, those readouts are dashes.
- A camera that never fights you — taps never hijack the view.

## Frequently asked questions

### Is PinFlag legal in tournaments?

PinFlag ships a Tournament mode that keeps distances on and turns advice-class aids off for the entire round. Always confirm the specific rules in force for your competition.

### Does PinFlag use Apple Maps?

On iOS the on-course map is a native Apple MKMapView rendering satellite imagery — a real native map, not a web map in disguise.

### Does PinFlag have 3D course views?

Yes — a one-tap 3D flyover of the hole, which returns you to your exact 2D aim when you exit.

### What happens when GPS is weak?

You place the ball by hand and the position is honestly tagged “Adjusted.” Implausible fixes are refused outright rather than scored.

### Does the app add penalties automatically?

No. Water and drops are user-confirmed — you drag to a playable drop and the penalty is logged as exactly one stroke.
