Workflow 1 · Single still photo ≈ 2 min

The simplest way to produce a dot map. Best when you only need to capture one moment of a play.

1. Load Image in the toolbar, pick your photo.
2. 01 Landmarks — confirm the pitch size at top of the sidebar, then mark 4+ known field points (corners, halfway-line intersections, penalty-box corners, centre spot). Click Map the Field.
3. 02 Players — auto-detected dots appear. Drag any that landed wrong, Right-click to remove false positives, and click Start Adding Players for any the detector missed (including the ball — switch Add Player As to Ball). Adjust team colours in the Match Settings panel.
4. 03 Diagram — stacked view: interactive top-down pitch on top, source photo underneath for comparison. Drag any dot to fine-tune its field position. Pick the attacking direction, then Export PDF.

Output: letter-size PDF at ~/Documents/DotMapper/.

Workflow 2 · Multiple stills from one video ≈ 5–10 min

You want several standalone dot maps from the same match — e.g. one per goal, corner, or set-piece — but they don't need to animate together. Calibration carries forward so you only mark landmarks once.

1. Load Video in the toolbar. The scrubber panel opens.
2. Scrub to a moment you care about → Capture Frame (grabs one still). Repeat for each moment. Each grab appears as a thumbnail in the Captured strip.
3. Click Process Queue → to load the first captured frame. Run Workflow 1 on it (landmarks → map → players → diagram → Export PDF).
4. Use the toolbar's ‹ 1/N › arrows to move to the next frame. With INHERIT on (default), landmarks and homography carry forward — you just confirm and move on. Export each as its own PDF.

Tip: Video Frames button reopens the scrubber any time you want to grab more clips without losing your work. Progress is saved automatically per video.

Workflow 3 · Animated 3-clip sequence ≈ 10–15 min

A short animated GIF showing player movement across a play. Most involved — you manually map each of the 3 frames — but produces a shareable motion asset.

1. Load Video, scrub to the start of the play you want to animate.
2. Click Capture Sequence ▶▶ — pulls 3 frames spaced 2 seconds apart (a 4-second window). Precise, server-side decoded from the source FPS.
3. Process Queue → opens the first frame. Calibrate it (landmarks → Map the Field), then place / confirm player dots for the initial formation. Labels auto-assign: Team A 1–11, Team B A–L (no I), Ref R.
4. Click the › arrow (or Next). The next frame loads with all your previous players carried over as draggable dots with amber halos; a faint B&W overlay of the previous frame shows each player's prior position for context. Drag each dot to where the player is now — the halo clears as you confirm. Labels stay stable.
5. Repeat for frame 3. When you've mapped all 3, click Export Sequence ▶ in the toolbar. Output is an animated GIF with eased motion between frames and a 2.5 s hold on the final formation — ready to share.

Mid-session? Quit any time. Everything saves to ~/Pictures/DotMapper/<video>/. Reload the same video to resume exactly where you left.

Keyboard & interaction

• Scroll zoom · Drag background to pan · F fit
• Shift+click (Players step) quick-adds a player
• Right-click any dot / landmark to remove
• Esc cancels an armed landmark or add-player mode