Communitygithub.com

Produção de Vídeo Pixel Retro 16-Bit

Sistema completo de produção e constituição visual/áudio para criar vídeos explicativos e documentários em pixel-art retro 16-bit, com qualidade de transmissão, usando React + HTML5 Canvas, com narração, sincronia de legendas SRT, transições perfeitas, BGM 16-bit + SFX procedural, interface de reprodução estilo NLE e exportação MP4 1920x1080 no lado do cliente.

O que é Produção de Vídeo Pixel Retro 16-Bit?

Esta skill implementa um sistema completo de produção de vídeos em pixel-art 16-bit, inspirado em estéticas de SNES / Chrono Trigger / Sea of Stars / Celeste, para criar documentários e vídeos explicativos com qualidade de broadcast. Ela opera em uma grade de pixels virtuais de 384×216 (escala 5x para 1920×1080), garantindo que cada pixel permaneça nítido sem borrões. A skill gerencia todos os aspectos da produção: desde a ingestão de script, narração e legendas SRT, passando por storyboard baseado em atos, renderização de cenas com engine própria de pixel sprites e tipografia, até um sistema de áudio de 3 faixas (narração, BGM multi-ato com ducking automático e SFX sincronizados). O resultado final é exportado como MP4 H.264/AAC em 1920×1080 no próprio navegador, utilizando WebCodecs e mp4-muxer. A skill é ideal para desenvolvedores que precisam criar vídeos animados narrativos com estética retrô consistente, transições suaves e sem cortes abruptos, e é baseada no repositório de referência https://github.com/Lithium023/16bit-video-forNeon.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lithium023/retro-16bit-pixel-video-SKILL/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de Produção de Vídeo Pixel Retro 16-Bit

Blueprint de Referência

  • Repositório Canônico de Referência: https://github.com/Lithium023/16bit-video-forNeon
  • Benchmark de Referência: Documentário de 5m14,5s (314,5s) (AI 发展史), 55 cenas de pixel 16-bit feitas à mão em 5 atos, 155 cues SRT sincronizadas, 9 transições suaves, áudio de 3 faixas (Narração + BGM 16-bit de 5 atos com ducking automático + 94 SFX 16-bit sincronizados) e exportação MP4 1920×1080 H.264/AAC no lado do cliente mais rápida que o tempo real.
  • Ao iniciar um novo projeto: Espelhe a arquitetura de módulos e os padrões visuais/áudio/exportação documentados nesta skill e em seus arquivos references/. Se o usuário fornecer um novo script, áudio de narração ou arquivo SRT, mantenha todo o motor, constituição estética, interface de estúdio e pipeline de exportação MP4 idênticos, enquanto cria novos capítulos específicos do tópico, cenas de pixel, sprites e cues sonoras.

1. Constituição Estética (Innegociável)

