diff --git a/CHANGELOG.md b/CHANGELOG.md index 52d6896..96cca1d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,13 @@ Notable changes to Wisp are recorded here. +## 2.6.5 - 2026-10-07 + +- Add an optional 3D lap-review map with recorded elevation and mouse controls for rotation, pan and zoom. Keep the existing 2D view. +- Add Shared space to compare two lap maps with the same color scale, focus either lap and move their cursors together or independently. +- Add power and torque channels, a color legend, contact markers and PNG export. Distinguish recorded object contacts from estimated possible contacts. +- Move lap-position controls above the map and add a resizable map area with a camera reset button. + ## 2.6.4 - 2026-10-06 - Improve HUD and Tune compatibility with Forza updates on Steam and Xbox PC. diff --git a/LICENSES/library-sources-distribution.json b/LICENSES/library-sources-distribution.json index 500f072..6b8823f 100644 --- a/LICENSES/library-sources-distribution.json +++ b/LICENSES/library-sources-distribution.json @@ -1,9 +1,9 @@ { "schemaVersion": 1, - "version": "2.6.4", + "version": "2.6.5", "archive": { - "filename": "Wisp-2.6.4-library-sources.zip", - "url": "https://github.com/Views2k/Wisp/releases/download/library-sources-2.6.4/Wisp-2.6.4-library-sources.zip", + "filename": "Wisp-2.6.5-library-sources.zip", + "url": "https://github.com/Views2k/Wisp/releases/download/library-sources-2.6.5/Wisp-2.6.5-library-sources.zip", "bytes": 879043478, "sha256": "6ee69a19f4b28c198c79f5f48b11a639bd7d6372b36f333c3ee4873aaf6d5ccc" } diff --git a/README.md b/README.md index 062d371..8241960 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ Supports Steam and Xbox app / Microsoft Store editions on Windows PC.

Versions before 2.4 can show delayed or choppy tachometer motion on NVIDIA systems when G-SYNC/VRR is enabled. I recommend updating to the latest release. - Download Wisp 2.6.4 · + Download Wisp 2.6.5 · Website · Changelog · Architecture

@@ -13,11 +13,11 @@ Buy Me a Coffee

