Skip to content

Zoom automático cinematográfico: acercar, seguir y volver al 100 % - #16

Merged
angelito-systems merged 1 commit into
masterfrom
zoom-engine
Nov 3, 2026
Merged

angelito-systems merged 1 commit into
masterfrom
zoom-engine

Conversation

@angelito-systems

Copy link
Copy Markdown
Member

Causa raíz de que el zoom se quedara puesto

AutoZoom.Propose agrupaba clics y, si el siguiente zoom empezaba menos de 1 s después del anterior, los fusionaba (End = Max(...)). Cada zoom duraba del clic −0,8 s al último clic +1,6 s, así que haciendo clic cada 2–4 s (uso normal) todo se encadenaba en un único zoom casi permanente, centrado en el promedio de todos los clics. Además, los zooms solapados se sumaban (1,8× + 0,8 extra…).

Qué cambia

  • Máquina de estados Idle → ZoomingIn → Focused → Tracking → ZoomingOut → Idle:
    • clic → acerca y llega justo en el momento del clic;
    • más clics dentro de la zona ampliada → mantiene y retrasa el retorno;
    • clic fuera de la zona → se desplaza sin alejarse (el tramo que sale y el que entra se solapan con pesos que suman exactamente 1);
    • sin clics durante el tiempo de retorno → vuelve al 100 %, centro y encuadre originales;
    • un clic durante el alejamiento lo cancela suavemente (no se apila otro zoom); mover el ratón sin clic nunca hace zoom.
  • Entrada y salida con duración propia (RampOut, compatible con proyectos anteriores).
  • Solapes promediados, no sumados, igual en la vista previa (Evaluate) y en FFmpeg (FfmpegViewExpr, CPU y GPU).
  • Ajustes por proyecto en el editor (Zoom automático): activar/desactivar, seguir entre regiones, zoom por clic (1,5×), retorno por inactividad (2 s), permanencia mínima (1,2 s), acercamiento (450 ms), alejamiento (600 ms). Se aplican al momento.
  • Regenerar reemplaza solo los zooms automáticos y conserva los manuales; en proyectos antiguos pregunta si reemplazar los anteriores.
  • Inspector: inicio, duración, región, intensidad, curva y retorno a 1,0× de cada zoom. Editar o arrastrar un zoom automático lo convierte en manual.

Cómo se probó

  • 66+ pruebas; nuevas ZoomEngineTests para los escenarios pedidos: un clic y vuelta al 100 %; varios clics en la misma región; clic en otra región (sin bajar de 1,5×, sin saltos); movimiento sin clic; clic durante el alejamiento; pausa; proyecto de 1 h (escala acotada, vuelve a 100 % en cada pausa larga, sin saltos de fotograma a fotograma)
  • Regresión de render: un zoom automático en pleno desplazamiento exportado por CPU y por GPU coincide por píxeles con la vista previa
  • Probado en la app con una grabación real

🤖 Generated with Claude Code

Root cause: AutoZoom merged any zoom starting <1 s after the previous
one, so normal clicking chained into one near-permanent zoom centered on
the average of all clicks; overlapping zooms also added up.

Now a state machine (idle, zooming in, focused, tracking, zooming out)
zooms in to arrive at each click, holds while clicks stay in view, pans
to clicks elsewhere by crossfading segments whose weights sum to 1, and
eases back out after the idle time. Separate in/out ramps; overlaps are
weight-averaged identically in preview and ffmpeg. Settings live in the
project and the editor; regenerating keeps manual zooms.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@angelito-systems
angelito-systems merged commit 6790941 into master Nov 3, 2026
4 checks passed
@angelito-systems
angelito-systems deleted the zoom-engine branch November 3, 2026 16:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant