비디오 편집 비교은(는) 무엇을 하나요?
단일 V1 비교 모드(원본 대 최종 소스 시간)를 렌더링합니다.
왼쪽 패널은 원본을 연속 재생합니다. 오른쪽 패널은 실제 최종 전달 픽셀을 원본 소스 시간축에 투영합니다. 제거된 범위는 검은색으로 표시되고, 유지된 최종 범위는 해당 소스 지속 시간에 맞게 늘어납니다. 오디오는 원본에서 복사됩니다.
의존성
ffmpeg/ffprobe가 PATH에 있어야 하며, Python에 Pillow가 필요합니다. 미디어를 처리하기 전에 이를 확인하세요.
입력
work/timeline.json: 표준 시간순 소스-프로그램 매핑input/original-video.mp4: 원본 소스final/final-video.mp4: 모든 선택된 편집이 적용된 실제 전달본
컷 계획이나 중간 렌더링과는 비교하지 마십시오. 그레이딩과 카드가 포함되도록 최종 픽셀이 필요합니다.
렌더링
python scripts/make_compare.py TIMELINE.json SOURCE.mp4 FINAL.mp4 OUT.mp4 [--filter-only]
프로젝트 예시:
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
스크립트는 항상 지속적인 work/edit-compare/compare-plan.json을 작성합니다. 임시 work/cache/ 아래에 PIL 레이블 이미지와 생성된 필터 그래프를 기록합니다. --filter-only는 비디오를 렌더링하지 않고 계획과 검사 가능한 캐시 파일을 생성합니다.
매핑 규칙
- 소스 클립을 시간순, 비중첩, 단일 소스로 유지합니다.
- 각 클립의
program_range를 최종 비디오에서 잘라냅니다. - 클립 속도에 따라 늘려서
source_range지속 시간을 복구합니다. - 모든 소스 시간 간격에 검은색을 삽입합니다.
- 원본 오디오를 시간 재조정 없이 매핑합니다.
- 각 부분의 시작 및 끝 프레임을 절대 소스 시간 경계에서 파생한 다음, 해당 프레임 수로 자르고 타임라인의 합리적인 FPS로 PTS를 재구축합니다. 각 부분 지속 시간을 독립적으로 반올림하지 마십시오. 누적 연결 반올림은 소스 시간 드리프트를 유발합니다.
재정렬, 중복, 중첩, 비선형 속도 또는 다중 소스 타임라인은 V1에서 지원되지 않으며 유효성 검사에 실패해야 합니다.
검증
렌더링 후 스크립트는 자동으로 전체 출력을 확인합니다:
- 지속 시간이 한 프레임 이내에서
source_duration_s와 일치하는지; - 출력 너비가 소스 너비의 두 배인지;
- 모든 제거된 범위 샘플이 오른쪽에서 검은색인지;
- 유지된 범위 샘플이 해당 최종 프로그램 프레임과 일치하는지;
- 원본 오디오가 연속적이고 소스 클록에 유지되는지.
성공 시 review/04-edit-compare/comparison-summary.md에 통과 검증 결과를 기록합니다. work/project.json이 존재하면 original-vs-final-source-time 검토 노드를 추가하거나 새로 고치고, based_on에 정확한 활성 작업 개정을 기록하며 START-HERE.md를 새로 고칩니다. 별도의 검사 매니페스트를 생성하지 마십시오.
이 비교는 검토 전달물이지 기본 미리보기가 아닙니다. 최종 렌더링이 존재한 후에 생성하십시오.