Communitygithub.com

retro-16bit-pixel-video

Sistema de producción integral y constitución visual/auditiva para crear videos explicativos y documentales de gráficos pixel art retro de 16 bits con calidad de transmisión, usando React + HTML5 Canvas con locución, sincronización de subtítulos SRT, transiciones de píxeles perfectas, BGM de 16 bits + SFX procedurales, interfaz de reproducción estilo NLE de estudio y exportación a MP4 1920x1080 del lado del cliente.

¿Qué es retro-16bit-pixel-video?

Esta habilidad, llamada 'retro-16bit-pixel-video', es un sistema de producción audiovisual completo para la creación de videos explicativos y documentales con estética de videojuegos retro de 16 bits (como SNES, Chrono Trigger o Sea of Stars). Combina el poder de React con Canvas HTML5 para renderizar animaciones de píxeles, sincronizar locuciones con subtítulos SRT, aplicar transiciones suaves y generar un paisaje sonoro completo (BGM + SFX). Está pensada para desarrolladores que deseen construir, extender o reestilizar videos pixel art de alta calidad, ofreciendo un flujo de trabajo modular, desde la ingesta de guiones y audios hasta la exportación de un archivo MP4 1920×1080 en el propio navegador. La habilidad se basa en un estricto conjunto de reglas estéticas (paleta de 28 colores, grid de 384×216, tipografía dorada para CJK) y un motor de renderizado que evita problemas comunes como texto chino borroso o cortes abruptos, garantizando un resultado profesional y consistente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Producción de Video Pixel Retro de 16 Bits

Plano de Referencia

  • Repositorio Canónico de Referencia: https://github.com/Lithium023/16bit-video-forNeon
  • Punto de Referencia: Documental de 5m14.5s (314.5s) de duración (AI 发展史), 55 escenas pixel art de 16 bits hechas a mano en 5 actos, 155 señales SRT sincronizadas, 9 transiciones perfectas, audio de 3 pistas (Locución + BGM de 16 bits de 5 actos con auto-ducking + 94 SFX de 16 bits sincronizados) y exportación a MP4 H.264/AAC 1920×1080 del lado del cliente más rápido que el tiempo real.
  • Al iniciar un nuevo proyecto: Refleja la arquitectura de módulos y los estándares visuales/auditivos/de exportación documentados en esta habilidad y sus archivos references/. Si el usuario proporciona un nuevo guion, audio de locución o archivo SRT, mantén todo el motor, la constitución estética, la interfaz de estudio y la canalización de exportación MP4 idénticos mientras creas nuevos capítulos específicos del tema, escenas de píxeles, sprites y señales de sonido.

1. Constitución Estética (No Negociable)

