Commit Graph

10 Commits

Author SHA1 Message Date
df93d5080d docs: Reorganización completa del README.md
**Cambios principales:**

1. **Nueva estructura organizada**:
   - Secciones claramente separadas sin repeticiones
   - Información actualizada y completa
   - Navegación mejorada con separadores

2. **Nuevo contenido agregado**:
   - 🎮 Modos de Funcionamiento (AppMode y SimulationMode)
   - ⚙️ Parámetros de Línea de Comandos (completo)
   - 🐦 Modo BOIDS (documentado)
   - 🖼️ Sistema AppLogo (logo periódico)
   - Tecla O (PNG_SHAPE) agregada

3. **Secciones actualizadas**:
   - Controles: Reorganizados por categoría SIN repeticiones
   - Temas: 15 temas (9 estáticos + 6 dinámicos), 2 páginas
   - Figuras 3D: 9 figuras (incluye PNG_SHAPE)
   - Todas las teclas documentadas (D, Shift+D, K, C, O, P, etc.)

4. **Información eliminada**:
   - Duplicación de "Controles de Temas" (eliminada)
   - Sección de temas repetida (consolidada)
   - Información obsoleta o desactualizada

5. **Mejoras de formato**:
   - Tablas para mejor legibilidad
   - Ejemplos de código con sintaxis
   - Emojis para secciones (navegación visual)
   - Estructura del proyecto actualizada

**Cobertura completa:**
-  AppMode: SANDBOX, DEMO, DEMO_LITE, LOGO
-  SimulationMode: PHYSICS, SHAPE, BOIDS
-  15 temas con sistema de 2 páginas
-  9 figuras 3D incluyendo PNG_SHAPE
-  Parámetros CLI: -w, -h, -z, -f, -F, -m
-  Todas las teclas documentadas
-  Sistema AppLogo explicado
-  Modo BOIDS documentado

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 07:59:32 +02:00
59c5ebe9be Implementar toggle de escalado INTEGER/STRETCH en fullscreen (F5)
Funcionalidad:
- Tecla F5 alterna entre escalado INTEGER y STRETCH
- Solo activo en modo fullscreen F3 (no aplica en F4)
- INTEGER: Mantiene aspecto 4:3 con bandas negras
- STRETCH: Estira imagen a pantalla completa
- Texto informativo: 'SCALING: INTEGER' o 'SCALING: STRETCH'

Implementación:
- Variable integer_scaling_enabled_ (true por defecto)
- toggleIntegerScaling() cambia SDL_RendererLogicalPresentation
- Solo funciona si fullscreen_enabled_ == true
- Ignora la tecla si no estás en modo F3

README actualizado:
- Añadida tecla F5 en controles de ventana
- Actualizada descripción de F3
- Nueva característica en lista principal

Comportamiento:
- Por defecto: INTEGER (mantiene aspecto)
- Presionar F5: Cambia a STRETCH (pantalla completa)
- Presionar F5 otra vez: Vuelve a INTEGER

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 08:38:41 +02:00
3e83e51e2d Actualizar README.md con información completa y correcta
Características actuales actualizadas:
- 6 temas visuales (antes decía 5)
- Transiciones LERP añadidas
- Hot-swap de sprites con tecla N
- 8 Figuras 3D completas (ya no pendientes)
- Paletas 8-24 colores según tema

Controles actualizados:
- Todas las figuras marcadas como implementadas (Q/W/E/R/T/Y/U/I)
- Añadida tecla N para cambio de sprites
- MONOCHROME corregido: todas las pelotas blancas (no tonos de gris)

Temas de colores:
- MONOCHROME: 'Todas las pelotas blancas puras' (antes '8 tonos de gris')
- Añadida sección 'Sistema de Sprites Dinámico'
- Añadida sección 'Controles de Temas' con LERP

Figuras 3D:
- Documentadas las 8 figuras completas (SPHERE, WAVE_GRID, HELIX, TORUS, CUBE, CYLINDER, ICOSAHEDRON, ATOM)
- Eliminada sección 'Figuras Futuras (Pendientes)'
- Descripciones técnicas de cada figura

Detalles técnicos corregidos:
- Resolución: 320x240 (antes 640x360)
- Escala por defecto: x3 (antes x2)
- Tamaño pelota: Dinámico 10x10 o 6x6 (antes fijo 10x10)
- Física: Rebotes 0.30-0.95 (más preciso)
- Añadidos temas y figuras 3D