Pense em SNES / Chrono Trigger / Sea of Stars / Celeste combinado com gráficos animados de documentário de alta qualidade — quente, rico, atmosférico e cristalino. Nunca minimalismo de wireframe estéril, nunca borrão de baixa resolução bagunçado, nunca néon berrante.

  1. Grade de Pixel Virtual Puro 16-Bit (384×216 Paisagem / 216×384 Retrato):

    • Desenhe todos os mundos pixel, fundos, céus pontilhados, sprites, adereços e ícones em um canvas virtual fora da tela em 384×216 (16:9) ou 216×384 (9:16).
    • Por que 384×216? É uma escala inteira exata de 5× para 1920×1080 (384 × 5 = 1920, 216 × 5 = 1080). Copie para o canvas de saída HD com ctx.imageSmoothingEnabled = false para que cada pixel permaneça perfeitamente nítido, sem tremulação ou desfoque de subpixel.
    • Trave animações de pixel ociosas/ambientes em uma cadência retro nítida (stepT = Math.floor(time * 8..10) / 10), enquanto as câmeras panorâmicas, curvas de easing e transições rodam a 60fps sedosos (30fps na exportação).
  2. Paleta 16-Bit Coesa de 28 Cores, Cinematográfica e Quente:

    • Construa cada cena a partir de uma paleta compartilhada disciplinada (PAL) abrangendo 6 famílias emocionais: Azul Noturno Profundo/Vazio, Dourado Lâmpada Quente/Creme, Coral Aconchegante/Ameixa, Verde Azulado Fresco/Pinho, Gelo Ártico Invernal e Verde Oliva Monocromático Game Boy (reservado estritamente para cortes bruscos dramáticos de virada de trama como "但其实").
    • Nunca use gradientes planos sem textura. Use Pontilhamento Bayer Ordenado 4×4 (drawDitheredSky, drawDitheredGlow) para costuras de céu, halos de lâmpadas, explosões de amanhecer e dissoluções de pixel.
    • Consulte references/visual-and-typography-spec.md para tokens hexadecimais exatos, matemática da matriz Bayer e primitivas de desenho de sprite.
  3. A Lei de Ouro da Tipografia (Texto CJK Sem Embaçamento):

    • Nunca desenhe texto chinês pequeno no canvas de baixa resolução 384×216 e aumente a escala — caracteres chineses densos (最/魔/幻/澜/疆) se transformarão em uma mancha ilegível ("糊成一坨").
    • Títulos e Emblemas Cinéticos na Cena (Sobreposição HD de Duas Camadas): Renderize títulos diretamente no canvas HD (1920×1080) usando sprites de glifos pixel binários rasterizados a 38px (manchetes grandes), 32px (subtítulos) ou 24px (tags HUD), com um contorno de tinta escura de 1 pixel com 8 vizinhos, sombra projetada escalonada e preenchimento metálico de 3 bandas (realce superior / tom médio / sombra inferior), ampliado via nearest-neighbor (imageSmoothingEnabled = false).
    • Legendas de Broadcast no Terço Inferior: Mantenha as legendas em tipografia sans-serif original limpa e de alta legibilidade (Noto Sans SC / sistema sans-serif negrito dentro de uma pílula escura translúcida sutil com borda âmbar fina em y = 0.905 * h). Não pixele a faixa de legenda principal, a menos que explicitamente solicitado.
    • Nunca deixe brilhos pontilhados obscurecerem rótulos críticos: Qualquer ano-chave, métrica ou emblema de pico (2026, 1950 — FUTURO) deve estar dentro de uma placa escura de alto contraste nítida com uma borda de pixel dourada/verde azulada desenhada após os brilhos de fundo.
  4. Zero Entradas Bruscas e Zero Cortes Secos Acidentais:

    • Cada limite de cena deve ter uma transição intencional da biblioteca de 9 transições (aperture-open, whip-blinds, iris-flash, razor-wipe, invert-strobe, camera-pullback, ember-curtain, gravity-shatter, horizon-burst) com interpolação suave de câmera fromCam → toCam e crossfade de tipografia. Mesmo uma reversão dramática usa um wipe de varredura CRT deliberado (invert-strobe), nunca um salto chocante e não motivado.
    • Cada elemento gráfico com múltiplas partes dentro de uma cena (4 cartões de modalidade, 4 módulos de recurso, 4 caixas, etapas de monolito, banner de ano final) DEVE animar com coreografia proposital — pop-ins de mola escalonados, feixes de energia varrendo conectando hub → nó, placas de RPG se desdobrando ou ticks de odômetro/hodômetro sincronizados com as palavras faladas. Nunca apenas alterne if (localTime > X) drawBox().
    • Cada final/fim merece uma sequência de encerramento criativa de assinatura (por exemplo, floração do horizonte ao amanhecer + personagens olhando para frente + placa se desdobrando + odômetro de ano girando 1950 → 2026 → FUTURO + arco de estrela brilhante varrendo + acorde maior quente e harmonioso).

2. Fluxo de Trabalho de Produção Padrão

Siga esta sequência exata ao criar um novo vídeo de pixel 16-bit do zero (ou estendendo um existente):

Passo 1: Ingerir Script, Narração e Temporização SRT

  • Analise o áudio de narração real do usuário e o arquivo de legenda .srt (ou gere um SRT com timestamps precisos alinhados à narração).
  • Normalize micro-lacunas (< 0,18s) entre cues adjacentes para que as legendas nunca pisquem por 2 quadros.
  • Estabeleça CLIP_DURATION a partir do tempo final exato do áudio/SRT.

Passo 2: Storyboard e Folha de Batidas (Blueprint de Ritmo)

  • Divida o filme em 3–6 Atos Narrativos (cada um com sua própria temperatura de cor e capítulo BGM) e cenas de 3–8 segundos (aproximadamente 1–3 cues de legenda por batida visual).
  • Para vídeos longos (>60s), construa iterativamente em capítulos de 30 segundos (retroPixelChapterTwo.ts, retroPixelChapterThree.ts, etc.) para que cada tomada receba pixel art genuinamente feito à mão, em vez de modelos reciclados.
  • Atribua a cada cena em timeline.ts:
    • index, id, title, quote, start, end (estritamente contíguo, sem lacunas/sobreposições cobrindo [0, CLIP_DURATION])
    • transitionIn + transitionLabel
    • visualBeat (descrição editorial concisa para o painel de storyboard)
    • cor de destaque accent para a faixa da linha do tempo.