Piensa en SNES / Chrono Trigger / Sea of Stars / Celeste combinado con gráficos en movimiento documentales de alta artesanía: cálido, rico, atmosférico y cristalino. Nunca minimalismo de alambre estéril, nunca desorden borroso de baja resolución, nunca sobras de neón chillón.

  1. Cuadrícula de Píxeles Virtual Puro de 16 Bits (384×216 Horizontal / 216×384 Vertical):

    • Dibuja todos los mundos de píxeles, fondos, cielos con tramado, sprites, accesorios e íconos en un lienzo virtual fuera de pantalla a 384×216 (16:9) o 216×384 (9:16).
    • ¿Por qué 384×216? Es una escala entera exacta de 5× a 1920×1080 (384 × 5 = 1920, 216 × 5 = 1080). Copia al lienzo de salida HD con ctx.imageSmoothingEnabled = false para que cada píxel se mantenga nítido sin parpadeos ni desenfoque de subpíxeles.
    • Bloquea las animaciones de píxeles ambientales/inactivas a un ritmo retro nítido (stepT = Math.floor(time * 8..10) / 10) mientras que los movimientos de cámara, las curvas de easing y las transiciones se ejecutan a 60fps sedosos (30fps en exportación).
  2. Paleta de 28 Colores Cálido-Cinemática Cohesiva de 16 Bits:

    • Construye cada escena a partir de una paleta compartida disciplinada (PAL) que abarca 6 familias emocionales: Azul Noche Profundo/Marina, Dorado Cálido Lámpara/Crema, Coral/ Ciruela Acogedor, Verde Azulado Frío/Pino, Hielo Ártico Invernal y Marrón Oliva Monocromo de Game Boy (reservado estrictamente para cortes duros dramáticos de giro de trama como "但其实").
    • Nunca uses gradientes planos sin textura. Usa Tramado de Bayer Ordenado de 4×4 (drawDitheredSky, drawDitheredGlow) para costuras de cielo, halos de lámpara, ráfagas de amanecer y disoluciones de píxeles.
    • Consulta references/visual-and-typography-spec.md para los tokens hexadecimales exactos, la matriz de Bayer y las primitivas de dibujo de sprites.
  3. La Ley Dorada de la Tipografía (Texto CJK Sin Manchas):

    • Nunca dibujes texto chino pequeño en el lienzo de baja resolución 384×216 y lo escales hacia arriba; los caracteres chinos densos (最/魔/幻/澜/疆) se convertirán en una mancha ilegible ("糊成一坨").
    • Títulos Cinéticos y Distintivos Dentro de la Escena (Superposición HD de Doble Capa): Renderiza los títulos directamente en el lienzo HD (1920×1080) usando sprites de glifos de píxeles binarios rasterizados a 38px (titulares grandes), 32px (subtitulares) o 24px (etiquetas HUD), con un contorno de tinta oscura de 1 píxel de 8 vecinos, una sombra escalonada y un relleno de bisel metálico de 3 bandas (resalte superior / tono medio / sombra inferior), escalado mediante vecino más cercano (imageSmoothingEnabled = false).
    • Subtítulos de Transmisión en Tercio Inferior: Mantén los subtítulos en una tipografía sans-serif original limpia y de alta legibilidad (Noto Sans SC / negrita del sistema dentro de una píldora oscura translúcida sutil con un borde ámbar fino en y = 0.905 * h). No pixeles la tira de subtítulos principal a menos que se solicite explícitamente.
    • Nunca dejes que los brillos con tramado oculten etiquetas críticas: Cualquier año clave, métrica o distintivo cumbre (2026, 1950 — FUTURE) debe estar dentro de una placa oscura de alto contraste nítida con un borde de píxel dorado/verde azulado dibujado después de los brillos de fondo.
  4. Cero Entradas con Aparición Repentina y Cero Cortes Bruscos Accidentales:

    • Cada límite de escena debe tener una transición intencional de la biblioteca de 9 transiciones (aperture-open, whip-blinds, iris-flash, razor-wipe, invert-strobe, camera-pullback, ember-curtain, gravity-shatter, horizon-burst) con interpolación de cámara suave fromCam → toCam y fundido cruzado de tipografía. Incluso una inversión dramática utiliza un barrido de ráster CRT deliberado (invert-strobe), nunca un salto brusco no motivado.
    • Cada elemento multigráfico dentro de una escena (4 tarjetas de modalidad, 4 módulos de características, 4 cajas, pasos monolíticos, banner de año final) DEBE animarse con una coreografía intencionada: apariciones elásticas escalonadas, rayos de energía que conectan el centro → nodo, pergaminos de RPG que se despliegan o marcas de odómetro/cuenta regresiva sincronizadas con las palabras habladas. Nunca solo cambies if (localTime > X) drawBox().
    • Cada final/desenlace merece una secuencia de cierre creativa característica (por ejemplo, floración del horizonte al amanecer + personajes mirando hacia adelante + pergamino desplegable + odómetro de año rodante 1950 → 2026 → FUTURE + barrido de arco estelar brillante + acorde mayor cálido y armónico).

2. Flujo de Trabajo de Producción Estándar

Sigue esta secuencia exacta al crear un nuevo video de píxeles de 16 bits desde cero (o al extender uno existente):

Paso 1: Ingestar Guion, Locución y Tiempos SRT

  • Analiza el audio de locución real del usuario y el archivo de subtítulos .srt (o genera un SRT con marcas de tiempo precisas alineado con la locución).
  • Normaliza los micro-vacíos (< 0.18s) entre señales adyacentes para que los subtítulos nunca parpadeen durante 2 fotogramas.
  • Establece CLIP_DURATION a partir de la hora de finalización exacta del audio/SRT.

Paso 2: Storyboard y Hoja de Ritmo (Plano de Ritmo)

  • Divide la película en 3–6 Actos Narrativos (cada uno con su propia temperatura de color y capítulo BGM) y escenas de 3–8 segundos (aproximadamente 1–3 señales de subtítulos por latido visual).
  • Para videos largos (>60s), construye de forma iterativa en capítulos de 30 segundos (retroPixelChapterTwo.ts, retroPixelChapterThree.ts, etc.) para que cada toma tenga arte de píxeles genuinamente hecho a mano en lugar de plantillas recicladas.
  • Asigna a cada escena en timeline.ts:
    • index, id, title, quote, start, end (estrictamente contiguos, sin vacíos ni superposiciones que cubran [0, CLIP_DURATION])
    • transitionIn + transitionLabel
    • visualBeat (descripción editorial concisa para el panel de storyboard)
    • accent color hexadecimal para la tira de la línea de tiempo.

