jaildesigner-demos/vibe3_physics
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
be099c198c53931d0aebba83d8827f268d8cfa73
vibe3_physics/ROADMAP.md
Sergio Valor be099c198c Implementar Modo Logo (easter egg) y sistema automático de cursor 
MODO LOGO (Easter Egg):
- Modo especial que muestra logo JAILGAMES como "marca de agua"
- Activación manual: tecla K (perpetuo, no sale automáticamente)
- Auto-salto desde DEMO/DEMO_LITE (15%/10% probabilidad, ≥500 pelotas)
- Configuración fija: PNG_SHAPE + tiny texture + MONOCHROME + 120% escala + 5000 pelotas
- Sistema de 5 acciones variadas con probabilidades ajustadas:
  * SHAPE→PHYSICS gravedad ON (50%) - caída dramática
  * SHAPE→PHYSICS gravedad OFF (50%) - ver rotaciones sin caer
  * PHYSICS→SHAPE (60%) - reconstruir logo y mostrar rotaciones
  * PHYSICS: forzar gravedad ON (20%) - caer mientras da vueltas
  * PHYSICS: forzar gravedad OFF (20%) - flotar mientras da vueltas
- Intervalos 4-8s (aumentado para completar ciclos de rotación PNG_SHAPE)
- Textos informativos suprimidos en Logo Mode
- Corrección cambio de textura: actualiza texture_ y setTexture() en pelotas
- PNG_SHAPE idle reducido a 0.5-2s para animación más dinámica

MEJORAS FÍSICAS GLOBALES:
- Impulso automático al quitar gravedad si >50% pelotas en superficie
- Usa isOnSurface() para detectar pelotas quietas (DEMO/DEMO_LITE/LOGO)
- Evita que quitar gravedad con pelotas paradas no haga nada visible

SISTEMA AUTOMÁTICO DE CURSOR:
- Importado mouse.h/mouse.cpp desde Coffee Crisis Arcade Edition
- Auto-oculta cursor tras 3s de inactividad (namespace Mouse)
- Reaparece inmediatamente al mover ratón
- Funciona en todos los modos (ventana, fullscreen F3, real fullscreen F4)
- Eliminadas llamadas manuales SDL_ShowCursor/HideCursor
- Soluciona bug: cursor visible al iniciar con argumento -f

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 23:31:04 +02:00

9.3 KiB
Raw Blame History

ROADMAP - ViBe3 Physics

Estado Actual ✅

Figuras 3D (8/8 Completadas)

  • ✅ Q - SPHERE (Esfera Fibonacci)
  • ✅ W - WAVE_GRID (Malla ondeante) - ⚠️ Necesita mejora de movimiento
  • ✅ E - HELIX (Espiral helicoidal)
  • ✅ R - TORUS (Toroide/donut)
  • ✅ T - CUBE (Cubo rotante)
  • ✅ Y - CYLINDER (Cilindro) - ⚠️ Necesita rotación multi-eje
  • ✅ U - ICOSAHEDRON (Icosaedro D20)
  • ✅ I - ATOM (Núcleo + órbitas)

Temas Visuales (6/6 Completadas)

  • ✅ SUNSET (Atardecer)
  • ✅ OCEAN (Océano)
  • ✅ NEON (Neón vibrante)
  • ✅ FOREST (Bosque)
  • ✅ RGB (Círculo cromático matemático)
  • ✅ MONOCHROME (Monocromo - blanco puro)

Sistemas de Presentación

  • ✅ Transiciones LERP entre temas (0.5s suaves)
  • ✅ Carga dinámica de texturas desde data/balls/
  • ✅ Hot-swap de sprites con tecla N (cicla entre todas las texturas)
  • ✅ PNG_SHAPE (O) - Logo "JAILGAMES" con rotación legible

Mejoras de Presentación 🎨

1. ✅ Mejorar Animaciones de Figuras 3D

Descripción: Añadir movimientos más dinámicos e interesantes a algunas figuras Prioridad: Media Estado: ✅ COMPLETADO Detalles:

CYLINDER (Y):

  • ✅ Rotación principal en eje Y (spin horizontal continuo)
  • ✅ Tumbling ocasional en eje X cada 3-5 segundos
  • ✅ Transiciones suaves con ease-in-out (1.5s duración)
  • ✅ Efecto visual: cilindro "se da una vuelta" ocasionalmente

WAVE_GRID (W):

  • ✅ Vista frontal paralela a pantalla (sin rotación confusa)
  • ✅ Pivoteo sutil en ejes X e Y
  • ✅ Esquinas se mueven adelante/atrás según posición
  • ✅ Movimiento ondulatorio + pivoteo = efecto "océano"
  • ✅ Velocidades lentas (0.3-0.5 rad/s) para organicidad

