¿Qué hace Comparación de Edición de Video?
Renderiza el modo de comparación V1 única: original-vs-final-source-time.
El panel izquierdo reproduce el original continuamente. El panel derecho proyecta los píxeles reales de la entrega final sobre el reloj de la fuente original. Los rangos eliminados aparecen en negro, los rangos conservados finales se estiran a su duración original y el audio se copia del original.
Dependencias
Requiere ffmpeg/ffprobe en el PATH y Python con Pillow. Verifícalos antes de procesar el medio.
Entradas
work/timeline.json: mapeo canónico cronológico de fuente a programainput/original-video.mp4: fuente originalfinal/final-video.mp4: entrega real después de todas las ediciones seleccionadas
No compares contra un plan de corte o un render intermedio. Se requieren los píxeles finales para que la revisión incluya corrección de color y tarjetas.
Renderizado
python scripts/make_compare.py TIMELINE.json SOURCE.mp4 FINAL.mp4 OUT.mp4 [--filter-only]
Ejemplo de proyecto:
python skills/video-edit-compare/scripts/make_compare.py `
work/timeline.json `
input/original-video.mp4 `
final/final-video.mp4 `
review/04-edit-compare/original-vs-final-source-time.mp4
El script siempre escribe el duradero work/edit-compare/compare-plan.json. Escribe imágenes etiquetadas PIL y el filtro gráfico generado bajo el directorio desechable work/cache/. --filter-only crea el plan y los archivos de caché inspeccionables sin renderizar el video.
Reglas de Mapeo
- Mantén los clips fuente cronológicos, no superpuestos y de una sola fuente.
- Recorta el
program_rangede cada clip del video final. - Estíralo por la velocidad del clip para recuperar su duración
source_range. - Inserta negro para cada espacio en el tiempo de la fuente.
- Mapea el audio original sin reajustar su velocidad.
- Deriva el fotograma de inicio y fin de cada parte a partir de sus límites absolutos de tiempo de fuente, luego recorta a ese recuento de fotogramas y reconstruye PTS a la velocidad de fotogramas racional de la línea de tiempo. Nunca redondees la duración de cada parte de forma independiente; el redondeo acumulativo de concatenación causa desviación en el tiempo de la fuente.
Las líneas de tiempo reordenadas, duplicadas, superpuestas, de velocidad no lineal o de múltiples fuentes no son compatibles en V1 y deben fallar en la validación.
Verificación
Después de renderizar, el script verifica automáticamente la salida completa:
- la duración es igual a
source_duration_sdentro de un fotograma; - el ancho de salida es el doble del ancho de la fuente;
- cada muestra de rango eliminado es negra en el lado derecho;
- las muestras de rango conservado coinciden con los fotogramas del programa final correspondientes;
- el audio original permanece continuo y en el reloj de la fuente.
Al éxito, escribe review/04-edit-compare/comparison-summary.md con un resultado de verificación aprobatorio. Cuando existe work/project.json, también añade o actualiza el nodo de revisión original-vs-final-source-time, registra las revisiones exactas de la operación activa en based_on, y actualiza START-HERE.md. No crees un manifiesto de verificaciones separado.
Esta comparación es un entregable de revisión, no una vista previa predeterminada. Genérala después de que exista el render final.