Nuevas secciones técnicas:
- Sistema de Transiciones LERP (completa explicación con código)
- Sistema de Hot-Swap de Sprites (desafío técnico y solución)
- Texturas disponibles en data/

Estructura del proyecto:
- Añadido ball_small.png en data/
- Actualizada carpeta shapes/ con 8 figuras

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 08:24:49 +02:00
95ab6dea46 Implementar tema MONOCHROME (6º tema visual) - Tecla KP_6
- Fondo negro degradado (similar a NEON)
- 8 tonos de gris: blanco puro a gris muy oscuro
- Estética minimalista monocromática
- Ciclo con tecla B incluye nuevo tema
- Actualizado README con documentación

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 06:58:39 +02:00
91f8bfdd30 Implementar zoom por profundidad Z con perspectiva 3D + toggle
NUEVAS CARACTERÍSTICAS:
- Zoom por profundidad Z: Escala sprites según distancia (0.5x-1.5x)
- Toggle con Numpad / (KP_DIVIDE) para activar/desactivar perspectiva
- Fix transición figura→física: Reset automático de depth_scale a 1.0
- Texto informativo: "DEPTH ZOOM ON/OFF"

IMPLEMENTACIÓN TÉCNICA:
- Ball class: Nueva variable depth_scale_ (0.5-1.5)
- Ball class: Getters/setters getDepthScale() / setDepthScale()
- Engine::addSpriteToBatch(): Parámetro scale con valor defecto 1.0
- Engine::addSpriteToBatch(): Cálculo de vértices escalados centrados
- Engine::updateShape(): Cálculo depth_scale = 0.5 + z_normalized * 1.0
- Engine::render(): Pasa depth_scale al batch en modo SHAPE
- Engine::toggleShapeMode(): Reset depth_scale en salida de figura
- Engine: Variable depth_zoom_enabled_ (true por defecto)
- Batch rendering: Mantiene performance (sin llamadas individuales)

EFECTO VISUAL:
- Pelotas lejanas (Z-): Pequeñas (50%) y oscuras
- Pelotas medias (Z=0): Normales (100%) y brillo medio
- Pelotas cercanas (Z+): Grandes (150%) y brillantes
- Perspectiva 3D realista combinada con Z-sorting

CONTROLES:
- Numpad /: Toggle zoom por profundidad (solo en modo SHAPE)
- Por defecto: ACTIVADO para máximo realismo 3D

