Papercut QA
Compara fotogramas por estilo, no por contenido, contra el Style DNA y el storyboard. Ejecútalo por escena mientras construyes y una vez sobre el carrete completo antes del render final.
Preflight
- Instalación: Estándar o Completa. Los fotogramas necesitan un proyecto andamiado con Remotion, y las hojas de contacto necesitan Python con numpy y Pillow (
$MOTION_PY). Piezas faltantes:./install.sh --doctor, luegomotion-setup. - Un proyecto
kyframno necesita Remotion: invoca la habilidadkyframantes de inspeccionar o arreglar la salida de escenas Kyfram.qa.shextrae sus fotogramas de los segmentos de escena en caché (core/tools/kyfram_qa.py), así que renderiza una vez concore/tools/render.shantes del QA. Todo lo siguiente aplica sin cambios. - Biblioteca:
$MOTION_LIB, o la líneaMOTION_LIB=en~/.config/motion-explainer/config.env, o preguntar una vez. - Lee primero: Style DNA en
$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.mdsección 2, y la hoja de fondostyle/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Cada imagen cuesta aproximadamente 0.7-1.5k tokens, así que abre solo lo que necesite el paso. - Para densidad,
$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md("Estadísticas de ritmo" al final): las escenas promedian 2.8 s, 2-4 eventos visuales discretos por escena, uno cada 0.4-0.8 s en una palabra acentuada, una nueva página de leyenda aproximadamente cada 0.6 s. Copia la densidad, no el contenido.
1. Renderizar fotogramas
Desde la carpeta video/ del proyecto:
$MOTION_LIB/core/tools/qa.sh NOMBRE DESDE-HASTA CADA [ESCALA=0.3] [COLS=9]
- Usa 4-6 marcas de tiempo por revisión. Para una escena, CADA es aproximadamente su longitud en fotogramas dividido entre 4. Omite
DESDE-HASTApara el carrete completo y aumenta CADA. - La salida es
out/qa/NOMBRE_0.jpg(y_1,_2para rangos más largos), como máximo 45 fotogramas por hoja. Lee la hoja; mantén las hojas pequeñas. - Un comando de QA por escena, y nunca dos renders a la vez. Mantén las correcciones en dos rondas por escena.
- Revisa contra el storyboard: el fotograma 0 de la escena, sus eventos clave en sus palabras, nada recortado, nada cubriendo el banner o las bandas de leyenda.
2. Lista de verificación
- Cada objeto se lee como papel: grano, borde áspero, sombra paralela, sombreado de piezas apiladas, sin contornos ni degradados.
- La cámara del mundo se mueve suavemente. Solo el banner y las etiquetas hierven (escalonado, sutil).
- El banner está fijo en posición y pegado, 3-7 palabras, un hecho cada uno, nunca repite la VO. Los banners solos se leen como una hoja de datos.
- Cada set ilustra una palabra concreta en su línea de VO, los números son accesorios físicos, y hay un set de referencia antes del CTA.
- Cada número y etiqueta de UI remite a la lista de hechos. El guion tiene al menos una limitación honesta y una pila de características de exactamente tres.
- Leyendas: una etiqueta por palabra, inclinada, apareciendo al inicio, páginas de 1-3, en la banda 68-80%, nunca sobre una cara.
- Saturación solo en personajes, leyendas y señales.
- Un evento visual en cada palabra acentuada, con movimiento ambiente siempre activo.
- Cortes en cambios de banner (sets 1.5-3 s en tours y noticias, hasta 5 s en un compás metafórico), 20% inferior despejado.
- El bloque HOOK (SAY / WRITE / SHOW / ALIGN) está en pantalla exactamente como está escrito: el fotograma 0 muestra el momento SHOW en mitad de la acción con el título WRITE sobre él, y la primera línea de VO es SAY.
- Cada escena tiene un movimiento de cámara, como máximo un giro de página o rasgadura, un tirón de cinta o látigo hacia el CTA, y cada transición tiene su SFX.
- Pase de humor visible en pantalla: un formato en todo el video, un accesorio de disfraz por idea, un compás de lucha, el accesorio del fotograma 0 regresa cambiado en el set del CTA, y cada gag se lee en menos de 1 s y nunca cubre el banner, las leyendas ni el número clave.
- El vocabulario en la VO y los banners coincide con el nivel de audiencia en
SERIES.md. - La voz en off, las leyendas y los eventos están sincronizados (revisa en el Studio cada corte).
Para un elemento fallido, arregla el archivo de la escena (o el kit en la biblioteca, nunca src/lib/ en el proyecto) y vuelve a ejecutar la escena. Reconstruye una escena con motion-build.
3. Entregar
Abre la vista previa del Studio, lista las escenas con tiempos y di qué es provisional: voz, música, SFX, activos. Si la voz es provisional, di cómo volver a ponerle voz (motion-voice). Después de publicar, los números van a motion-strategy para la autopsia.
Pase de principios
Revisa una escena a 5 fps y verifica contra $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: anticipación antes de cada movimiento grande (2), todo suavizado (6), algo rezagado después de impactos (5), un accesorio focal (3), un compás exagerado (10), sombreado apilado y una sombra consistente (11).
Transferencia
Las correcciones vuelven a motion-build (escena o sonido) o motion-voice (sincronización). Un pase limpio termina el carrete: renderiza con $MOTION_LIB/core/tools/render.sh cuando el usuario lo pida.