비디오 필름스트립
FFmpeg와 Python 표준 라이브러리만 사용하여 (타사 패키지 없이) 모든 비디오 파일에서 추출된 프레임 아카이브, 4열 4K 필름스트립 그리드, 평균 색상 바코드 이미지 및 평균 RGB CSV를 생성합니다.
전제 조건
실행 전에 ffmpeg, ffprobe, python이 PATH에 있는지 확인하세요:
ffmpeg -version; ffprobe -version; python --version
절차
- 입력 비디오 경로를 확인하고 사용자에게 필름스트립 그리드 타일에 프레임 배지를 표시할지 또는 표시하지 않을지 묻습니다 (이미 요청에 명시되지 않은 경우). 또한 선택적 재정의 항목(프레임 속도, 출력 디렉터리, 접두사, 시작/지속 시간 자르기 또는 사용자 지정 크기)에 대해서도 묻습니다.
- 다음 명령으로 입력 비디오 경로를 사용하여 generate_filmstrip.py를 실행합니다:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"
기본값을 재정의할 때만 선택적 플래그를 전달하세요:
--no-frame-numbers: 그리드 시트에서 왼쪽 하단 16px 프레임 배지를 생략합니다 (사용자가 번호 없는 타일을 선택한 경우 전달)--output-dir <dir>: 대상 디렉터리 (기본값: 입력 비디오 옆<prefix>_filmstrip)--prefix <name>: 출력 파일명 접두사 (기본값: 입력 비디오 파일명)--fps <rate>: 초당 추출할 프레임 수 (기본값:1.0)--cols <count>: 그리드 열 개수 (기본값:4)--grid-width <px>: 그리드 전체 너비(픽셀) (기본값:3840)--barcode-height <px>: 평균 색상 바코드 높이(픽셀) (기본값:715)--barcode-stripe-width <px>: 프레임당 바코드 너비(픽셀) (기본값:1)--quality <2-31>: FFmpeg MJPEG 품질(낮을수록 좋음) (기본값:2)--start <sec>: 시작 오프셋(초) (-ss)--duration <sec>: 클립 지속 시간(초) (-t)
- 출력 폴더 내에서 생성된 아티팩트를 확인합니다:
frames/<prefix>-001.jpeg... (원본 비디오 해상도로 유지된 추출 프레임, 배지 없음)<prefix>_grid.jpeg또는 번호가 매겨진<prefix>_grid-001.jpeg... (4열 필름스트립 그리드 시트,--no-frame-numbers가 전달되지 않은 경우 왼쪽 하단 16px 프레임 배지 포함, FFmpeg의65500pxJPEG 높이 제한에서 자동 분할)<prefix>_averagesRGB.jpeg(평균 색상 바코드)<prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,b행, 추출된 프레임 수와 일치)
- 출력 디렉터리와 생성된 그리드 시트, 바코드, CSV, 프레임 폴더의 클릭 가능한 링크를 보고합니다.