Convertidor SB3 a MP4

Propósito y uso: esta herramienta resuelve el problema de transformar archivos SB3 de Scratch 3 en videos MP4 autónomos para reproducción fuera del entorno Scratch. Los usuarios principales son docentes, creadores de contenido y desarrolladores que necesitan demos portátiles, grabaciones de lecciones o vistas previas de assets. Se utiliza cuando se requiere una representación de video compartible y sin conexión de un proyecto Scratch, para archivo, evaluación o publicación.
Lógica central y características: la herramienta acepta archivos SB3 (ZIP con project.json y assets) y genera una secuencia de video lineal al simular la línea de tiempo del proyecto a una frecuencia de fotogramas elegida por el usuario. Funciones requeridas: ingest SB3, salida MP4, framerate, resolución. Funciones opcionales/avanzadas: inclusión de audio, múltiples preajustes de resolución, procesamiento por lotes y plantillas de nombres. Diferenciadores únicos: renderizado sin runtime de Scratch con captura determinista de cuadros, soporte de transparencia y exportación consistente entre sesiones. Casos de uso: demostraciones en clase sin runtime, resúmenes animados de proyectos o tutoriales para docentes.
Entradas y salidas: Entradas: sb3_file (archivo, requerido), target_resolution (ancho x alto en píxeles, requerido), framerate (fps, entero, requerido), include_audio (booleano, opcional, por defecto true), output_name (cadena, opcional). Salidas: mp4_file (video, MP4), duration (segundos), actual_framerate (fps), final_resolution (ancho x alto). Validación: El archivo SB3 debe ser un ZIP válido con project.json; la resolución debe estar entre 320x240 y 3840x2160; el framerate entre 1 y 60.
Algoritmos & Cálculos: Pasos: descomprimir SB3; analizar project.json; mapear sprites a capas; renderizar cada frame en frame_index, capturar posiciones Stage y Sprite; codificar frames a MP4 con H.264/AAC; duración = total_frames / framerate; audio embebido si está disponible en assets y está activado.
Industria/Región & Localización: MP4 de salida cumple con estándares ISO/IEC; usa video H.264 y audio AAC; admite nombres de archivos y metadatos internacionalizados; la unidad es píxeles para la resolución; sin moneda.
Supuestos y Exclusiones: asume SB3 como proyecto Scratch válido con assets accesibles; no ejecuta entradas interactivas ni eventos en tiempo real; no hay consultas de red en vivo durante la conversión; excluye exportar elementos de UI o estado de runtime de Scratch más allá de los fotogramas; las licencias y permisos de assets son responsabilidad del usuario.