Implementar sistema delta time independiente del framerate

- Migrar de fisica frame-based (60 FPS fijo) a time-based
- Convertir velocidades: x60 multiplicador (pixeles/frame → pixeles/segundo)
- Convertir gravedad: x3600 multiplicador (pixeles/frame² → pixeles/segundo²)
- Añadir calculateDeltaTime() con limitador de saltos grandes
- Actualizar Ball::update() para recibir deltaTime como parametro
- Implementar debug display con valores de fisica en tiempo real
- Documentar proceso completo de migracion en README.md
- Conseguir velocidad consistente entre diferentes refresh rates
- V-Sync independiente: misma velocidad con V-Sync ON/OFF

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

Co-Authored-By: Claude <noreply@anthropic.com>

source/main.cpp

@@ -26,7 +26,7 @@ std::vector<std::unique_ptr<Ball>> balls;
 std::array<int, 8> test = {1, 10, 100, 500, 1000, 10000, 50000, 100000};
 
 bool should_exit = false;  // Controla si la aplicación debe cerrarse
-Uint64 ticks = 0;		   // Tiempo en milisegundos para controlar la actualización
+// ticks eliminado - reemplazado por delta time system
 int scenario = 0;		   // Escenario actual basado en el número de bolas
 std::string text;		   // Texto a mostrar en pantalla
 int text_pos = 0;		   // Posición del texto en la pantalla
@@ -43,6 +43,10 @@ std::string fps_text = "FPS: 0"; // Texto del contador de FPS
 bool vsync_enabled = true; // Estado inicial del V-Sync (activado por defecto)
 std::string vsync_text = "VSYNC: ON"; // Texto del estado V-Sync
 
+// Variables para Delta Time
+Uint64 last_frame_time = 0; // Tiempo del último frame en milisegundos
+float delta_time = 0.0f;    // Tiempo transcurrido desde el último frame en segundos
+
 // Establece el texto en pantalla mostrando el número de bolas actuales
 void setText()
 {
@@ -101,6 +105,30 @@ void toggleVSync()
 	SDL_SetRenderVSync(renderer, vsync_enabled ? 1 : 0);
 }
 
+// Calcula el delta time entre frames
+void calculateDeltaTime()
+{
+	Uint64 current_time = SDL_GetTicks();
+
+	// En el primer frame, inicializar el tiempo anterior
+	if (last_frame_time == 0)
+	{
+		last_frame_time = current_time;
+		delta_time = 1.0f / 60.0f; // Asumir 60 FPS para el primer frame
+		return;
+	}
+
+	// Calcular delta time en segundos
+	delta_time = (current_time - last_frame_time) / 1000.0f;
+	last_frame_time = current_time;
+
+	// Limitar delta time para evitar saltos grandes (pausa larga, depuración, etc.)
+	if (delta_time > 0.05f) // Máximo 50ms (20 FPS mínimo)
+	{
+		delta_time = 1.0f / 60.0f; // Usar 60 FPS como fallback
+	}
+}
+
 // Inicializa SDL y configura los componentes principales
 bool init()
 {
@@ -146,7 +174,7 @@ bool init()
 
 	// Inicializar otros componentes
 	texture = std::make_shared<Texture>(renderer, "resources/ball.png");
-	ticks = SDL_GetTicks();
+	// ticks eliminado - delta time system se inicializa automáticamente
 	srand(static_cast<unsigned>(time(nullptr)));
 	dbg_init(renderer);
 	initBalls(scenario);
@@ -254,19 +282,16 @@ void update()
 		fps_text = "FPS: " + std::to_string(fps_current);
 	}
 
-	if (SDL_GetTicks() - ticks > DEMO_SPEED)
+	// ¡DELTA TIME! Actualizar física siempre, usando tiempo transcurrido
+	for (auto &ball : balls)
 	{
-		ticks = SDL_GetTicks();
+		ball->update(delta_time); // Pasar delta time a cada pelota
+	}
 
-		for (auto &ball : balls)
-		{
-			ball->update();
-		}
-
-		if (show_text)
-		{
-			show_text = !(SDL_GetTicks() - text_init_time > TEXT_DURATION);
-		}
+	// Actualizar texto (sin cambios en la lógica)
+	if (show_text)
+	{
+		show_text = !(SDL_GetTicks() - text_init_time > TEXT_DURATION);
 	}
 }
 
@@ -294,6 +319,15 @@ void render()
 	// Mostrar estado V-Sync en esquina superior izquierda
 	dbg_print(8, 8, vsync_text.c_str(), 0, 255, 255); // Cian para distinguir
 
+	// Debug: Mostrar valores de la primera pelota (si existe)
+	if (!balls.empty())
+	{
+		std::string debug_text = "GRAV: " + std::to_string(balls[0]->getGravityForce()) +
+								 " VY: " + std::to_string(balls[0]->getVelocityY()) +
+								 " FLOOR: " + (balls[0]->isOnFloor() ? "YES" : "NO");
+		dbg_print(8, 24, debug_text.c_str(), 255, 0, 255); // Magenta para debug
+	}
+
 	SDL_RenderPresent(renderer);
 }
 
@@ -308,8 +342,16 @@ int main(int argc, char *args[])
 
 	while (!should_exit)
 	{
+		// 1. Calcular delta time antes de actualizar la lógica
+		calculateDeltaTime();
+
+		// 2. Actualizar lógica del juego con delta time
 		update();
+
+		// 3. Procesar eventos de entrada
 		checkEvents();
+
+		// 4. Renderizar la escena
 		render();
 	}