shootpack은(는) 무엇을 하나요?
파이프라인은 ~/shootpack (git 저장소)에 있습니다. 진입점: shootpack <폴더> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]. 새 촬영은 --plan으로 시작합니다(목록 작성, 큐레이션 및 편집 계획, 내보내기 없음).
장치
모든 파일의 카메라는 감지되고(EXIF 제조사/모델, 비디오 인코더/모델 태그, 사이드카) devices/<id>.json의 프로필로 읽힙니다. 알 수 없는 카메라는 devices/generic.json을 사용합니다. 첫 번째 로그 줄은 발견된 것을 나열합니다(devices: DJI Mavic 4 Pro (200 photos, 8 clips), Sony A1 II (...)) — 확인하세요.
- DJI Mavic 4 Pro (
dji_mavic4pro): XMP 드론 지오메트리 → 태양 감지, 프레임 인식 큐레이션, 천장 한도 플래그, 고도 인식 비디오; SRT 원격 측정, LRF 프록시. - Sony A1 II (
sony_a1ii, EXIF Model ILCE-1M2): 노출 편차 + 드라이브 모드별로 그룹화된 ARW 브라켓(+ JPG/HEIF 쌍, 카드 간에도 있음); 클립 XML 사이드카(C0001M01.XML)는 시작 시간, 프레임 속도, 감마 및 색역을 제공합니다. SUB/ 프록시. 카메라 지오메트리 없음: 자동 태양 프로필 없음(cull.json에서"sun"수동 설정), 큐레이션은 이미지 내용(거의 동일한 프레임 = 중복)으로 진행되며 렌즈별로 샷 이름을 지정합니다(24mm,70mm-portrait). - Fujifilm X-E4 (
fujifilm_xe4, EXIF Model X-E4 on RAF, JPG and MP4): 단일 프레임, RAF + JPG 쌍. JPG는 레시피 렌더링입니다(Classic Chrome 등, 레시피는 RAF의 EXIF에 있음,photo.recipe_tags참조). LightCraft 자체의 RAF 디벨롭은 어둡고 평탄하며 이를 무시하므로, 내보내기 전에 카메라 JPEG에 맞춰 디벨롭 프로필을 피팅합니다. 같은 DCIM 폴더의 클립, 사이드카 없음; 필름 시뮬레이션 클립은 Rec.709(룩만 있고 기술 LUT 없음), F-Log는 신호에서 감지됩니다. 오프로드:shootpack offload <카드> --device XE4(드롭 폴더Drops/XE4/). 디벨롭: 촬영 자체의 쌍에서recipe_fit.py fit LUT.npz RAF=JPG,...실행(RAF와 JPG를 촬영 시간별로 짝짓기: 번호가 하나 다를 수 있음), 그런 다음fuji_develop.py batch LUT.npz cull.json <DCIM dir> Deliverables/Photos(cull.json 키는 JPEG 번호 -> {raf, jpg, name}). 카메라 시계는 홈 타임존일 수 있음(웨딩 촬영 하나: -06:00, 로컬 = +8 h). 라이브 사운드가 있는 이벤트 클립:clip_edit.py edits/<spec>.json Video/<name>_4K.mp4(음악 없음, L-컷 오디오; motion.py가 도움이 된다고 증명하지 않는 한 안정화는 꺼짐). agent-docs/photos/fuji-recipe.md 참조. - DJI Osmo 360 II (
dji_osmo360ii, MP4 Encoder 태그Osmo 360 II로.OSV발견): 두 개의 어안 스트림, 따라서 클립은 따로 설정됩니다(로그에 "N 360 clip(s) ... render them with osmo360.py"라고 표시됨) 그리고 부동산 편집에 도달하지 않습니다.osmo360.py CLIP.OSV Deliverables/Video는 그레이딩된 평면 리프레임(키프레임 이동)과 그레이딩된 등장방형 360을 작성합니다. 스티치는 보정되지 않았으며 수평이 맞춰지지 않았습니다. 렌즈는 오버랩에서 게인이 일치됩니다. 색상 모드는 이미지 원 내부의 신호에서 읽힙니다(일반 색상 vs D-Log M, 둘 다의 실제 클립에서 확인됨). D-Log M은 DJI의 Osmo 360 D-Log M LUT가luts/official/에 있을 때까지 카메라 자체 프록시에 맞춰진 임시 LUT(luts/interim_dlogm_to_709_osmo360ii.cube)를 얻습니다.--spec edits/osmo_car_v1.json은 긴 클립의 키프레임 발췌를 렌더링합니다(자동차 테스트에서 운전자의 타이트한, 노출이 올려진 크롭). 평면 크롭은 가로로18.6 x h_fov실제 픽셀을 가집니다: 타이트한 크롭의 4K는 업스케일됩니다(agent-docs/video/osmo360.md). 카메라에는 내부 저장소와 SD 카드(두 볼륨)가 있습니다. 오프로드:shootpack offload <카드>가 자체적으로 찾습니다(Drops/Osmo360/). - 듀얼 슬롯 녹화: 두 카드의 동일한 파일이 감지되고(이름 + 촬영 시간 + 크기, 그 다음 해시) 슬롯 1 사본이 사용됩니다. 로그는 몇 개가 건너뛰어졌는지 알려줍니다.
- GPS 없음(카메라 전용 촬영): 세션은 로컬 시계 시간으로 이름이 지정됩니다(아침 < 10:00, 정오 < 15:00, 오후 < 17:30, 저녁), 그레이딩은 이름을 따릅니다(정오/오후: 정오 룩, 그 외: 골든).
--latlon을 전달하면 태양 대신 이름을 지정합니다. Sony 샷에는 지오메트리가 없으므로 태양 샷은 자동 태양 프로필을 얻지 못합니다: cull.json에서 수동으로"sun": {"G18": "A"}설정(자동 디벨롭은 어두운 태양-유리 프레임을 평탄하게 들어올림). - 새 카메라: 가장 가까운 프로필을 복사하고,
detect.models, 센서/FOV, 브라켓 규칙 및 로그 곡선을 변경합니다.
단계
- 실행. 백그라운드에서
shootpack "<폴더>" --ceiling <사용자의 LAANC/항공 공간 천장, 기본값 120>(사진 ≈ 브라켓당 25초, 비디오 ≈ 4분). 모든 것을<폴더>/Deliverables/_shootpack/에 캐시합니다. - 큐레이션을 시각적으로 검토 —
Deliverables/_shootpack/<세션>/all_stations.jpg와 각Deliverables/Photos/<세션>/Picks_contact_sheet.jpg를 엽니다. 자동 큐레이션은 내용을 볼 수 없으므로 다음을 확인하고 수정합니다:- 프레임 가장자리에서 잘린 집 → 거부로 이동
- 프레임 내 사람(종종 형광 조끼를 입은 조종사) → 대안, "PERSON-IN-FRAME" 메모
- 거의 중복 / 지루한 반복 → 대안; 대안에 강한 샷 남음 → 선택
- 천장 위의 샷은 이미 대안에 플래그 지정됨 — 언급하고 숨기지 마십시오
<세션>/cull.json편집(키 G01…; 값은 짧은 이름), 영향을 받은 출력 삭제,--only photos로 재실행. 태양 샷은 자동으로 감지됩니다(태양 기하학에 의해 프레임 내부의 태양 + 가장 어두운 브라켓에서도 클리핑됨) 그리고 태양 프로필로 디벨롭됩니다:A= 태양이 피사체(자동 대비 -1.9스톱),C= 집이 피사체(-0.6스톱, 집이 밝게 유지됨). cull.json에서 샷별로 재정의:"sun": {"G21": "A", "G07": "off"}. 별 폭발: 브라켓 프레임이 눈에 보이는 태양 원반 주위에 선명한 회절 광선을 보여주면(각 프레임에서 태양 확인),"starburst": {"G21": "0209"}(프레임 번호)를 추가하고--only photos --redo로 재실행; 구름 뒤에 있는 태양에는 절대 하지 마십시오(그 광선은 햇살이며 이미 병합에서 살아남습니다). 분홍색 클리핑된 구름이 있는지 태양 샷을 확인하십시오.
- 비디오 검토 —
Deliverables/Video/*_storyboard.jpg열기(3초당 한 프레임). 이륙/착륙, 조종사, 너무 어둡거나 반복적인 샷을Deliverables/_shootpack/edit.json(클립, 시작, 길이, 속도, 스톱 단위 노출)을 편집하고--only video로 재실행하여 교체하십시오. 클립의 프록시(DJI.LRF, SonySUB/) 및 DJI.SRT(rel_alt, position)를 사용하여 더 나은 순간을 찾으십시오. 카메라 클립에는 원격 측정이 없으므로 이륙/착륙 트리밍 및 고도 대역이 적용되지 않습니다. 24p/30p 클립은 절대 느려지지 않습니다(50p+만 슬로우 모션을 제공할 수 있음). - 그레이딩 —
~/shootpack/luts/official/에 DJI 공식 LUT가 있으면(Maginot: "DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"), 모든 샷은 DJI의 LUT를 기술 베이스로 사용하고 그 위에 창의적인 룩을 추가합니다:luts/looks/dlog_golden_*(골든 아워: 더 따뜻하고, 더 차분한 파란색, 열린 그림자) 또는dlog_midday_*(더 많은 대비/펀치).luts/looks/make_looks.sh가 이를 재구축합니다(build_look.py:_input.cube= 노출이 로그에 적용된 공식 LUT, FilmCraft의 Input 슬롯용;_look.cube= Rec.709→Rec.709, Creative 슬롯용;_composed.cube= 둘 다, ffmpeg용). 노출 리프트를 공식 LUT 전에 배치하십시오(--pre-exposure, 로그 스톱): DJI의 LUT는 자체 JPEG보다 어둡고, LUT 이후에 리프트하면 하늘이 클리핑됩니다(Maginot v5는 그 때문에 30-50% 너무 어둡게 나왔습니다). 공식 LUT가 없으면 곡선 기반warm_print_v6/warm_print_midday_v2가 사용됩니다. 항상 새 공식 LUT가 푸티지의 프로필과 일치하는지 확인하십시오(아래 참조). - 음악(트레일러) — 사용자의 OAuth 커넥터를 통한 Epidemic Sound(API 키 절대 안 됨). 몽타주 컷(75 BPM = 3.2초 마디)과 일치하는 마디 길이의 악기 "빌드" 트랙을 검색하고 각 파형의 에너지 곡선을 읽으십시오: 조용한 인트로, 긴 빌드, 하나의 큰 드롭이 필요합니다.
DownloadRecording(WAV, FULL)를Deliverables/Music/에 다운로드한 다음,music.analyze(wav, given_bpm): 드롭이 다운비트에 맞는지 확인하십시오(그리드의 온/오프 비트 위상은 킥/베이스에서 오고, 마디 위상은 가장 큰 저음역 점프에서 옵니다).bar_chroma유사도가 0.9 이상인 점프 X→Y를 선택하십시오(같은 코드, 들을 수 있는 접합 없음). 마디 그리드에서 전체 프레임 단위로 그림 시간을 맞추십시오(템플릿:edits/make_trailer_v7.py): 다운비트에서 컷, 드롭에서 피날레, 릴리스에서 엔드 카드.trailer.py는spec["music"]을 모든 출력에 먹싱합니다.--music-only는 재렌더링 없이 재편집 및 재먹싱합니다.--size 1920x1080는 5분 타이밍 확인을 만듭니다(6K 렌더링 전에 비트에 대한 컷 측정). 클라이언트 취향(참조 촬영, v8-v11): 레터박스 없는 전체 16:9("letterbox": null), 텍스트 카드 없음, 디졸브 또는 딥 투 블랙 없음, 비트에 하드 컷, 마지막 샷으로 끝(음악 테일 아래 1초"end_fade"는 괜찮음)."stabilize"로 부드러운 샷: 숫자 = 가우시안 시그마(초 단위, 1-2),{"poly": 2}= 균일한 움직임. 레터박스가 없으면 모든 수직 보정이 줌을 희생하므로 시그마를 보통으로 유지하십시오(참조 촬영 피날레: 1.25 = 6.6% 줌, 2.0은 12%가 됨);"reframe_y"는 레터박스가 있을 때만 도움이 됩니다. 움직임 끝에 집을 더 많이 유지하려면 샷을 느리게 하여 움직임에서 더 일찍 끝나게 하십시오. 렌더링에서 흔들림을 측정하십시오(stabilize.trackon the preview) 전후; 드론 자체의 정지-역전은 부드럽게만 할 수 있고(더 무거운 시그마 + 0.85x), 제거할 수는 없습니다. Epidemic의EditRecording은requiredRegionsAtOffsets가 설정될 때마다 편집을 반환하지 않았으며, 제약 없는 60초 편집은 드롭을 완전히 떨어뜨렸습니다(2026년 10월), 그래서 우리가 직접 트랙을 컷합니다. 클라이언트 작업에는 상업용 Epidemic 플랜이 필요합니다. 물어보십시오. - 전달 — 선택 연락처 시트, 720p 프리뷰(<30MB) 및 스토리보드를 SendUserFile로 보내십시오.
Deliverables/SUMMARY.md에서 요약하십시오(개수, 플래그, 임시 사항). 재사용 가능한 코드 변경 사항을 저장소에 커밋하십시오.
진행 상황 표시
모든 변경 사항에 대해 전후를 제공하십시오: review_site/<shoot>/progress/*/manifest.json 업데이트(grade / photos / detail / cut / music) 및 progress_page.py로 재구축(progress_music.py는 음악 맞춤 차트를 그림); SendUserFile로 모바일 친화적인 시트 또는 스택 비교 비디오를 보내십시오.
중요한 사실
- 항상 로우 파일(DJI DNG, Sony ARW)에서 디벨롭하십시오. JPG는 메타데이터/참조용일 뿐입니다. ARW 전용 샷은
_shootpack/previews/에 로우에서 추출한 참조 JPEG를 얻습니다. LightCraft는 Sony 자체 JPEG(음소거된 중립 폴백이 아님)에 맞춰진 룩으로 ARW를 렌더링하지만 Sony 렌즈 프로필은 없습니다: 왜곡/비네팅은 촬영된 그대로 유지됩니다. ARW의 HDR 병합은 색상 매트릭스나 화이트 밸런스가 없는 DNG를 씁니다(녹색으로 디벨롭됨): 파이프라인은 카메라의 보정을 씁니다(rawpy를 통한 LibRaw의 Adobe 파생 테이블의 ColorMatrix1, 샷의 AsShotNeutral) 그리고 그 파일을 디벨롭하므로 Sony 브라켓의 HDR_DNG/ 파일은 모든 로우 편집기에서 올바른 색상으로 열립니다. - LightCraft는 소스 옆에
*-HDR.dng를 씁니다. 파이프라인은 이를Deliverables/HDR_DNG/로 이동합니다. 원본을 절대 수정하지 마십시오. - DJI MP4는 회전되어 저장됩니다(
rotation=-90). ffprobe는 세로 크기를 보고하지만 가로로 재생됩니다. - Sony 카드: 슬롯당 전체
DCIM/+PRIVATE/트리를 복사하십시오(Finder는 MTP 모드에서 카메라를 마운트할 수 없음 — 카드 리더기 또는 USB 대용량 저장소 사용);M01.XML사이드카가 없으면 클립의 감마/색역이 신호만으로 폴백됩니다. - SRT
DiffTime: 16ms= 59.94p → 부드러운 궤도를 위해 하프 스피드 컨폼을 29.97로. - 로그 곡선은 신호에서 클립별로 결정됩니다: ~10프레임의 휘도 코드 값 분포(p95 = 흰색이 있는 위치)는 프로필의 각 곡선 대역과 비교된 다음, 카메라 레이블(DJI SRT
color_md, Sony XMLCaptureGammaEquation), 그 다음--log와 비교됩니다. 신뢰 순서: 명시적--log, 그 다음 신호, 그 다음 레이블. 모든 불일치는 로그와 SUMMARY.md에서 WARNING입니다 — 렌더링하기 전에 읽으십시오. D-Log vs D-Log M: 일광에서 D-Log는 흰색을 약 0.55 코드로 유지합니다(하늘/태양을 위한 슈퍼 흰색 위; Maginot p95 0.44-0.69); D-Log M은 이를 0.8+ 근처에 둡니다. D-Log 푸티지에 D-Log M LUT를 적용하면 흰색이 ~50% 회색(평탄하고 둔함)으로 렌더링됩니다 — Maginot은 D-Log였습니다. 너무 어둡거나(야간) 대역 사이 = 결정 불가 → 레이블이 결정합니다._shootpack/log/*.json이 통계를 캐시합니다. - 장치/곡선/색역별 LUT 일치: 정규화된 파일 이름 토큰으로
luts/official/의 공식 LUT("D-Log M"은 D-Log M으로 계산됨; Mavic 4 Pro LUT는 다른 DJI LUT보다 우선). 공식 LUT가 없는 DJI: 곡선 기반 웜 프린트 그레이드. Sony S-Log3: FilmCraft 내장builtin:slog3-sgamut3cine-to-rec709(또는-sgamut3-, XML의 CaptureColorPrimaries에서),luts/builtin/으로 내보냄; 우리의 D-Log 룩은luts/looks/slog3_*_composed.cube로 그 위에 재구성되며, 사전 노출이 일치되어 18% 그레이가 DJI의 입력 LUT가 넣는 곳에 도달합니다(혼합 DJI + Sony 편집 일치). S-Cinetone/Rec.709/HLG 클립은 디코딩이 필요 없음:_look.cube만 사용. - edit.json의 노출은 클립 곡선의 스톱당 코드 값으로 리프트됩니다(
lift: D-Log 67, S-Log3 79). - LightCraft 태양 샷:
light.whites를 0으로 유지하고light.highlights를 -60 또는 더 부드럽게 유지하십시오. 더 강한 복구 또는 마젠타 색조는 클리핑된 구름을 흰색 아래로 끌어내리고 분홍색으로 렌더링합니다. - 6K 렌더링:
trailer.py는 섹션으로 렌더링합니다(하드 컷과 딥 투 블랙에서 분할) — 14개의 병렬 6K 디코드는 16GB 메모리에서 메모리 부족이 발생합니다. - 여유 디스크 확인: 각 HDR DNG ≈ 300MB; 파이프라인은 5GB 미만에서 중지됩니다.