Passo 3: Construir o Motor de Pixel Central e os Renderizadores de Capítulo Modulares

Espelhe a separação limpa de interesses do https://github.com/Lithium023/16bit-video-forNeon:

  • src/video/types.ts — SrtCue, SceneCut, TransitionType, RenderSettings, ExportResolution, ExportStatus.
  • src/video/srtParser.ts — Analisador SRT determinístico, AUDIO_SRC, BGM_SRC, CLIP_DURATION, getActiveCue.
  • src/video/timeline.ts — SCENE_CUTS contíguo, curvas de easing (easeOutExpo, easeOutBack, easeOutCubic, easeInOutQuint, smoothstep), getStaggerProgress, getSceneAtTime, getActiveTransition, energia de narração sintética de fallback.
  • src/video/pixelSprites.ts — PAL, BAYER_4X4, pxRect, pxOutline, pxCircle, pxRing, pxLine, drawDitheredSky, drawDitheredGlow, drawSprite, pxBitmapText, sprites de pixel art reutilizáveis e auxiliares de ambiente (pxPineTree, pxCloud, pxSparkle, pxStarfield).
  • src/video/pixelTypography.ts — Rasterizador de glifos pixel binários em cache (drawPixelString, drawPixelKineticTitle, drawPixelHudTag).
  • src/video/retroPixelRenderer.ts — Pool de buffers virtuais mestre (bufA, bufB, bufDither), calculadora de deriva de câmera, compositor de 9 transições, scanlines CRT, handoff de tipografia e despachante para arquivos modulares retroPixelChapter*.ts.
  • src/video/sceneRenderers.ts — renderVideoFrame de nível superior: cena de pixel → vinheta sutil (0,14) → legendas originais limpas no terço inferior → barra de progresso âmbar fina → fade de cauda de 0,25s.

Passo 4: Pontuar o Filme Completo (Sistema de Áudio de 3 Faixas)

Leia references/choreography-and-audio-spec.md para detalhes completos:

  1. Faixa 1 — Narração: Âncora narrativa mestre (volume = 1,0, fade de cauda de 0,25s).
  2. Faixa 2 — BGM 16-Bit Multi-Ato: Use faixas 16-bit genuínas de código aberto (CC0 / CC BY 3.0, ex.: OpenGameArt / BoxCat Games / Kevin MacLeod / OSTs chiptune) que combinem com o clima de cada ato, costure-as em uma única faixa BGM sem lacunas com crossfades suaves correspondentes aos timestamps dos atos e aplique ducking automático de narração (duck = 1 - voiceEnergy * 0,22) em aproximadamente 0,58 * bgmVolume.
  3. Faixa 3 — SFX 16-Bit Sincronizados (retroSfxEngine.ts): Combine SFX de transição automáticos para cada corte de cena + SFX de batida musical colocados manualmente (bipes pentatônicos ascendentes para revelações de 4 cartões, cliques de cristal, zumbidos de corte, ticks de odômetro e um acorde maior de final quente). Todos os SFX sintetizam-se de forma limpa via Web Audio (BaseAudioContext + scheduledTime opcional) para que a reprodução ao vivo e a exportação MP4 offline soem idênticas.

Passo 5: Visualização NLE de Estúdio e Exportação MP4 1080p no Lado do Cliente

