Skip to content

Dashboard Principal

Jump to bottom
David Mendez edited this page Jul 18, 2026 · 1 revision

🏁 Dashboard Principal

Archivo: ui/main_window.py · Clase: TelemetryMainWindow · 656 líneas

El Dashboard Principal es la ventana central de GT7 Telemetry Pro. Muestra toda la instrumentación de telemetría en tiempo real mientras conduces en Gran Turismo 7.

Dashboard Principal

Dimensiones y Tema

Propiedad Valor
Resolución base 1600 × 900 px
Tema Daylight Mode (fondo claro #FAFAFA)
QSS global ui/styles/daylight_theme.qss
Frecuencia de datos 60 Hz (recepción de paquetes)
Frecuencia de renderizado ~30 Hz (QTimer cada 33ms)

Layout de 3 Columnas

La ventana se divide en una barra superior (header) y tres columnas principales:

┌──────────────────────────────────────────────────────────────────────────┐
│  HEADER: Status │ Record │ IP │ Connect │ Análisis │ Pro │ Export/Import│
├───────────┬─────────────────────────────┬────────────────────────────────┤
│           │                             │                                │
│  IZQUIERDA│        CENTRO               │         DERECHA                │
│  (20%)    │        (40%)                │         (40%)                  │
│           │                             │                                │
│  Info     │  Gráficas Telemetría        │  ┌──────┐ ┌──────┐            │
│  Vuelta   │  (Velocidad/Pedales/RPM)    │  │ VEL  │ │ RPM  │  Gauges   │
│           │                             │  └──────┘ └──────┘            │
│  Mapa     │                             │  ┌──────┐ ┌──────┐            │
│  Pista    │                             │  │TURBO │ │ TEMP │            │
│           │                             │  └──────┘ └──────┘            │
│  G-Force  │  Delta-T                    │  FL ▐▌▐▌ FR  Tyres+Pedals    │
│           │  (150px fijo)               │  RL ▐▌▐▌ RR                   │
│           │                             │  Marcha: 3      Alertas       │
└───────────┴─────────────────────────────┴────────────────────────────────┘

Stretch Ratios

Columna Stretch % Aproximado
Izquierda 2 ~20%
Centro 4 ~40%
Derecha 4 ~40%

Barra Superior (Header)

La barra de herramientas horizontal contiene todos los controles de la aplicación:

Elemento Widget Descripción
Estado QLabel Indicador de conexión: 🔴 Disconnected / 🟡 Searching / 🟢 Connected
Grabar QPushButton "⏺ Iniciar Grabación" / "⏹ Detener Grabación" — deshabilitado hasta recibir telemetría
Estado Rec. QLabel Texto informativo de grabación activa
IP Consola QLineEdit Campo de 200px para IP de PS4/PS5 (auto-detect disponible)
Conectar QPushButton "Connect Live" / "Disconnect" — inicia/detiene GT7LiveClient
Análisis QPushButton "Historial y Análisis" → abre AdvancedAnalysisDialog
Pro Analysis QPushButton "Pro Analysis" (acento azul) → abre ProfessionalWorkspace
Exportar BD QPushButton "📦 Exportar BD" → diálogo de guardar archivo .gt7db
Importar BD QPushButton "📥 Importar BD" → diálogo de abrir + flujo merge/replace
Sync LAN QPushButton "🔄 Sync LAN" → abre SyncDialog

Columna Izquierda — Información y Mapas

Panel "Información de Vuelta"

Muestra datos de la vuelta actual en tiempo real:

Dato Formato Detalle
Auto Texto Nombre del auto (desde gt7_cars.json, 800+ IDs)
Vuelta "Lap X/Y" Vuelta actual / total de vueltas
Tiempo mm:ss.SSS Tiempo de la vuelta actual (monospace 18pt)
Combustible est. Texto "~X.X vueltas restantes"
Barra combustible QProgressBar Color dinámico: Verde (>30%) → Naranja (10-30%) → Rojo (<10%)
Consumo/Vuelta Texto "Consumo: X.XX/vuelta"
WOT Indicador "🟢 WOT" cuando acelerador = 100%

Mapa de Pista (stretch=3)

Ver → Mapa de Pista

Diagrama G-Force (stretch=2)

Ver → Fuerzas G

Columna Centro — Gráficas y Delta

Gráficas de Telemetría (stretch=4)

Ver → Gráficas de Telemetría

Delta-T (stretch=1, 150px fijo)

Ver → Delta-T

Columna Derecha — Instrumentación

Medidores Circulares (Grid 2×2)

Posición Medidor Rango Color
Superior Izq. Velocidad 0–350 km/h Azul
Superior Der. RPM 0–10,000 (auto-ajusta al máximo) Naranja
Inferior Izq. Turbo/Boost 0–2.0 bar Rojo
Inferior Der. Temp. Agua 50–130 °C Verde

Ver → Medidores Circulares

Neumáticos + Pedales

┌────────┐  ┌────┬────┐  ┌────────┐
│  FL 🌡️  │  │ THR│ BRK│  │  FR 🌡️  │
│  87°   │  │ ▐▌ │ ▐▌ │  │  92°   │
├────────┤  │ 78%│ 0% │  ├────────┤
│  RL 🌡️  │  │    │    │  │  RR 🌡️  │
│  71°   │  └────┴────┘  │  85°   │
└────────┘                └────────┘
  • Pedales: 2 barras verticales (30×180px) — Acelerador (verde) / Freno (rojo) con label de porcentaje
  • Neumáticos: 4 semicírculos → Ver Temperatura de Neumáticos

Indicador de Marcha

Texto en monospace 24pt bold: "Marcha: N" / "Marcha: 3" / "Marcha: R"

Alertas Pit-Wall

Ver → Alertas Pit-Wall

Flujo de Datos

GT7LiveClient (3 hilos)
    │
    │ packet_signal @ 60Hz
    ▼
_cache_packet() ──────────────────────────────────────────────┐
    │                                                          │
    ├── MathEngine.process_packet() → fuel, WOT, slip         │
    ├── LapManager.process_packet() → delta-T                 │
    ├── AlertEngine.check_alerts() → pit-wall warnings        │
    ├── map_widget.add_point(x, z, throttle, brake)           │
    ├── gforce_widget.add_point(lateral, longitudinal)        │
    └── graphs_widget.add_data(speed, throttle, brake, rpm)   │
                                                               │
QTimer(33ms) ─── update_dashboard_ui() @ 30Hz ◄───────────────┘
    │
    ├── Actualizar 4 medidores circulares (.set_value)
    ├── Actualizar 4 temperaturas de neumáticos (.set_temp)
    ├── Actualizar barras de pedales (.setValue)
    ├── Actualizar barra de combustible
    ├── Actualizar indicador de marcha
    ├── Actualizar info de vuelta
    ├── map_widget.update_plot()
    ├── gforce_widget.update_plot()
    ├── graphs_widget.update_plot()
    └── delta_widget.update_data()

¿Por qué 2 frecuencias diferentes?

  • 60 Hz (_cache_packet): Recibe cada paquete del juego sin perder ninguno. Alimenta los buffers de datos.
  • 30 Hz (update_dashboard_ui): Refresca la interfaz visual. 30 FPS es suficiente para el ojo humano y reduce la carga de CPU en un 50%.

Auto-Actualización

Al arrancar la aplicación, un UpdateChecker (QThread) consulta la API de GitHub para detectar nuevas versiones. Si existe una versión más reciente que APP_VERSION:

  1. Muestra diálogo: "Nueva versión X.X.X disponible. ¿Descargar?"
  2. Si acepta → UpdateDownloader descarga el ZIP en background con barra de progreso
  3. Al completar → extrae y reinicia la aplicación

🏁 GT7 Telemetry Pro

v1.1.3

📖 General

🎮 Dashboard

🔬 Análisis

🌐 Conectividad

Clone this wiki locally