shootpack 是做什麼的?
Pipeline 位於 ~/shootpack(Git 儲存庫)。進入點:shootpack <folder> [--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 型號 ILCE-1M2):ARW 包圍曝光(+ JPG/HEIF 配對,也可跨記憶卡)按曝光偏差 + 驅動模式分組;剪輯 XML 側車檔(C0001M01.XML)提供開始時間、影格率、Gamma 和色域;SUB/ 代理。無相機幾何:無自動太陽設定檔(需手動在 cull.json 中設定"sun"),篩選依據影像內容(幾乎相同的影格 = 重複),並以鏡頭命名照片(24mm、70mm-portrait)。 - Fujifilm X-E4(
fujifilm_xe4,EXIF 型號 X-E4 於 RAF、JPG 和 MP4):單張影格,RAF + JPG 配對。JPG 是配方渲染(Classic Chrome 等;配方在 RAF 的 EXIF 中,請參閱photo.recipe_tags);LightCraft 自身的 RAF 顯像暗沉且平淡,且忽略該配方,因此在匯出前需將顯像設定檔配適到相機 JPEG。同一 DCIM 資料夾中的剪輯,無側車檔;底片模擬剪輯為 Rec.709(僅外觀,無技術 LUT),F-Log 則從訊號中偵測。卸載:shootpack offload <card> --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 小時)。活動剪輯含現場收音:clip_edit.py edits/<spec>.json Video/<name>_4K.mp4(無音樂,L-cut 音訊;除非 motion.py 證實有幫助,否則保持穩定功能關閉)。請參閱 agent-docs/photos/fuji-recipe.md。 - DJI Osmo 360 II(
dji_osmo360ii,透過 MP4 編碼器標籤Osmo 360 II找到.OSV):雙魚眼串流,因此其剪輯會被擱置(日誌會顯示 "N 360 clip(s) ... render them with osmo360.py"),且永遠不會進入房產剪輯。osmo360.py CLIP.OSV Deliverables/Video會輸出一個經過調色的平面重新構圖(關鍵格動畫)和一個經過調色的等距 360 影像。拼接未經校準,水平線未調平;鏡頭在重疊區域進行了增益匹配。色彩模式從影像圈內的訊號讀取(Normal 色彩 vs D-Log M,已在兩者的真實剪輯上驗證)。D-Log M 會獲得一個暫時性的 LUT,配適到相機自身的代理(luts/interim_dlogm_to_709_osmo360ii.cube),直到 DJI 的 Osmo 360 D-Log M LUT 放入luts/official/。--spec edits/osmo_car_v1.json會渲染長剪輯的關鍵格摘錄(汽車測試中駕駛員的緊湊、提升曝光量的裁切)。一個平面裁切具有18.6 x h_fov的真實像素寬度:緊湊裁切的 4K 會被放大(agent-docs/video/osmo360.md)。此相機有內部儲存空間和一張 SD 卡(兩個磁碟區)。卸載:shootpack offload <card>會自行找到它(Drops/Osmo360/)。 - 雙插槽錄製:兩張卡上的相同檔案會被偵測(名稱 + 拍攝時間 + 大小,然後是雜湊),並使用插槽 1 的副本;日誌會顯示跳過了多少個。
- 無 GPS 的情況(僅相機拍攝):拍攝時段按本地時鐘時間命名(早晨 < 10:00,中午 < 15:00,下午 < 17:30,傍晚),調色風格依名稱而定(中午/下午:中午風格;其他:金色風格)。傳遞
--latlon則改為依據太陽命名。Sony 照片沒有幾何資訊,因此太陽照片不會獲得自動太陽設定檔:需手動在 cull.json 中設定"sun": {"G18": "A"}(自動顯像會將暗沉的太陽穿透玻璃畫面拉平)。 - 新相機:複製最接近的設定檔,更改
detect.models、感光元件/視野、包圍規則和記錄曲線。
步驟
- 執行它。 在背景下執行
shootpack "<folder>" --ceiling <使用者的 LAANC/空域天花板,預設 120>(照片約每組包圍曝光 25 秒,影片約 4 分鐘)。它會將所有快取存放在<folder>/Deliverables/_shootpack/中。 - 視覺化審查篩選結果 — 打開
Deliverables/_shootpack/<session>/all_stations.jpg和每個Deliverables/Photos/<session>/Picks_contact_sheet.jpg。自動篩選無法判斷內容,因此請檢查並修正:- 房屋被裁切到邊框邊緣 → 移至拒絕區
- 畫面中有人(通常是穿高可見度背心的飛行員) → 備選,註明「PERSON-IN-FRAME」
- 近乎重複 / 無聊的重複 → 備選;留在備選區的優秀照片 → 精選
- 超過天花板的照片已在備選區標記 — 提及它們,不要隱藏
編輯
<session>/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(相對高度、位置)來找到更好的時刻。相機剪輯沒有遙測資料,因此起飛/降落修剪和高度範圍不適用;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,曝光以 log 方式應用,用於 FilmCraft 的輸入插槽;_look.cube= Rec.709→Rec.709 用於創意插槽;_composed.cube= 兩者,用於 ffmpeg)。將曝光提升放在官方 LUT 之前(--pre-exposure,以 log 級為單位):DJI 的 LUT 比其自身的 JPEG 暗,且在之後提升會裁切天空(Maginot 的第 5 版因為這個原因整體暗了 30-50%)。在沒有官方 LUT 的情況下,會使用基於曲線的warm_print_v6/warm_print_midday_v2。務必驗證新的官方 LUT 是否與素材的設定檔匹配(見下文)。 - 音樂(預告片) — 透過使用者的 OAuth 連接器使用 Epidemic Sound(絕不使用 API 金鑰)。搜尋樂器「build」曲目,其小節長度與蒙太奇剪接點匹配(75 BPM = 3.2 秒小節),並讀取每個波形的能量曲線:你需要一個安靜的開頭、一個長的鋪陳和一個大的高潮。將
DownloadRecording(WAV,FULL)下載到Deliverables/Music/,然後music.analyze(wav, given_bpm):檢查高潮是否落在強拍上(網格的輕/重拍相位來自大鼓/貝斯,小節相位來自最大的低頻跳躍)。選擇跳躍點 X→Y,其中 Y 小節與 X+1 小節的bar_chroma相似度 >= 0.9(相同和弦,無可聽出的接合點)。在小節網格上以整數影格計時畫面(範本: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"平滑鏡頭:數字 = 高斯 sigma 值,單位為秒(1-2),{"poly": 2}= 一個均勻的移動。沒有信箱模式時,每個垂直修正都會消耗縮放比例,因此保持 sigma 適中(參考拍攝的結尾:1.25 = 6.6% 縮放,2.0 將是 12%);"reframe_y"只有在有信箱模式時才有幫助。為了在移動結束時保留更多房屋,請減慢鏡頭速度使其更早結束移動。在渲染前後測量抖動(在預覽上使用stabilize.track);空拍機自身的停止和反向動作只能被柔化(較重的 sigma + 0.85x),無法完全消除。 Epidemic 的EditRecording在設定requiredRegionsAtOffsets時從未返回剪輯,且其不受限制的 60 秒剪輯完全刪除了高潮(2026 年 10 月),因此我們自行剪輯曲目。客戶工作需要商業 Epidemic 方案;請詢問。 - 交付 — 使用 SendUserFile 發送精選照片的連絡表、720p 預覽(小於 30 MB)和故事板;從
Deliverables/SUMMARY.md總結(數量、標記、哪些是暫行結果)。將任何可重複使用的程式碼變更提交到儲存庫。
顯示進度
對於每一次變更,提供前後對比:更新 review_site/<shoot>/progress/*/manifest.json(調色 / 照片 / 細節 / 剪輯 / 音樂)並使用 progress_page.py 重建(progress_music.py 繪製音樂配適圖表);使用 SendUserFile 發送適合手機的試算表或並排對比影片。
重要事實
- 總是從原始檔(DJI DNG,Sony ARW)顯像;JPG 僅作為元資料/參考。僅有 ARW 的鏡頭會在
_shootpack/previews/中從原始檔提取參考 JPEG。LightCraft 渲染 ARW 時,會使用配適到 Sony 自身 JPEG(而非預設的平淡中性)的外觀,但沒有 Sony 鏡頭設定檔:失真/暗角保持原樣。其 ARW 的 HDR 合併會輸出一個沒有色彩矩陣或白平衡的 DNG(顯像偏綠):pipeline 會寫入相機的校準(ColorMatrix1 來自 LibRaw 的 Adobe 衍生表格,AsShotNeutral 來自該鏡頭)並顯像該檔案,因此來自 Sony 包圍曝光的 HDR_DNG/ 檔案在任何原始編輯器中都能以正確色彩開啟。 - LightCraft 會在其來源旁寫入
*-HDR.dng;pipeline 會將它們移動到Deliverables/HDR_DNG/。切勿修改原始檔。 - DJI MP4 以旋轉方式儲存(
rotation=-90);ffprobe 報告直立尺寸,但它們以橫向播放。 - Sony 記憶卡:從每個插槽複製完整的
DCIM/+PRIVATE/樹(Finder 無法以 MTP 模式連接相機 — 請使用讀卡機或 USB 大容量儲存裝置);沒有M01.XML側車檔時,剪輯的 Gamma/色域會回退到僅依靠訊號。 - SRT
DiffTime: 16ms= 59.94p → 以半速轉換為 29.97 以獲得流暢的環繞。 - 記錄曲線是根據每個剪輯的訊號決定的:約 10 幀的亮度碼值分佈(p95 = 白色所在位置)會與設定檔中每個曲線的區間進行比對,然後是相機的標籤(DJI SRT
color_md,Sony XMLCaptureGammaEquation),然後是--log。信任順序:明確的--log,然後是訊號,然後是標籤。每個不一致都會在日誌和 SUMMARY.md 中顯示為警告 — 在渲染前閱讀它。D-Log vs D-Log M:在日光下,D-Log 將白色保持在約 0.55 碼值(天空/太陽的超級白色以上;Maginot p95 0.44-0.69);D-Log M 將其置於接近 0.8+。將 D-Log M LUT 應用於 D-Log 素材會將白色渲染為約 50% 灰色(平坦、沉悶) — Maginot 是 D-Log。太暗(夜晚)或位於區間之間 = 不確定 → 由標籤決定。_shootpack/log/*.json快取了統計資料。 - 按裝置/曲線/色域進行的 LUT 匹配:
luts/official/中的官方 LUT 依正規化的檔名標記(「D-Log M」算作 D-Log M;Mavic 4 Pro LUT 勝過其他 DJI LUT)。DJI 沒有官方 LUT:使用基於曲線建立的暖色調列印風格。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 解碼會在 16 GB 記憶體上耗盡記憶體。 - 注意可用磁碟空間:每個 HDR DNG 約 300 MB;pipeline 在剩餘空間低於 5 GB 時會停止。