README ACTUALIZADO:
- Añadida tecla KP_/ a tabla de controles
- Actualizada sección "Características Técnicas"
- Añadida línea "Zoom por profundidad" en características
- Actualizada sección "Uso" con control de perspectiva

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 21:00:19 +02:00
a484ce69e8 Implementar control manual de escala para figuras 3D + actualizar README
NUEVAS CARACTERÍSTICAS:
- Control de escala dinámico con Numpad +/-/* (30%-300%)
- Protección automática contra clipping según resolución
- Texto informativo muestra porcentaje de escala
- Fix: Redondeo correcto en display de escala (79% → 80%)

CAMBIOS EN README:
- Actualizar tabla de controles (C→F, T→B, añadir Q/W/E/R/T/Y/U/I)
- Documentar sistema polimórfico de figuras 3D
- Añadir sección "Controles de Figuras 3D" con Numpad +/-/*
- Actualizar debug display (8 líneas ahora)
- Expandir sección "Modo RotoBall" → "Sistema de Figuras 3D"
- Documentar Esfera y Cubo implementados
- Listar 6 figuras futuras (Wave/Helix/Torus/Cylinder/Icosahedron/Atom)
- Actualizar estructura del proyecto (añadir source/shapes/)
- Añadir parámetros de escala manual a sección técnica

IMPLEMENTACIÓN TÉCNICA:
- defines.h: Constantes SHAPE_SCALE_MIN/MAX/STEP/DEFAULT
- engine.h: Variable shape_scale_factor_, método clampShapeScale()
- engine.cpp: Handlers Numpad +/-/*, multiplicar scale_factor en updateShape()
- clampShapeScale(): Límite dinámico según tamaño de pantalla (90% máximo)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 20:41:29 +02:00
22e3356f80 Implementar modo RotoBall - Esfera 3D rotante (demoscene effect)
Añadido modo alternativo de simulación que transforma las pelotas en una
esfera 3D rotante proyectada en 2D, inspirado en efectos clásicos de demoscene.

## Características Principales

- **Algoritmo Fibonacci Sphere**: Distribución uniforme de puntos en esfera 3D
- **Rotación dual**: Matrices de rotación en ejes X e Y simultáneos
- **Profundidad Z simulada**: Color modulation según distancia (oscuro=lejos, brillante=cerca)
- **Transición suave**: Interpolación de 1.5s desde física a esfera
- **Sin sprites adicionales**: Usa SDL_SetTextureColorMod para profundidad
- **Performance optimizado**: >60 FPS con 100,000 pelotas

## Implementación Técnica

### Nuevos Archivos/Cambios:
- `defines.h`: Enum SimulationMode + constantes RotoBall (radio, velocidades, brillo)
- `ball.h/cpp`: Soporte 3D (pos_3d, target_2d, depth_brightness, setters)
- `engine.h/cpp`: Lógica completa RotoBall (generate, update, toggle)
  - `generateRotoBallSphere()`: Fibonacci sphere algorithm
  - `updateRotoBall()`: Rotación 3D + proyección ortográfica
  - `toggleRotoBallMode()`: Cambio entre PHYSICS/ROTOBALL
- `README.md`: Documentación completa del modo
- `CLAUDE.md`: Detalles técnicos y algoritmos

## Parámetros Configurables (defines.h)

```cpp
ROTOBALL_RADIUS = 80.0f;           // Radio de la esfera
ROTOBALL_ROTATION_SPEED_Y = 1.5f;  // Velocidad rotación eje Y (rad/s)
ROTOBALL_ROTATION_SPEED_X = 0.8f;  // Velocidad rotación eje X (rad/s)
ROTOBALL_TRANSITION_TIME = 1.5f;   // Tiempo de transición (segundos)
ROTOBALL_MIN_BRIGHTNESS = 50;      // Brillo mínimo fondo (0-255)
ROTOBALL_MAX_BRIGHTNESS = 255;     // Brillo máximo frente (0-255)
```

## Uso

- **Tecla C**: Alternar entre modo física y modo RotoBall
- Compatible con todos los temas de colores
- Funciona con 1-100,000 pelotas
- Debug display muestra "MODE PHYSICS" o "MODE ROTOBALL"

## Performance

- Batch rendering: Una sola llamada SDL_RenderGeometry
- Fibonacci sphere recalculada por frame (O(n) predecible)
- Color mod CPU-side sin overhead GPU
- Delta time independiente del framerate

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 13:03:03 +02:00
7ac29f899b Implementar impulso direccional adaptativo para tecla ESPACIO
- Renombrar pushUpBalls() → pushBallsAwayFromGravity() con lógica direccional
- ESPACIO ahora impulsa en dirección opuesta a gravedad actual:
  * Gravedad DOWN → impulsa ARRIBA (comportamiento original)
  * Gravedad UP → impulsa ABAJO
  * Gravedad LEFT → impulsa DERECHA
  * Gravedad RIGHT → impulsa IZQUIERDA
- Corregir modVel() para aplicar impulso horizontal a todas las pelotas
- Actualizar documentación de controles en README.md

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-27 22:10:33 +02:00
ac57755bd2 Añadir tema RGB y actualizar documentación completa
- Añadido nuevo tema RGB con fondo blanco puro y colores matemáticos
- Actualizado README.md con controles actuales y nuevas características
- Reorganizada documentación de controles por categorías
- Corregida información obsoleta (resolución, temas, problemas)
- Añadido control KP_5 para selección directa del tema RGB
- Mejorada visibilidad del texto adaptando colores por tema

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-18 22:08:28 +02:00
dec8d431f5 Implementar sistema de gravedad direccional con controles de cursor
- Añadir enum GravityDirection (UP/DOWN/LEFT/RIGHT) en defines.h
- Modificar Ball class para soportar gravedad multi-direccional
- Reescribir Ball::update() con lógica direccional completa
- Cambiar on_floor_ por on_surface_ (más genérico)
- Implementar detección de superficie según dirección de gravedad
- Añadir controles de teclado con teclas de cursor
- Actualizar debug display para mostrar dirección actual
- Aplicar fricción correctamente según superficie activa

Controles nuevos:
- ↑/↓/←/→: Cambiar dirección de gravedad
- H: Toggle debug display (incluye nueva info de gravedad)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-17 22:37:19 +02:00