Conversor SB3 para MP4

Propósito e uso: esta ferramenta resolve o problema de transformar arquivos SB3 Scratch 3 em vídeos MP4 autônomos para reprodução fora do ambiente Scratch. Usuários principais são professores, criadores de conteúdo e desenvolvedores que precisam de demos portáteis, gravações de aulas ou visualizações de ativos. É utilizado quando é necessária uma representação de vídeo compartilhável e offline de um projeto Scratch, para arquivamento, avaliação ou publicação.
Lógica central e características: a ferramenta aceita arquivos SB3 (ZIP contendo project.json e assets) e gera uma sequência de vídeo linear simulando a linha do tempo do projeto a uma taxa de quadros escolhida pelo usuário. Funções obrigatórias: ingest SB3, saída MP4, framerate, resolução. Funções opcionais/avançadas: inclusão de áudio, vários presets de resolução, processamento em lote, modelos de nomenclatura. Diferenciais: renderização sem runtime Scratch com captura determinística de frames, suporte à transparência e exportação consistente entre sessões. Casos de uso: demonstrações em sala sem runtime, resumos animados de projetos ou tutoriais para docentes.
Entradas e saídas: Entradas: sb3_file (arquivo, obrigatório), target_resolution (largura x altura em pixels, obrigatório), framerate (fps, inteiro, obrigatório), include_audio (booleano, opcional, padrão true), output_name (string, opcional). Saídas: mp4_file (vídeo, MP4), duration (segundos), actual_framerate (fps), final_resolution (largura x altura). Validação: o arquivo SB3 deve ser um ZIP válido com project.json; a resolução deve estar entre 320x240 e 3840x2160; framerate entre 1 e 60.
Algoritmos e Cálculos: Etapas: descompactar SB3; analisar project.json; mapear sprites para camadas; renderizar cada frame em frame_index, capturar posições Stage e Sprite; codificar frames em MP4 com H.264/AAC; duração = total_frames / framerate; áudio embutido se disponível nos assets e ativado.
Indústria/Região & Localização: Saída MP4 segue padrões ISO/IEC; usa vídeo H.264 e áudio AAC; suporta nomes de arquivo e metadados internacionalizados; unidade é pixel para a resolução; sem moeda.
Suposições & Exclusões: Assume SB3 como projeto Scratch válido com assets acessíveis; não executa entradas interativas nem eventos em tempo real; sem buscas de rede em tempo real durante a conversão; exclui exportação de elementos de UI ou estado runtime Scratch além dos frames; direitos/licenças de assets são responsabilidade do usuário.