Leia references/mp4-export-and-qa-spec.md para detalhes completos:

  • Shell do Estúdio: Espaço de trabalho obsidiana escuro (#07080B), TopBar (título da marca, navegação de salto de capítulo, única ação primária Exportar 1080p MP4 com progresso ao vivo do estágio + cancelamento instantâneo), Palco Canvas (alternância 16:9 / 9:16, play/pause/scrub/step/velocidade/mudo/tela cheia), linha do tempo visual multi-faixa (blocos de cena + blocos de legenda + cabeça de reprodução) e painel editorial direito (Storyboard e Transições / Fala do Locutor / Ajustes de Cena incluindo alternância MP4 1080p vs 720p, controles deslizantes BGM/SFX, alternância de legenda, botões de salto de destaque).
  • Exportação MP4 (videoExporter.ts): Use mp4-muxer + WebCodecs (VideoEncoder H.264 + AudioEncoder AAC/Opus) do navegador com mixagem de áudio PCM direto offline + carimbo de SFX por cache, padrão para 1920×1080 @ 30fps, 14 Mbps (1080×1920 para retrato), com fallback automático para MP4 MediaRecorder nativo do Safari.

Passo 6: Testes Unitários e Verificação Visual no Navegador (Obrigatório)

  • Desacople a lógica pura e teste com node:test (npx tsx --test):
    1. Análise de timestamps SRT e cobertura de cues (srtParser.test.ts)
    2. Cortes de cena contíguos e transições sem lacunas/sobreposições (timeline.test.ts)
    3. Validação de pontilhamento Bayer e grade retangular de sprites (pixelSprites.test.ts)
    4. Cobertura de cues SFX cronológica e janela de acionamento apenas para frente (retroSfxEngine.test.ts)
    5. Configuração de resolução de exportação, prioridade MIME MP4 e linha do tempo de energia da narração (videoExporter.test.ts)
  • Suporte ao parâmetro de consulta de URL ?t=<segundos> em App.tsx para que verificações automatizadas de navegador headless possam pular diretamente para qualquer cena, ponto médio de transição, batida de animação de entrada e quadro final para inspeção visual.
  • Verifique se a exportação MP4 ao vivo atinge Renderizando MP4, cancela de forma limpa de volta ao estado ocioso sem callbacks obsoletos e emite zero erros de console do navegador.

3. Regras e Armadilhas Difíceis a Nunca Repetir

ArmadilhaCausa RaizSolução Obrigatória
Títulos chineses parecem borrados/aglomerados ("糊成一坨")Renderizar CJK no canvas de baixa resolução 384×216 e depois aumentar a escalaRenderize títulos CJK no canvas HD via sprites de glifos binários de 38px/32px (thresh = 142..148 para CJK, 88 para ASCII) com contorno de 1px de tinta + bisel de 3 bandas; mantenha legendas do terço inferior em sans-serif original limpa
Cortes secos entre cenas tardiastransitionIn ausente ou handoff visual incompatívelCada corte em SCENE_CUTS deve definir um transitionIn proposital; pareie transições temáticas (ex.: flor desabrochando se dissolvendo em cristais de gelo caindo → mergulho gravity-shatter no inverno)
Elementos aparecem abruptamenteDesenhar cartões/caixas de UI com if (localTime > t) booleanos crusConduza cada elemento com clamp01((localTime - delay) / dur) + easeOutBack / easeOutExpo, conectores de feixe, desdobramento de placas ou contadores giratórios
Rótulo do clímax oculto ou parcialmente digitadoBrilho desenhado sobre o rótulo, ou progresso derivado de contador de segmento limitadoDesenhe rótulos dentro de placas escuras emolduradas após brilhos; amarre o progresso da revelação diretamente ao localTime em vez de um parâmetro de curva limitada
Exportação MP4 offline trava em 4%Conectar mais de 90 SFX (~280 BiquadFilterNodes) a um único OfflineAudioContext de 314sDecodifique narração + BGM uma vez, misture diretamente em PCM Float32Array estéreo, renderize cada SFX curto único em um OfflineAudioContext pequeno de 0,55–1,55s (em cache) e carimbe no PCM
Codificação de áudio MP4 offline leva mais de 12sAlimentar pequenos chunks AudioData de 4096 amostras com polling de drenagem soltoAgrupe AudioData em chunks de 1 segundo (48000 amostras) (~315 chunks para 5m) e aperte o fallback de drenagem para 20ms
Clicar em Cancelar durante a renderização MP4 deixa o botão travadowaitForEncoderDrain resolve após cancel() e emite um último onProgressEnvolva onProgress/onComplete/onError em guards !cancelled e verifique if (isCancelled()) return imediatamente após cada await

4. Arquivos de Referência Nesta Skill

Carregue estas referências conforme necessário durante a execução:

  • references/visual-and-typography-spec.md — Paleta de cores PAL exata, canvas 384×216 e matemática de escala inteira, pontilhamento Bayer, rasterizador de tipografia pixel e 9 receitas de transição.
  • references/choreography-and-audio-spec.md — Padrões de animação de entrada, crossfade BGM de 5 atos + matemática de ducking e 15 receitas de SFX 16-bit processuais.
  • references/mp4-export-and-qa-spec.md — Pipeline de exportação MP4 no lado do cliente de 4 níveis, mixer PCM offline rápido, especificação de UI de estúdio NLE e lista de verificação de QA unitário e de navegador.

Habilidades Relacionadas