Files
vibe3_physics/source/themes/theme.h
Sergio Valor a134ae428f PHASE 2: Refactorización completa del sistema de temas unificado
Arquitectura polimórfica implementada:
- Jerarquía: Theme (base) → StaticTheme / DynamicTheme (derivadas)
- Vector unificado de 10 temas (7 estáticos + 3 dinámicos)
- Eliminada lógica dual (if(dynamic_theme_active_) scattered)

Nuevos archivos:
- source/themes/theme.h: Interfaz base abstracta
- source/themes/static_theme.h/cpp: Temas estáticos (1 keyframe)
- source/themes/dynamic_theme.h/cpp: Temas dinámicos (N keyframes animados)
- source/theme_manager.h/cpp: Gestión unificada de temas

Mejoras de API:
- switchToTheme(0-9): Cambio a cualquier tema (índice 0-9)
- cycleTheme(): Cicla por todos los temas (Tecla B)
- update(delta_time): Actualización simplificada
- getInterpolatedColor(idx): Sin parámetro balls_

Bugs corregidos:
- Tecla B ahora cicla TODOS los 10 temas (antes solo 6)
- DEMO mode elige de TODOS los temas (antes excluía LAVENDER + dinámicos)
- Eliminada duplicación de keyframes en temas dinámicos (loop=true lo maneja)

Código reducido:
- theme_manager.cpp: 558 → 320 líneas (-43%)
- engine.cpp: Eliminados ~470 líneas de lógica de temas
- Complejidad significativamente reducida

Preparado para PHASE 3 (LERP universal entre cualquier par de temas)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-09 13:17:54 +02:00

94 lines
3.3 KiB
C++

#pragma once
#include <vector>
#include "../defines.h" // for Color, ThemeKeyframe
/**
* Theme: Interfaz polimórfica para todos los temas (estáticos y dinámicos)
*
* Responsabilidades:
* - Proporcionar información básica del tema (nombre, color de texto)
* - Generar colores interpolados para pelotas y fondo
* - Actualizar estado interno si es animado (solo dinámicos)
*
* Implementaciones:
* - StaticTheme: 1 keyframe, sin animación, colores fijos
* - DynamicTheme: N keyframes, animación continua con loop
*/
class Theme {
public:
virtual ~Theme() = default;
// ========================================
// QUERIES BÁSICAS (implementar en derivadas)
// ========================================
virtual const char* getNameEN() const = 0;
virtual const char* getNameES() const = 0;
virtual void getTextColor(int& r, int& g, int& b) const = 0;
// ========================================
// CORE: OBTENER COLORES (polimórfico)
// ========================================
/**
* Obtiene color de pelota según índice y progreso de animación
* @param ball_index: Índice de pelota (para seleccionar color de paleta)
* @param progress: Progreso 0.0-1.0 si hay transición LERP externa (PHASE 3)
* @return Color interpolado para esta pelota
*/
virtual Color getBallColor(size_t ball_index, float progress) const = 0;
/**
* Obtiene colores de fondo degradado (top/bottom)
* @param progress: Progreso 0.0-1.0 si hay transición LERP externa (PHASE 3)
* @param tr, tg, tb: Color superior (out)
* @param br, bg, bb: Color inferior (out)
*/
virtual void getBackgroundColors(float progress,
float& tr, float& tg, float& tb,
float& br, float& bg, float& bb) const = 0;
// ========================================
// ANIMACIÓN (solo temas dinámicos)
// ========================================
/**
* Actualiza progreso de animación interna (solo dinámicos)
* @param delta_time: Tiempo transcurrido desde último frame
*/
virtual void update(float delta_time) { }
/**
* ¿Este tema necesita update() cada frame?
* @return false para estáticos, true para dinámicos
*/
virtual bool needsUpdate() const { return false; }
/**
* Obtiene progreso actual de animación interna
* @return 0.0 para estáticos, 0.0-1.0 para dinámicos
*/
virtual float getProgress() const { return 0.0f; }
/**
* Reinicia progreso de animación a 0.0 (usado al activar tema)
*/
virtual void resetProgress() { }
// ========================================
// PAUSA (solo temas dinámicos)
// ========================================
/**
* ¿Está pausado? (solo dinámicos)
* @return false para estáticos, true/false para dinámicos
*/
virtual bool isPaused() const { return false; }
/**
* Toggle pausa de animación (solo dinámicos, tecla Shift+D)
*/
virtual void togglePause() { }
};