Paso 3: Construir el Motor de Píxeles Principal y los Renderizadores de Capítulos Modulares

Refleja la separación limpia de responsabilidades de https://github.com/Lithium023/16bit-video-forNeon:

  • src/video/types.ts — SrtCue, SceneCut, TransitionType, RenderSettings, ExportResolution, ExportStatus.
  • src/video/srtParser.ts — Analizador SRT determinista, AUDIO_SRC, BGM_SRC, CLIP_DURATION, getActiveCue.
  • src/video/timeline.ts — SCENE_CUTS contiguos, curvas de easing (easeOutExpo, easeOutBack, easeOutCubic, easeInOutQuint, smoothstep), getStaggerProgress, getSceneAtTime, getActiveTransition, energía de locución de respaldo sintética.
  • src/video/pixelSprites.ts — PAL, BAYER_4X4, pxRect, pxOutline, pxCircle, pxRing, pxLine, drawDitheredSky, drawDitheredGlow, drawSprite, pxBitmapText, sprites de píxeles reutilizables y ayudantes de entorno (pxPineTree, pxCloud, pxSparkle, pxStarfield).
  • src/video/pixelTypography.ts — Rasterizador de glifos de píxeles binarios en caché (drawPixelString, drawPixelKineticTitle, drawPixelHudTag).
  • src/video/retroPixelRenderer.ts — Grupo de búfer virtual maestro (bufA, bufB, bufDither), calculadora de deriva de cámara, compositor de 9 transiciones, líneas de exploración CRT, traspaso de tipografía y despachador a archivos retroPixelChapter*.ts modulares.
  • src/video/sceneRenderers.ts — renderVideoFrame de nivel superior: escena de píxeles → viñeta sutil (0.14) → subtítulos limpios originales en tercio inferior → barra de progreso ámbar fina → fundido de cola de 0.25s.

Paso 4: Musicalizar la Película Completa (Sistema de Audio de 3 Pistas)

Lee references/choreography-and-audio-spec.md para obtener todos los detalles:

  1. Pista 1 — Locución: Ancla narrativa maestra (volume = 1.0, fundido de cola de 0.25s).
  2. Pista 2 — BGM de 16 Bits de Múltiples Actos: Obtén pistas genuinas de 16 bits con licencia abierta (CC0 / CC BY 3.0, por ejemplo, OpenGameArt / BoxCat Games / Kevin MacLeod / OSTs de chiptune) que coincidan con el estado de ánimo de cada acto, únelas en una sola pista BGM sin espacios con fundidos cruzados suaves que coincidan con las marcas de tiempo del acto, y aplica ducking automático de locución (duck = 1 - voiceEnergy * 0.22) a aproximadamente 0.58 * bgmVolume.
  3. Pista 3 — SFX de 16 Bits Sincronizados (retroSfxEngine.ts): Combina SFX de transición automáticos para cada corte de escena + SFX de ritmo musical colocados a mano (bip ascendentes pentatónicos para revelaciones de 4 cartas, tintineos de cristal, zumbidos de corte, tics de odómetro y un acorde mayor final cálido). Todos los SFX se sintetizan limpiamente a través de Web Audio (BaseAudioContext + scheduledTime opcional) para que la reproducción en vivo y la exportación MP4 fuera de línea suenen idénticas.

Paso 5: Vista Previa NLE de Estudio y Exportación MP4 1080p del Lado del Cliente