-## Wisp 2.6.4 +## Wisp 2.6.5 -2.6.4 improves HUD and Tune compatibility with Forza updates on Steam and Xbox PC, restores Drift Zone angle-bonus guidance on the latest builds, and adds a dismissible note from Views. +2.6.5 adds 3D lap review with recorded elevation, shared-space comparison, channel legends, contact markers and PNG export. -[Clips](#clips) · [Tune](#tune) · [Lap review](#lap-review) · [Live map and lap delta](#live-map-and-lap-delta) · [Install](#install) · [2.6.4 release notes](docs/releases/Wisp-2.6.4-release-notes.md) +[Clips](#clips) · [Tune](#tune) · [Lap review](#lap-review) · [Live map and lap delta](#live-map-and-lap-delta) · [Install](#install) · [2.6.5 release notes](docs/releases/Wisp-2.6.5-release-notes.md) ### Clips @@ -59,7 +59,9 @@ Current-car reading supports **Steam and Xbox app / Microsoft Store FH6 with imp ### Lap review -Open a saved run in **Runs → Lap review** to inspect the line you drove. Move one cursor across the map and graphs to review speed, inputs, G-force, RPM, gear and wheel readings. Choose a section and compare its time, distance and inputs with another lap or a pinned benchmark. Events mark braking, throttle pickup and shifts. +Open a saved run in **Runs → Lap review** to inspect the line you drove in **2D or 3D**. The 3D view preserves recorded elevation at the same scale as horizontal distance. Rotate, pan and zoom the map, color it by speed, inputs, G-force, RPM, gear, wheel readings, horsepower, torque or elevation, and follow the selected point in the graph. Choose a section and compare its time, distance and inputs with another lap or a pinned benchmark. Events mark braking, throttle pickup and shifts. + +Optional **Shared space** places two laps beside each other with one camera and color scale. Focus either track, move both cursors together or inspect A and B independently, then return to the overview. Resize the map and use **Save PNG** to share the current view and legend. Contact markers distinguish recorded object evidence and saved annotations from possible-contact estimates; they do not identify every collision. [Read the lap-review guide](docs/LAP-REVIEW.md). Turn on **Save completed laps automatically** to keep laps for later review, grouped by day and car. It uses the timing mode selected in HUD settings while Wisp is running. Choosing Run B takes priority over a compatible pinned benchmark. @@ -244,8 +246,8 @@ An optional quick tour introduces Clips, Tune, live map, lap delta and lap review. Start from the welcome banner or choose **Replay the quick tour** in Release Notes. -[Download Wisp 2.6.4](https://github.com/Views2k/Wisp/releases/download/v2.6.4/Wisp-Setup-2.6.4.exe) · -[2.6.4 release notes](docs/releases/Wisp-2.6.4-release-notes.md) · +[Download Wisp 2.6.5](https://github.com/Views2k/Wisp/releases/download/v2.6.5/Wisp-Setup-2.6.5.exe) · +[2.6.5 release notes](docs/releases/Wisp-2.6.5-release-notes.md) · [Changelog](CHANGELOG.md) Older interface screenshots retain their original version labels. The gameplay @@ -372,11 +374,11 @@ require administrator access or a separate .NET runtime. ## Install -1. Download [Wisp-Setup-2.6.4.exe](https://github.com/Views2k/Wisp/releases/download/v2.6.4/Wisp-Setup-2.6.4.exe). +1. Download [Wisp-Setup-2.6.5.exe](https://github.com/Views2k/Wisp/releases/download/v2.6.5/Wisp-Setup-2.6.5.exe). 2. Run the installer. 3. Complete the required setup wizard on first launch. -The [release page](https://github.com/Views2k/Wisp/releases/tag/v2.6.4) also provides the installer checksum and a ZIP containing the same installer. To verify the download, compare its SHA-256 with the `.sha256` file: +The [release page](https://github.com/Views2k/Wisp/releases/tag/v2.6.5) also provides the installer checksum and a ZIP containing the same installer. To verify the download, compare its SHA-256 with the `.sha256` file: **[WINDOWS POWERSHELL]** @@ -496,6 +498,7 @@ To build the self-contained installer: ## Documentation +- [Wisp 2.6.5 release notes](docs/releases/Wisp-2.6.5-release-notes.md) - [Wisp 2.6.4 release notes](docs/releases/Wisp-2.6.4-release-notes.md) - [Wisp 2.6.3 release notes](docs/releases/Wisp-2.6.3-release-notes.md) - [Wisp 2.6.2 release notes](docs/releases/Wisp-2.6.2-release-notes.md) diff --git a/docs/LAP-REVIEW-3D-PRIVATE.md b/docs/LAP-REVIEW-3D-PRIVATE.md new file mode 100644 index 0000000..e70ea08 --- /dev/null +++ b/docs/LAP-REVIEW-3D-PRIVATE.md @@ -0,0 +1,88 @@ +# Lap review 3D private test + +Historical engineering notes for the private test builds that became Wisp 2.6.5. +For current controls and usage, see the [lap-review guide](LAP-REVIEW.md). + +The 2D review stays the default. 3D uses saved XYZ positions with the same scale +on every axis; the ground projection is a depth cue, not a terrain reconstruction. +Camera and cursor changes reuse frozen geometry. Scene preparation is cancellable +and runs off the UI thread. Dense display paths retain height and selected-channel +extrema, while cursor and analysis retain the original full-resolution samples. + +All fourteen existing channels, wheel selection, Run B / benchmark comparison, +shared cursor, selected sections, readouts and graph handoff are retained. +Horsepower, torque and elevation are additional channels. PNG export includes +the current camera, channel legend and selected-point value, uses a bounded image, +and saves atomically without overwriting existing files. + +## Private 07 audit fixes + +Verified defects and fixes from the private 06 audit and follow-up checks: + +- Unmatched Both mode updated B only through the slider. All A selection paths + now update paired progress; selecting B works symmetrically. Independent A/B + keeps the other cursor fixed. Relative progress does not enable timing matches. +- Matched B keyboard steps could map back to the same A sample. Directional + navigation now advances through valid matches and preserves missing-match gaps. +- Default tooltips used a light system background with Wisp's light text. Tooltips + now use themed colors, wrapping and bounded width; the full-map tooltip is removed. +- Shared-space geometry could be reused after switching to a single track. + Preparation now includes layout mode in its identity before reusing a scene. +- Track picking ignored depth. Segment picking prefers the visible overpass; + foreground annotations retain hit priority. Empty space focuses without selection. +- Distant world positions distorted shared-space scale. Each lap is horizontally + centered with one physical scale and unchanged recorded elevation. +- Map height was lost on reopen; it is now bounded and saved when resizing ends. + Compact upward resizing no longer jumps to a larger minimum. Home restores auto size. +- Elevation values and legends use feet with mph, meters otherwise. Geometry keeps + equal physical scale on all axes. +- Filled and hollow contact stars distinguish reported/saved evidence from estimates. + Unused manual-editor commands, storage method and advice have been removed. + +Wheel zoom still requires map focus so page scrolling works naturally. Right-click +or click empty map space to focus without changing the lap point; this is explained +beside the controls. Contact-format corrections and evidence limits are below. + +## Contact evidence + +The official FH6 Data Out layout documents SmashableVelDiff and SmashableMass: +https://support.forza.net/hc/en-us/articles/51744149102611-Forza-Horizon-6-Data-Out-Documentation + +These fields report breakable-object velocity loss and mass, not a general +wall/car collision flag. Object contact requires a continuous observed +zero-to-positive impulse. A repeated game tick is accepted only with unchanged +sample time, identity and position (within 1 cm), without a gap or clock rewind; +repeated lap-clock values do not discard an otherwise continuous object impulse. +Possible contact is a conservative movement estimate. Existing Contact annotations +in saved or imported runs remain visible; the manual contact editor has been removed. +No universal collision accuracy is claimed. +Historical runs discarded these fields and cannot retrospectively recover them. + +New journals declare run schema 3 before recording samples, preventing older +readers from recovering a partial prefix and discarding newer contact data. +Finalized recordings and recovered journals with no positive object field omit +the optional fields and use schema 1 or 2, preserving Wisp 2.6.4 readability. +If either field is positive, schema 3 retains every object sample, including zero +baselines, and requires this private build or newer. Existing finalized files and +imports retain their format and data during metadata edits; no migration is performed. + +## Platform assessment + +Steam: saved-run visualization uses no game memory or executable-specific data. +Object telemetry uses FH6's documented 324-byte Data Out packet contract. +Xbox app / Microsoft Store: the same visualization and packet contract applies; +no platform-specific native reader was changed. No new live-game collision capture +was performed on either edition. Packet fixtures establish parsing, not real-world +coverage of walls, other cars, repeated impacts or dropped packets. + +## Verification boundary + +Focused checks cover existing channels and interactions, 3D projection/elevation, +color pixels, stale asynchronous scene protection, retained contact annotations, +repeated-clock object impulses, schema recovery/import/export and PNG output. The private +installer retains the standard full packaging gates. Detailed results and source +revision are retained with the delivered installer. + +The stored-lap performance check uses one existing run read-only and a synthetic +180,000-point size-limit case. CPU preparation and software-render timing do not +establish gameplay FPS or guarantee every machine's interaction performance. diff --git a/docs/LAP-REVIEW.md b/docs/LAP-REVIEW.md index 3746a8e..052d213 100644 --- a/docs/LAP-REVIEW.md +++ b/docs/LAP-REVIEW.md @@ -1,19 +1,62 @@ # Lap review -This describes the unreleased lap-review candidate. The public 2.5.2 installer does not include it. +Review the line you drove, inspect its telemetry and compare selected sections with another lap. The map uses saved positions from your recording. + +## Record and open laps Open **Runs → Lap review**. Enable **Save completed laps automatically** to retain detailed laps while Wisp is running. Capture uses the timing mode in the HUD's lap settings: Race / Rivals laps or Time Attack. It works with the lap overlays disabled. Manual run recording remains available; older recordings need position and lap telemetry to show a driven map. Automatic capture uses the existing lap tracker's accepted completion boundary. Joining halfway through a lap, missing telemetry, rewinding, changing car or exceeding the recording limit prevents that interrupted lap from being saved as a complete capture. Completed saves are written to the existing local run library, with its storage limits and export/removal tools. Turn the option off to stop future captures. Pending completed saves finish when Wisp closes. -Choose a saved run and a lap. The map is the car's recorded path, not a supplied circuit outline or a claim about track limits. The start ring and shared cursor identify locations. Click the map or graph, use arrow keys, or move the sample slider. Choose speed, time delta, throttle, brake, steering input, G-force, RPM or gear as the channel. Tire temperature, slip ratio, raw slip angle and normalized suspension travel also have a wheel selector for the map and graph. The sample readout shows these values for all four wheels together. +## Map, channels and cursor + +Choose a saved run and a lap. The map is the car's recorded path, not a supplied circuit outline or a claim about track limits. The start ring and shared cursor identify locations. Click the map or graph, use arrow keys, or move the **Lap position** slider above the map. + +**2D** is the default. Switch to **3D** to view the saved XYZ positions with the same physical scale on every axis, preserving the recorded elevation changes. The ground projection helps show depth; it does not reconstruct terrain or track boundaries. Elevation values use feet when speed is set to mph and meters otherwise. + +Use **Color** to choose speed, time delta, throttle, brake, steering input, lateral/longitudinal/combined G-force, RPM, gear, horsepower, torque or elevation. Tire temperature, slip ratio, raw slip angle and normalized suspension travel also have a wheel selector for the map and graph. The legend shows the channel, units and numeric range; the sample readout shows wheel values for all four wheels together. Unavailable data stays unavailable. + +### 3D controls + +| Input | Action | +| --- | --- | +| Click a track point | Select that location; in Shared space, move closer to that lap | +| Left-drag | Rotate | +| Shift-drag, right-drag or middle-drag | Pan | +| Ctrl-drag | Roll | +| Mouse wheel while the map has focus | Zoom | +| Arrow keys while the map has focus | Step through recorded points | +| Home / End while the map has focus | Select the first / last point | +| Double-click, R, or **Reset camera** | Reset the camera | + +Right-click or click empty map space to focus it without changing the selected point. Before the map has focus, the wheel scrolls the page. **Zoom in** and **Zoom out** are also available as buttons. Picking another point on an already focused lap keeps your adjusted camera view. + +Drag **Resize map** to change the map height; Wisp remembers the height when resizing ends. With the resize handle focused, Up/Down adjusts the height and Home restores automatic sizing. + +**Save PNG** saves the current 2D or 3D map with its channel legend and selected-point values. It includes the current camera and Shared space view when enabled. Resize and frame the map before saving, and choose an unused filename to keep existing images. + +## Sections and reference laps Use **Start section here** and **End section here** around a corner or straight. Compare entry, minimum and exit speed, time, distance, throttle/brake/coasting fractions, G-force, RPM, gear changes and tire values. **Open section in graphs** connects the same interval to the existing Runs graph workspace. Whole-lap timing uses the recorded timing boundary; section statistics describe the actual recorded samples and their coverage. -Select Run B using the existing comparison controls, then choose its reference lap. Without Run B, the reference picker uses laps from the current run. **Pin this lap as benchmark** keeps a selected run/lap reference between Wisp sessions; rename the run and add its tune label in the normal run details. Pinning does not copy the recording, prevent its removal, or change the live HUD's session-best/previous-lap reference. If the pinned run is unavailable, choose another or unpin it. +Select Run B using the existing comparison controls, then choose its reference lap. Run B takes priority over a compatible pinned benchmark. Without Run B or a compatible pinned benchmark, the reference picker uses laps from the current run. **Pin this lap as benchmark** keeps a selected run/lap reference between Wisp sessions; rename the run and add its tune label in the normal run details. Pinning does not copy the recording, prevent its removal, or change the live HUD's session-best/previous-lap reference. If the pinned run is unavailable, choose another or unpin it. Time delta is this lap's time minus the reference's time at matching world positions. A negative value is ahead. Route direction, continuity, start location, car and timing mode must agree, and most of both routes must match. Ambiguous or missing positions get no delta. Comparison does not establish identical tune, conditions or an officially clean lap. Existing telemetry does not provide a reliable official lap-validity flag or full track boundary. +### Shared space and independent cursors + +In 3D, enable **Shared space** when two distinct laps with recorded positions are selected. It is optional and starts off. The laps are arranged beside each other in one scene, using a common physical scale and channel color range while retaining their recorded elevation. Click either track to focus it. Zoom out, choose **Show both laps**, or press Escape while the map has focus to return to the overview. + +Choose **Both** to move the cursors together. Compatible comparisons follow matching track positions. When the laps cannot be matched, Both follows relative progress by recorded distance; this does not enable time delta or matched section statistics. **A** and **B** let you inspect the laps independently while keeping the other cursor fixed. Moving B independently leaves A and its graph at their selected point. + +Shared space can display different cars or routes when both laps have usable positions. That visual comparison does not relax the timing and benchmark requirements above. + +## Contact markers + +**Show contacts** displays filled stars for recorded breakable-object evidence or existing saved Contact annotations, and hollow stars for **Possible contact (estimate)**. Object evidence comes from the game's reported breakable-object velocity loss and mass. Possible contacts are inferred from movement; they can be wrong. These markers do not establish every wall/car collision, an officially clean lap, or the absence of contact when no marker appears. + +Saved or imported Contact annotations remain visible. There is no manual contact editor. Older recordings that did not retain object telemetry cannot recover that evidence retrospectively. See the [run-file format guide](run-library-format.md) for sharing and older-version compatibility. + ## Why these measurements RACELOGIC recommends locating time losses in the delta trace, then examining braking location, apex speed and the line through corner entry and exit. Wisp uses the corresponding telemetry and selected sections; it does not infer where a real apex or legal kerb lies from a bare path. [Circuit Tools guidance](https://en.racelogic.support/motorsport/discontinued-legacy/software/circuit-tools-2/kb/how-to-use-circuit-tools-to-become-faster/). diff --git a/docs/releases/Wisp-2.6.5-release-notes.md b/docs/releases/Wisp-2.6.5-release-notes.md new file mode 100644 index 0000000..966b786 --- /dev/null +++ b/docs/releases/Wisp-2.6.5-release-notes.md @@ -0,0 +1,12 @@ +# Wisp 2.6.5 + +[Download Wisp 2.6.5 for Windows](https://github.com/Views2k/Wisp/releases/download/v2.6.5/Wisp-Setup-2.6.5.exe) + +## Lap review + +- Added an optional **3D track map** with recorded elevation and mouse controls for rotation, pan and zoom. The 2D view remains available. +- Added **Shared space** to compare two lap maps with the same color scale. Focus either lap or view both, and move their cursors together or independently. +- Added power and torque channels, a color legend, contact markers and **Save PNG**. Recorded object contacts and estimated possible contacts use distinct markers. +- Moved lap-position controls above the map and added a resizable map area with a camera reset button. + +[Lap-review guide](https://github.com/Views2k/Wisp/blob/v2.6.5/docs/LAP-REVIEW.md) diff --git a/docs/run-library-format.md b/docs/run-library-format.md index 5b3b4e5..f775092 100644 --- a/docs/run-library-format.md +++ b/docs/run-library-format.md @@ -4,13 +4,19 @@ Wisp run files and library archives preserve recorded telemetry and its metadata ## Single run: `.wisprun` -The existing single-run format remains unchanged: a gzip-compressed UTF-8 JSON Lines file. +The single-run container is a gzip-compressed UTF-8 JSON Lines file. -1. The first line is a `RecordedRun` object. `schemaVersion` is currently `1`; `samples` must be an empty array. The header carries `id`, `name`, `tune`, `notes`, `startedAtUtc`, `finishReason`, `isIncomplete`, `rejectedDatagrams`, `droppedDatagrams`, and `markers`. +1. The first line is a `RecordedRun` object; `samples` must be an empty array. The header carries `schemaVersion`, `id`, `name`, `tune`, optional `tuneAttachment`, `notes`, `startedAtUtc`, `finishReason`, `isIncomplete`, `rejectedDatagrams`, `droppedDatagrams`, `lapTimingMode`, and `markers`. 2. Every subsequent line is one `RunSample`, in recording order. Its fields are `elapsedSeconds`, `segment`, `isDriving`, `state`, `wheelSpeedMetersPerSecond`, `frontRadiusMeters`, and `rearRadiusMeters`. `state` contains the serialized `VehicleState` fields; values are not rounded for export. JSON uses camel-case property names and string enum names. Unknown properties and unsupported schema versions are rejected rather than silently discarded. Existing Wisp validation also checks finite/bounded numeric data, chronological samples and markers, consistent car/drivetrain identity, plausible calibration, and metadata lengths. Current definitions live in `src/Wisp.Core/Runs/RunModels.cs`, `src/Wisp.Core/VehicleState.cs`, and `src/Wisp.App/Runs/RunStore.cs`. +Schema 1 stores telemetry without a structured tune attachment. Schema 2 adds that attachment. Schema 3 permits optional breakable-object velocity-loss and mass fields, with or without a tune attachment. Missing object fields mean unavailable evidence, not a measured zero. These fields are validated as a pair; invalid or partial values are rejected. + +When finalizing a new recording or automatic lap, Wisp retains schema 3 if either object field is positive in any sample. All surrounding zero baselines remain intact, so an observed zero-to-positive contact can still be identified. If neither field is ever positive, Wisp omits these optional fields and saves schema 1 or 2 as appropriate. Those completed files remain readable in Wisp 2.6.4; files retaining schema 3 require Wisp 2.6.5 or newer. Existing finalized files and imports are not downgraded, and metadata edits preserve their schema and telemetry. + +New recording journals declare schema 3 from the start, so older readers cannot recover a prefix and silently discard later object evidence. Recovery validates its retained samples before choosing the finalized format by the same rule and marks the run incomplete. Unsupported or unrecoverable journals remain on disk. + ## Library archive: `.zip`, version 1 This is a standard ZIP containing one `manifest.json` and one existing `.wisprun` file per run. Tools that understand ZIP can extract the individual run files without implementing a new telemetry serialization format. diff --git a/installer/PrivateShiftCaptureGuide.txt b/installer/PrivateShiftCaptureGuide.txt index a66ec89..0277db2 100644 --- a/installer/PrivateShiftCaptureGuide.txt +++ b/installer/PrivateShiftCaptureGuide.txt @@ -1,38 +1,94 @@ -Wisp 2.6.3 Compatibility and drift test -Private build ID: adaptive-drift-20261006-01 - -This is a private test build, not a published release. It updates your existing -Wisp installation and keeps settings, profiles, calibrations, saved runs and -the Clips library. It is not a separate installation. - -Changes in this build -- Restores Drift Zone angle-bonus guidance for the current Steam and Xbox PC - builds. If bonus guidance is unavailable, the gauge still shows your angle. -- A dismissible note from Views appears when opening Wisp, at most once per - 24 hours. It stays open until you press its X. Its GitHub repo button opens - Views2k/Wisp so you can leave a star without dismissing the note. -- Wisp can recognize unchanged HUD and Tune readers after a Forza update on - both Steam and Xbox PC. A changed version number alone no longer blocks them. -- Game identity, reader structure, current-car ownership and value checks remain - required. If an optional reader changes, the verified features stay available. -- Temporary read failures can be retried without restarting Wisp. +Wisp 2.6.4 Lap review 3D test +Private build ID: lap-review-3d-20261006-07 + +This is a private test build, not a public release. It updates your existing +Wisp installation and keeps your settings, profiles, calibrations, runs and +clips. It is not a separate installation. + +Choose Skip setup to test this private build without opening Forza. The skip +lasts for the current session and does not change your saved setup evidence. +Public releases keep the normal setup flow. + +Changes +- Switch between the existing 2D lap map and a 3D view of recorded elevation. +- Rotate, tilt, roll, pan and zoom the 3D map; reset the camera at any time. +- Keep every existing map/graph channel, wheel selector, comparison, cursor, + section analysis and graph shortcut. Add horsepower, torque and elevation. +- Read the color legend and the selected point's value next to the map. +- Show reported object contacts, possible impacts and saved manual markers. +- Save the current 2D or 3D map, including its legend, as a PNG image. +- Optionally compare two 3D laps in Shared space, using the same channel and + color scale. Click a track to move closer; zoom back out to see both. +- Keep the lap-position slider above the map and batch drag updates to one + per UI render cycle, preserving the final position when released. +- Use one page scrollbar for the comparison controls and lap review. +- Compare recorded tracks from different cars in Shared space. Timing and + matched-section checks remain separate from visual comparison. +- Give the track more room with a taller automatic view and a draggable lower edge. +- Keep camera zoom steady while rotating either the shared overview or a focused lap. +- Choose Both, A or B beside Lap position to move paired or independent cursors. +- Use zoom, reset, Show both laps and Show contacts directly from the top toolbar. +- View the channel graph directly below the legend, with Lap settings and + benchmark beneath it. Drag the clearly marked divider handle to resize the map. +- Use mouse camera gestures without manual angle sliders or a contact editor. +- Center the close icon in the A note from Views popup. +- Move both lap cursors with track/graph clicks, keyboard navigation and the slider. +- Step through slower comparison laps without sticking on the same sample. +- Keep the map height when reopening the view, and show imperial elevation in feet. +- Distinguish reported/saved contacts from estimated contacts in the legend. +- Select the visible track at overpasses and restore the single-map layout correctly. +- Read styled, wrapping tooltips without a blank white bar over the track. + +Controls +Lap position: Both moves paired cursors; A or B moves only that lap. Both uses +matched positions where available, otherwise relative recorded lap distance. +Relative progress does not establish a valid time delta or matched section. +Drag: rotate. Shift-drag or right-drag: pan. Ctrl-drag: roll. +Right-click or click empty map space to enable scroll zoom without selecting a +lap point. Otherwise the wheel scrolls the page. +Double-click or Reset camera: restore the workspace camera. +Drag Resize map on the divider to resize it. Focus the grip and use Up/Down to +adjust the height, or Home to restore automatic sizing. +Click the line: select a point. Arrow keys: move along the lap. +Home/End: first/last point. +Choose Run B using Compare above, or choose a reference in Lap settings and +benchmark, then enable Shared space in 3D. Both tracks remain in the same scene, +laid out side by side. With Shared space off, the original single-lap view remains. +Click a track to bring the camera toward it. Scroll back out, choose Show +both laps or press Escape to frame both again. Rotation and pan +gestures affect the shared camera. PNG saves the current camera view. +Each map shows its recorded and saved contact markers. Show contacts hides +or shows those markers; this view does not add or remove saved contacts. Suggested checks -1. Start your usual Steam or Xbox PC version of Forza, then Wisp. Drive into the - open world and check the HUD against the car and the game's displayed values. -2. Open Tune and refresh. Compare the displayed values with your current tune. -3. Switch cars and confirm the HUD and Tune show the new car's values. -4. Close and reopen Forza with Wisp still running. Confirm Wisp reconnects. -5. Save and play a short clip with your existing recording settings. -6. Check Drift Zone angle-bonus guidance and Custom target. The selected mode, - target, gauge position and appearance should stay as you set them. - -If a read fails, use Copy details on Tune or export a debug ZIP from Diagnostics. -Include the private build ID above with your report. This build does not enable -per-frame diagnostic logging or change your recording settings. - -Steam and Xbox read-only comparisons passed on the October 5 game builds. -Unknown future builds still need to pass the same validation; changed game -readers, inaccessible memory or ambiguous matches must be rejected. -Drift angle readings use Data Out. Automatic HUD/Tune validation does not verify -new Drift Zone scoring rules; unverified rules leave the gauge in Angle only. +1. Open an existing saved lap in Runs and expand Lap review. +2. Switch between 2D and 3D. Rotate and zoom, then reset the view. +3. Change channels and wheels. Select a point, compare Run B, select a section + and open it in graphs. The selected point/section should stay consistent. +4. Toggle Show contacts and check the recorded markers on each lap. +5. Save a PNG in both modes. Check the current view, colors and legend. +6. Record a new lap on your usual Steam or Xbox PC installation. Object + contacts use the same Data Out fields on both editions. + +Contact coverage +Forza reports velocity loss and mass for breakable-object impacts. Those +appear as Object contact in new recordings. Possible contact is an estimate +from movement; it is not a verified wall/car collision. Old recordings did +not retain the object-impact fields. Previously saved markers remain visible. + +Saved-run compatibility +Existing saved runs retain their original format. New finalized runs without +positive object-impact telemetry omit those optional fields and remain readable +in public 2.6.4. Runs with positive object-impact telemetry use run format 3 and +require this build or newer. Public 2.6.4 keeps those files but cannot open them. +Recording journals declare format 3 from the start so older Wisp cannot recover +an incomplete prefix and lose contact data. This build safely recovers them. +Existing format-3 files are preserved rather than rewritten during metadata edits. + +The 3D line uses recorded world positions at equal scale on all axes. Its floor +projection is a visual reference, not a terrain model. Dense laps are simplified +for display while keeping original samples for analysis and cursor selection. + +Include the private build ID above with feedback. Use Diagnostics to export +redacted debug details if needed. No game-memory readers or recording settings +are changed by this build. diff --git a/installer/Wisp.iss b/installer/Wisp.iss index c97c2dd..8dd7463 100644 --- a/installer/Wisp.iss +++ b/installer/Wisp.iss @@ -1,5 +1,5 @@ #define MyAppName "Wisp" -#define MyAppVersion "2.6.4" +#define MyAppVersion "2.6.5" #define MyAppDisplayVersion MyAppVersion #define MyAppOutputVersion MyAppVersion #define MyAppPublisher "Wisp" diff --git a/src/Wisp.App/App.xaml b/src/Wisp.App/App.xaml index 161f084..a01b85b 100644 --- a/src/Wisp.App/App.xaml +++ b/src/Wisp.App/App.xaml @@ -98,6 +98,31 @@ + + + + + + + + + @@ -22,8 +53,144 @@ - - + + + + + + + + + + + + + + + + + + + + + + +