2. ✅ Modo DEMO (Auto-play)

Descripción: Modo demostración automática con acciones aleatorias Prioridad: Alta Estado: ✅ COMPLETADO Detalles:

  • ✅ Toggle con tecla D
  • ✅ Timer que ejecuta acciones cada 3-8 segundos (configurable)
  • ✅ Acciones: gravedad, figuras, temas, escenarios, impulso, profundidad, escala, sprite
  • ✅ Secuencia pseudo-aleatoria con pesos configurables (defines.h)
  • ✅ Totalmente interactivo - usuario puede seguir usando controles
  • ✅ Indicador visual "DEMO MODE" centrado en pantalla (naranja)
  • ✅ Eliminado sistema auto-restart antiguo (ya no necesario)

3. ✅ Resolución Lógica Configurable

Descripción: Especificar resolución lógica por parámetros de línea de comandos Prioridad: Media Estado: ✅ COMPLETADO Detalles:

  • ✅ Parámetros -w/--width <px> y -h/--height <px>
  • ✅ Parámetro -f/--fullscreen para pantalla completa
  • ✅ Defaults: 1280x720 en ventana (si no se especifica)
  • ✅ Validación: mínimo 640x480
  • ✅ Help text con --help
  • Ejemplo: ./vibe3_physics -w 1920 -h 1080 -f

4. ✅ Implementar Modo Logo (Easter Egg)

Descripción: Modo especial que muestra el logo JAILGAMES como "marca de agua" Prioridad: Alta (característica distintiva) Estado: ✅ COMPLETADO Detalles:

  • ✅ Figura: Solo PNG_SHAPE (logo JAILGAMES)
  • ✅ Textura: Siempre "tiny" (pelota más pequeña)
  • ✅ Tema: Siempre MONOCHROME (blanco puro)
  • ✅ Escala: 120% (figuras más grandes que normal)
  • ✅ Pelotas mínimas: 500
  • ✅ Tecla manual: K (activa/desactiva modo logo)
  • ✅ Alterna entre modo SHAPE y modo PHYSICS (como DEMO)
  • ✅ Mantiene configuración fija (no cambia tema/textura/escala)
  • ✅ Es como un "DEMO específico del logo"

✅ Integración con DEMO LITE:

  • ✅ Requisitos para salto automático:
    • Mínimo 500 pelotas
    • Tema MONOCHROME activo
    • Si se cumplen → cambia automáticamente textura a "tiny" y escala a 120%
  • ✅ Duración: Menos tiempo que DEMO normal (es un "recordatorio")
  • ✅ Después: Vuelve a DEMO LITE normal

✅ Integración con DEMO:

  • ✅ Requisitos: Mínimo 500 pelotas
  • ✅ Acción: Cambia automáticamente a: MONOCHROME + tiny + escala 120%
  • ✅ Duración: Menos tiempo que acciones normales
  • ✅ Después: Vuelve a DEMO normal

✅ Proporción temporal sugerida:

  • ✅ DEMO/DEMO_LITE normal: 80-90% del tiempo
  • ✅ Modo Logo: 10-20% del tiempo (aparición ocasional como "easter egg")

5. ⏳ Mejorar Sistema de Vértices PNG_SHAPE

Descripción: Con 50 pelotas no activa modo vértices correctamente Prioridad: Baja (mejora visual) Estimación: 1 hora Detalles:

  • Comportamiento actual: Con 50 pelotas usa filas alternas en bordes
  • Comportamiento deseado: Activar modo VÉRTICES (extremos izq/der de cada fila)
  • Problema: Condición num_points < 150 no es suficientemente agresiva
  • Solución propuesta:
    • Ajustar umbrales de activación de vértices
    • Mejorar algoritmo extractCornerVertices() para detectar puntos clave
    • Considerar densidad de píxeles en decisión (no solo cantidad absoluta)

5. 🐛 Corregir Escalado de Pelotas en Reposo

Descripción: Las pelotas cambian de tamaño cuando están quietas (bug visual) Prioridad: Alta (bug visible) Estimación: 30 minutos Detalles:

  • Síntoma: Pelotas en reposo (velocidad ≈ 0) se escalan incorrectamente
  • Posible causa:
    • Scale factor calculado desde velocidad o energía
    • División por cero o valor muy pequeño
    • Interpolación incorrecta en modo transición
  • Investigar: Ball::render(), scale calculations, depth brightness
  • Solución esperada: Tamaño constante independiente de velocidad

6. ⏳ Sistema de Release

Descripción: Empaquetado para distribución standalone Prioridad: Baja Estimación: 30 minutos Detalles:

  • Crear carpeta release/
  • Script Python pack_resources.py para empaquetar
  • Incluir SDL3.dll
  • Incluir icon.png (si existe)
  • Empaquetar data/ en archivo .dat o .zip
  • Target make release en Makefile
  • README.txt con instrucciones

