Do Slide Estático que Morre em 2s ao Pipeline Industrial: Engenharia de Vídeo Vertical em Python com FFmpeg Zoompan e Legendas .ASS

import re
import subprocess
from pathlib import Path

LARGURA, ALTURA, FPS = 1080, 1920, 30

def medir_duracao_audio(mp3_path: Path) -> float:
    """Mede a duração real do stream MP3 via ffprobe (evita dessincronia de cabeçalho)."""
    r = subprocess.run(
        ["ffprobe", "-v", "error", "-show_entries", "format=duration",
         "-of", "default=noprint_wrappers=1:nokey=1", str(mp3_path)],
        capture_output=True, text=True, check=True
    )
    return float(r.stdout.strip())

def dividir_em_cenas(roteiro: str, n_cenas: int = 3) -> list[str]:
    """Separa o roteiro apenas em fim de sentença (. ! ?) — proibido cortar com reticências."""
    frases = [f.strip() for f in re.split(r"(?<=[.!?])\s+", roteiro.strip()) if f.strip()]
    por_cena = max(1, (len(frases) + n_cenas - 1) // n_cenas)
    cenas = [" ".join(frases[i:i + por_cena]) for i in range(0, len(frases), por_cena)]
    while len(cenas) < n_cenas:
        cenas.append(cenas[-1])
    return cenas[:n_cenas]

def montar_filtergraph_ken_burns(imagens: list[Path], duracao_audio: float, ass_path: Path) -> tuple[list[str], str]:
    """Gera o filter_complex com oversampling 2160x3840 -> zoompan 1080x1920 + vinheta + libass."""
    n = len(imagens)
    dur_cena = (duracao_audio + 0.3) / n
    frames_cena = int(dur_cena * FPS) + 15
    inputs, filtros, tags = [], [], []

    for i, img in enumerate(imagens):
        inputs.extend(["-loop", "1", "-t", f"{dur_cena:.2f}", "-i", str(img)])
        expr_z = "min(zoom+0.0005,1.15)" if i % 2 == 0 else "if(eq(on,1),1.15,max(1.001,zoom-0.0005))"
        filtros.append(
            f"[{i}:v]scale=2160:3840:force_original_aspect_ratio=increase,crop=2160:3840,"
            f"zoompan=z='{expr_z}':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':"
            f"d={frames_cena}:s={LARGURA}x{ALTURA}:fps={FPS},"
            f"trim=duration={dur_cena:.2f},setpts=PTS-STARTPTS,"
            f"vignette=PI/4,eq=contrast=1.06:brightness=-0.04:saturation=1.08[v{i}]"
        )
        tags.append(f"[v{i}]")

    ass_esc = str(ass_path.resolve()).replace("\\", "/").replace(":", "\\:")
    filtros.append(f"{''.join(tags)}concat=n={n}:v=1:a=0,ass='{ass_esc}',format=yuv420p[vout]")
    return inputs, ";".join(filtros)