Lee references/mp4-export-and-qa-spec.md para obtener todos los detalles:

  • Shell de Estudio: Espacio de trabajo obsidiana oscura (#07080B), TopBar (título de marca, navegación de salto de capítulo, única acción principal 导出 1080p MP4 con progreso de etapa en vivo y cancelación instantánea), Escenario Canvas (cambio 16:9 / 9:16, reproducción/pausa/desplazamiento/paso/velocidad/silenciar/pantalla completa), línea de tiempo visual multipista (bloques de escena + bloques de subtítulos + cabezal de reproducción) y panel editorial derecho (分镜与转场 / 口播台词 / 画面调校 incluyendo cambio MP4 1080p vs 720p, deslizadores BGM/SFX, alternar subtítulos, botones de salto de resalte).
  • Exportación MP4 (videoExporter.ts): Usa mp4-muxer + WebCodecs del navegador (VideoEncoder H.264 + AudioEncoder AAC/Opus) con mezcla de audio PCM directo fuera de línea + sellado de SFX por caché, por defecto 1920×1080 @ 30fps, 14 Mbps (1080×1920 para vertical), con retroceso automático al MediaRecorder MP4 nativo de Safari.

Paso 6: Pruebas Unitarias y Verificación Visual del Navegador (Obligatorio)

  • Desacopla la lógica pura y prueba con node:test (npx tsx --test):
    1. Análisis de marcas de tiempo SRT y cobertura de señales (srtParser.test.ts)
    2. Cortes de escena contiguos y transiciones sin vacíos ni superposiciones (timeline.test.ts)
    3. Validación de tramado Bayer y cuadrícula de sprites rectangulares (pixelSprites.test.ts)
    4. Cobertura de señales SFX cronológicas y ventana de activación solo hacia adelante (retroSfxEngine.test.ts)
    5. Configuración de resolución de exportación, prioridad MIME MP4 y línea de tiempo de energía de locución (videoExporter.test.ts)
  • Soporta el parámetro de consulta URL ?t=<seconds> en App.tsx para que las comprobaciones automatizadas del navegador sin cabeza puedan saltar directamente a cualquier escena, punto medio de transición, latido de entrada animado y fotograma final para inspección visual.
  • Verifica que la exportación MP4 en vivo alcance 渲染 MP4, cancele limpiamente de vuelta a inactivo sin devoluciones de llamada obsoletas y emita cero errores de consola del navegador.

3. Reglas Duras y Errores que Nunca Repetir

ErrorCausa RaízSolución Obligatoria
Los títulos chinos se ven embarrados/apelmazados ("糊成一坨")Renderizar CJK en el lienzo de baja resolución 384×216 y luego escalarloRenderizar títulos CJK en el lienzo HD mediante sprites de glifos binarios de 38px/32px (thresh = 142..148 para CJK, 88 para ASCII) con contorno de tinta de 1px + bisel de 3 bandas; mantener los subtítulos en tercio inferior en sans-serif original limpio
Cortes bruscos entre escenas tardíasFalta transitionIn o traspaso visual no coincidenteCada corte en SCENE_CUTS debe definir un transitionIn intencionado; emparejar transiciones temáticas (por ejemplo, flor floreciente que se disuelve en cristales de hielo cayendo → inmersión gravity-shatter en invierno)
Los elementos aparecen abruptamenteDibujar tarjetas/cajas de UI con booleanos if (localTime > t) sin formatoImpulsar cada elemento con clamp01((localTime - delay) / dur) + easeOutBack / easeOutExpo, conectores de haz, despliegues de pergamino o contadores rodantes
Etiqueta de clímax oculta o medio escritaBrillo dibujado encima de la etiqueta, o progreso derivado de un contador de segmento limitadoDibujar etiquetas dentro de placas oscuras enmarcadas después de los brillos; vincular el progreso de revelación directamente a localTime en lugar de un parámetro de curva limitado
La exportación MP4 fuera de línea se estanca al 4%Conectar más de 90 SFX (~280 BiquadFilterNodes) a un solo OfflineAudioContext de 314sDecodificar locución + BGM una vez, mezclar directamente en PCM Float32Array estéreo, renderizar cada SFX corto único en un OfflineAudioContext pequeño de 0.55–1.55s (en caché) y sellar en PCM
La codificación de audio MP4 fuera de línea toma más de 12sAlimentar fragmentos AudioData diminutos de 4096 muestras con sondeo de drenaje sueltoAgrupar AudioData en fragmentos de 1 segundo (48000 muestras) (~315 fragmentos para 5m) y ajustar el retroceso de drenaje a 20ms
Hacer clic en Cancelar durante el renderizado MP4 deja el botón atascadowaitForEncoderDrain se resuelve después de cancel() y emite un último onProgressEnvolver onProgress/onComplete/onError en protecciones !cancelled y verificar if (isCancelled()) return inmediatamente después de cada await

4. Archivos de Referencia en Esta Habilidad

Carga estas referencias según sea necesario durante la ejecución:

  • references/visual-and-typography-spec.md — Paleta de colores PAL exacta, lienzo 384×216 y matemáticas de escala entera, tramado Bayer, rasterizador de tipografía de píxeles y 9 recetas de transición.
  • references/choreography-and-audio-spec.md — Patrones de entrada animados, fundido cruzado de BGM de 5 actos + matemáticas de ducking y 15 recetas de SFX procedurales de 16 bits.
  • references/mp4-export-and-qa-spec.md — Canalización de exportación MP4 del lado del cliente de 4 niveles, mezclador PCM rápido fuera de línea, especificación de UI de estudio NLE y lista de verificación de QA unitaria y de navegador.

Skills relacionados