Video Filmstrip
Genera un archivo de fotogramas extraídos, un mosaico de 4 columnas en resolución 4K, una imagen de código de barras de color promedio y un CSV RGB promedio a partir de cualquier archivo de vídeo usando FFmpeg y la biblioteca estándar de Python (sin necesidad de paquetes de terceros).
Prerrequisitos
Confirma que ffmpeg, ffprobe y python estén disponibles en PATH antes de ejecutar:
ffmpeg -version; ffprobe -version; python --version
Pasos
- Resuelve la ruta del vídeo de entrada y pregunta al usuario si desea que las fichas del mosaico lleven números de fotograma (Frame Badges) o sin numerar (a menos que ya lo hayan especificado en su solicitud), además de cualquier anulación opcional (frecuencia de fotogramas, directorio de salida, prefijo, recorte de inicio/duración o dimensiones personalizadas).
- Ejecuta generate_filmstrip.py con la ruta del vídeo de entrada:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"
Pasa banderas opcionales solo al anular los valores predeterminados:
--no-frame-numbers: Omite los números de fotograma (Frame Badges) de 16px en la esquina inferior izquierda de las hojas del mosaico (pasa cuando el usuario elige fichas sin numerar)--output-dir <dir>: Directorio de destino (predeterminado:<prefijo>_filmstripjunto al vídeo de entrada)--prefix <name>: Prefijo del nombre de archivo de salida (predeterminado: nombre base del vídeo de entrada)--fps <rate>: Fotogramas por segundo a extraer (predeterminado:1.0)--cols <count>: Cantidad de columnas en el mosaico (predeterminado:4)--grid-width <px>: Ancho total del mosaico en píxeles (predeterminado:3840)--barcode-height <px>: Altura del código de barras de color promedio en píxeles (predeterminado:715)--barcode-stripe-width <px>: Ancho del código de barras por fotograma en píxeles (predeterminado:1)--quality <2-31>: Calidad MJPEG de FFmpeg, cuanto menor es el valor, mejor (predeterminado:2)--start <sec>: Desplazamiento de inicio en segundos (-ss)--duration <sec>: Duración del clip en segundos (-t)
- Verifica los artefactos generados dentro de la carpeta de salida:
frames/<prefijo>-001.jpeg... (Fotogramas extraídos a resolución original del vídeo, sin marcas)<prefijo>_grid.jpego numerados<prefijo>_grid-001.jpeg... (Hojas del mosaico de 4 columnas, con números de fotograma (Frame Badges) de 16px en la esquina inferior izquierda a menos que se haya pasado--no-frame-numbers, divididas automáticamente cuando se supera el límite de65500pxde altura JPEG de FFmpeg)<prefijo>_averagesRGB.jpeg(Código de barras de color promedio)<prefijo>_averagesRGB.csv(Filasframe,timestamp_sec,r,g,bque coinciden con la cantidad de fotogramas extraídos)
- Informa el directorio de salida y enlaces clicables para las hojas del mosaico generadas, el código de barras, el CSV y la carpeta de fotogramas.