[PR #257] feat(insights): add 3D Tyre Hologram Room with per-corner tyre health/temperature display #258

New issue

Open

opened 2026-05-07 00:19:26 +02:00 by BreizhHardware · 0 comments

BreizhHardware commented

2026-05-07 00:19:26 +02:00

Owner

📋 Pull Request Information

Original PR: https://github.com/IAmTomShaw/f1-race-replay/pull/257
Author: @aaRusha7giri
Created: 3/14/2026
Status: 🔄 Open

Base: main ← Head: aarush-tyre-hologram-room-pr

📝 Commits (1)

134061c Add tyre hologram room updates and 3D model assets

📊 Changes

22 files changed (+492189 additions, -553 deletions)

View changed files

📝 README.md (+2 -40)
📝 main.py (+2 -6)
📝 requirements.txt (+3 -1)
➕ resources/models/Formula_1_mesh.mtl (+148 -0)
➕ resources/models/f1_car.obj (+245547 -0)
➕ resources/models/f1_model_unpack/source/Formula 1 mesh.zip (+0 -0)
➕ resources/models/f1_model_unpack/source/mesh_unpack/Formula 1 mesh.obj (+245547 -0)
➕ resources/models/f1_model_unpack/source/mesh_unpack/Formula_1_mesh.mtl (+148 -0)
➕ resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Diffuse.png (+0 -0)
➕ resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Glossiness.png (+0 -0)
➕ resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Normal.png (+0 -0)
➕ resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Specular.png (+0 -0)
➕ resources/models/ferrari-f1-formula-car-high-quality-f1.zip (+0 -0)
➕ resources/models/formula1_DefaultMaterial_Diffuse.png (+0 -0)
📝 src/cli/race_selection.py (+1 -5)
📝 src/f1_data.py (+0 -377)
📝 src/gui/insights_menu.py (+12 -0)
📝 src/gui/race_selection.py (+9 -34)
➕ src/insights/tyre_hologram_room.py (+741 -0)
📝 src/interfaces/race_replay.py (+25 -69)

...and 2 more files

📄 Description

Summary
This PR adds a new Tyre Hologram Room experience to F1 Race Replay with a 3D car model view and per-corner tyre telemetry overlays.

What’s Included

Added a dedicated tyre insights window:
- src/insights/tyre_hologram_room.py
Integrated launch flow from insights menu:
- src/gui/insights_menu.py
Added model/telemetry support updates across app flow:
- main.py
- src/cli/race_selection.py
- src/f1_data.py
- src/gui/race_selection.py
- src/interfaces/race_replay.py
- src/services/stream.py
- telemetry.md
Added 3D model assets and textures under:
- resources/models/...

UI/UX Changes

Displays a fixed top-view car model in the hologram room
Shows tyre corner labels and tyre metrics (FL/FR/RL/RR)
Improved practical visibility for all 4 tyres
Supports per-corner status visualization logic for tyre condition

Tyre Status Logic

Green: healthy tyre range
Yellow: medium wear range
Red: high wear / warning range

Why
This improves race insights practicality by making tyre condition easier to interpret visually and per-corner in real time.

Notes

This PR includes model assets and textures required for rendering.
I will add screenshots/images in this PR after creation.

Testing Done

Opened Tyre Hologram Room from Insights menu
Verified car model renders in fixed top view
Verified tyre corner overlays update correctly
Verified app remains stable during live session flow

Follow-up (next PR)

Warning highlights when any tyre corner drops below threshold
Additional UI polish and performance tuning

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/IAmTomShaw/f1-race-replay/pull/257 **Author:** [@aaRusha7giri](https://github.com/aaRusha7giri) **Created:** 3/14/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `aarush-tyre-hologram-room-pr` --- ### 📝 Commits (1) - [`134061c`](https://github.com/IAmTomShaw/f1-race-replay/commit/134061c9e606573769b4ff06a6efabe43bf22647) Add tyre hologram room updates and 3D model assets ### 📊 Changes **22 files changed** (+492189 additions, -553 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+2 -40) 📝 `main.py` (+2 -6) 📝 `requirements.txt` (+3 -1) ➕ `resources/models/Formula_1_mesh.mtl` (+148 -0) ➕ `resources/models/f1_car.obj` (+245547 -0) ➕ `resources/models/f1_model_unpack/source/Formula 1 mesh.zip` (+0 -0) ➕ `resources/models/f1_model_unpack/source/mesh_unpack/Formula 1 mesh.obj` (+245547 -0) ➕ `resources/models/f1_model_unpack/source/mesh_unpack/Formula_1_mesh.mtl` (+148 -0) ➕ `resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Diffuse.png` (+0 -0) ➕ `resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Glossiness.png` (+0 -0) ➕ `resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Normal.png` (+0 -0) ➕ `resources/models/f1_model_unpack/textures/formula1_DefaultMaterial_Specular.png` (+0 -0) ➕ `resources/models/ferrari-f1-formula-car-high-quality-f1.zip` (+0 -0) ➕ `resources/models/formula1_DefaultMaterial_Diffuse.png` (+0 -0) 📝 `src/cli/race_selection.py` (+1 -5) 📝 `src/f1_data.py` (+0 -377) 📝 `src/gui/insights_menu.py` (+12 -0) 📝 `src/gui/race_selection.py` (+9 -34) ➕ `src/insights/tyre_hologram_room.py` (+741 -0) 📝 `src/interfaces/race_replay.py` (+25 -69) _...and 2 more files_ </details> ### 📄 Description Summary This PR adds a new Tyre Hologram Room experience to F1 Race Replay with a 3D car model view and per-corner tyre telemetry overlays. What’s Included - Added a dedicated tyre insights window: - `src/insights/tyre_hologram_room.py` - Integrated launch flow from insights menu: - `src/gui/insights_menu.py` - Added model/telemetry support updates across app flow: - `main.py` - `src/cli/race_selection.py` - `src/f1_data.py` - `src/gui/race_selection.py` - `src/interfaces/race_replay.py` - `src/services/stream.py` - `telemetry.md` - Added 3D model assets and textures under: - `resources/models/...` UI/UX Changes - Displays a fixed top-view car model in the hologram room - Shows tyre corner labels and tyre metrics (FL/FR/RL/RR) - Improved practical visibility for all 4 tyres - Supports per-corner status visualization logic for tyre condition Tyre Status Logic - Green: healthy tyre range - Yellow: medium wear range - Red: high wear / warning range Why This improves race insights practicality by making tyre condition easier to interpret visually and per-corner in real time. Notes - This PR includes model assets and textures required for rendering. - I will add screenshots/images in this PR after creation. Testing Done - Opened Tyre Hologram Room from Insights menu - Verified car model renders in fixed top view - Verified tyre corner overlays update correctly - Verified app remains stable during live session flow Follow-up (next PR) - Warning highlights when any tyre corner drops below threshold - Additional UI polish and performance tuning <img width="1366" height="768" alt="Screenshot (1080)" src="https://github.com/user-attachments/assets/c250ba56-74fb-4df6-aa21-4a2d5aa90eae" /> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>