Futuras Mejoras (Ideas)

Performance

  • Spatial partitioning para colisiones ball-to-ball
  • Level-of-detail para 100K+ pelotas
  • GPU compute shaders para física masiva

Efectos Visuales

  • Trails (estelas de movimiento)
  • Heatmaps de velocidad/energía
  • Bloom/glow para sprites

Física Avanzada

  • Colisiones entre partículas
  • Viento (fuerza horizontal)
  • Campos magnéticos (atracción/repulsión)
  • Turbulencia

Shapes PNG

  • Voxelización 3D para PNG_SHAPE (Enfoque B)
    • Actualmente: Extrusión 2D simple (píxeles → capas Z)
    • Futuro: Voxelización real con detección de interior/exterior
    • Permite formas 3D más complejas desde imágenes
    • Rotación volumétrica en vez de extrusión plana

Interactividad

  • Mouse: click para aplicar fuerzas
  • Mouse: drag para crear campos
  • Mouse wheel: ajustar intensidad

Historial de Cambios

2025-10-04 (Sesión 5) - PNG Shape + Texturas Dinámicas + CLI

  • ✅ PNG_SHAPE implementado - Tecla O para activar logo "JAILGAMES"
  • ✅ Carga de PNG 1-bit con stb_image
  • ✅ Extrusión 2D (Enfoque A) - píxeles → capas Z
  • ✅ Detección de bordes vs relleno completo (configurable)
  • ✅ Tamaño 80% pantalla (como otras figuras)
  • ✅ Rotación "legible" - De frente con volteretas ocasionales (3-8s idle)
  • ✅ Fix: Z forzado a máximo cuando está de frente (texto brillante)
  • ✅ Excluido de DEMO/DEMO_LITE (logo especial)
  • ✅ Sistema de texturas dinámicas - Carga automática desde data/balls/
  • ✅ Tecla N cicla entre todas las texturas PNG encontradas
  • ✅ Orden alfabético con normal.png primero por defecto
  • ✅ Display dinámico del nombre de textura (uppercase)
  • ✅ Física mejorada SHAPE - Constantes separadas de ROTOBALL
  • ✅ Pegajosidad 2.67x mayor (SPRING_K=800 vs 300)
  • ✅ Pelotas se adhieren mejor durante rotaciones rápidas
  • ✅ Parámetros de línea de comandos - -w/-h/-f/--help
  • ✅ Resolución configurable (mínimo 640x480)
  • 📝 Preparado para voxelización 3D (Enfoque B) en futuro

2025-10-04 (Sesión 4) - Modo DEMO + Mejoras Animaciones

  • ✅ Implementado Modo DEMO (auto-play) - Tecla D para toggle
  • ✅ Sistema de acciones aleatorias cada 3-8 segundos (configurable)
  • ✅ 8 tipos de acciones con pesos de probabilidad ajustables
  • ✅ Totalmente interactivo - usuario puede seguir controlando
  • ✅ Display visual "DEMO MODE" centrado en naranja
  • ✅ Mejoras animaciones 3D: tumbling en cilindro + pivoteo en wave grid
  • ✅ CYLINDER: tumbling ocasional en eje X cada 3-5s con ease-in-out
  • ✅ WAVE_GRID: pivoteo sutil paralelo a pantalla (efecto océano)
  • ❌ Eliminado sistema auto-restart antiguo (ya no necesario)

2025-10-04 (Sesión 3)

  • ✅ Implementado tema MONOCHROME (6º tema)
  • ✅ Sistema LERP para transiciones suaves de temas (0.5s)
  • ✅ Hot-swap de sprites con tecla N (ball.png ↔ ball_small.png)
  • ✅ Tamaño dinámico de pelotas desde texture->getWidth()
  • ✅ Ajuste de posiciones inteligente al cambiar sprite
  • 📝 Añadidas mejoras propuestas para CYLINDER y WAVE_GRID

2025-10-03 (Sesión 2)

  • ✅ Implementadas 8 figuras 3D (SPHERE, WAVE_GRID, HELIX, TORUS, CUBE, CYLINDER, ICOSAHEDRON, ATOM)
  • ✅ Sistema polimórfico de shapes con herencia virtual

2025-10-02 (Sesión 1)

  • ✅ Migración desde vibe1_delta
  • ✅ Sistema de gravedad direccional (4 direcciones)
  • ✅ Coeficientes de rebote variables (0.30-0.95)
  • ✅ 5 temas de colores iniciales

Última actualización: 2025-10-04

Reference in New Issue View Git Blame Copy Permalink