Community影像github.com

相機匹配測試

測試 Nikon Z 相機(Zf、Z6III、Z5II、Z50II、Z8、ZR)在機內與參考風格匹配的精度,並為其建立 Nikon 可靈活調整的色彩設定檔(.NP3)——無論是 Fujifilm JPEG/HEIF 底片模擬、Lightroom 描述檔或預設匯出,還是 LUT 影像。它透過 NX Studio 自己的引擎(SaveProcess)無頭渲染 NEF 來對齊色卡,測量 988 色塊的 CMP 色卡,並調整「色彩混合器」、「色彩色調」、「飽和度」與「色調曲線」以最小化 ΔE2000,然後寫入帶版本號的 PICCONnn.NP3,並可複製到 SD 卡。每當使用者想要讓 Nikon 匹配 Fuji、將某個風格、LUT 或底片模擬轉換為機內 Nikon 設定檔、從參考影像製作「Nikon 配方」,或檢查設定檔的 Delta E 精確度時,都可使用此技能——即使他們只說「讓我的 Zf 看起來像我的 X100」或「從這張色卡建立設定檔」。

相機匹配測試 是什麼?

Camera Match Test 技能旨在透過精確測量而非憑感覺,將參考風格轉換為 Nikon 機內可用的色彩設定檔。其核心概念是:NX Studio 的 `SaveProcess` 二進位檔約需 2 秒即可使用任意 NP3 渲染 NEF,且其渲染結果與相機直接產生的 JPEG 極為接近。因此,每個候選設定檔都能在 Mac 上透過真實的 Nikon 處理引擎進行測試,直到最後一刻才需要相機本體。此技能專為開發者、攝影師與 AI 代理使用者設計,適用於需要跨相機品牌匹配色彩、將 LUT 或底片模擬轉換為機內設定檔,或客觀驗證設定檔色彩還原精度的場景。它支援 Canon 與 Nikon 等硬體平台,但重點聚焦於 Nikon Z 系列相機與 Fujifilm 底片模擬之間的匹配。工作流程包括:複製 NEF 檔案、撰寫包含色塊角落座標等資訊的 JSON 設定、預覽與格線校正、透過多輪最佳化進行擬合,最後將結果複製到 SD 卡。.*

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gerard662/nikon-picture-control-matcher/tree/HEAD/camera-match-test

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

相機匹配測試 是做什麼的?

這項技能通過測量而非猜測,將參考風格轉換為 Nikon 機內設定檔。核心概念:NX Studio 的 SaveProcess 二進位約需 2 秒即可使用任一 NP3 渲染 NEF,且其渲染結果與相機自身的 JPEG 非常接近。因此,每個候選設定檔都可以在 Mac 上透過真實的 Nikon 處理引擎進行測試,直到最後一步才需要相機本體。

輸入 = 色卡的 Nikon NEF,透過 NX Studio 使用正在擬合的設定檔進行渲染。 參考(目標) = 要匹配的風格,例如同一色卡在同一光線下的 Fuji HEIF/JPEG,或 Nikon NEF 的 Lightroom TIFF 匯出。

拍攝前(請事先告知使用者)

對於跨相機的參考(Fuji 到 Nikon),色卡配對必須只有相機不同:

  • 同一張色卡(CMP Digital Target Ultimate,988 色塊),相同光線、相同位置。均勻的漫射光;避免色卡上有眩光。
  • 白平衡:兩台相機設定相同的固定色溫是最乾淨的做法,但自動白平衡也可以,因為擬合器可以校正它(請參閱下面的 neutralize_wb)。NP3 沒有自己的白平衡設定,因此白平衡校正後殘留的色偏將被學習為風格的一部分。
  • 曝光:確保兩台相機的白色色塊都沒有過曝。匹配曝光值不如兩者都乾淨重要,因為擬合器可以平衡曝光(請參閱 match_exposure)。
  • Fuji:選擇所需的底片模擬,關閉「顆粒效果」,除非它是風格的一部分則關閉「色彩效果」,設定 DR100,將「亮部」和「陰影」設定為您要融入風格的數值,將「銳利度」和「雜訊抑制」設為最低,鏡頭校正設為預設值。HEIF 需要較新的 Fuji 機身(X-H2/X-T5/X100VI 世代);較舊的 X100 系列機身只能輸出 JPEG,JPEG 也可以。
  • Nikon:使用「可靈活調整的色彩設定」為基礎,關閉「主動式 D-Lighting」,同時拍攝 RAW + JPEG。
  • 至少拍攝三組配對,每次稍微移動色卡或改變曝光,這樣可以保留一些配對作為公平的測試。
  • 曝光包圍很適合做為配對:將每個 Nikon 幀與具有相同曝光補償的 Fuji 幀進行匹配(使用 exiftool 檢查 ExposureCompensation 和快門速度,不要依賴檔案順序)。使用五張包圍時,用中間三組配對進行擬合,保留兩端。
  • 兩台相機的取景可以不同(不同的焦距、鏡頭校正、裁切)。這沒問題,因為每張影像都有自己的色塊角落,而且只比較色塊平均值。只要整個色卡在兩台相機上都在畫面內且對焦清晰即可。
  • 在 CMP 色卡旁邊放一個 ColorChecker 有助於目測白平衡和準確度,但擬合器只測量 CMP 色卡。
  • HEIF 目標會透過 macOS 的 sips 轉換為 sRGB,這會輸出 8 位元。這沒問題,因為每個色塊平均了數千個像素。
  • 使用 Fuji 自身的 JPEG 或 HEIF 作為目標,而不是它的 RAF。那個檔案就是底片模擬;RAF 需要 RAW 轉換器,這會引入該轉換器的風格,而不是 Fuji 的風格。

工作流程

腳本位於此檔案旁邊的 scripts/ 目錄中。使用 python3 <skill>/scripts/np3fit.py <command> <config.json> 執行它們。將所有內容——複製的 NEF、渲染結果、設定和擬合後的設定檔——保留在會話暫存區中,並在使用者指定最終儲存位置之前詢問他們要將設定檔儲存在何處。

  1. 從記憶卡複製 NEF 到一個私有的工作資料夾。永遠不要編輯或刪除記憶卡上的任何內容,並在稍後複製回記憶卡前檢查記憶卡是否為唯讀(mount | grep -i volumes)。

  2. 編寫設定檔。 範本:

    {
      "work_dir": "<scratchpad>/np3fit",
      "output_dir": "<scratchpad>/profiles",
      "name": "Fuji Provia R01",
      "slot": 1,
      "start_np3": "<skill>/assets/flexible_color_template.NP3",
      "match_exposure": false,
      "neutralize_wb": "nikon",
      "weighting": "everyday",
      "rounds": 3,
      "pairs": [
        {"id": "A", "nef": ".../NZF_0001.NEF", "target": ".../DSCF0001.HIF", "role": "train", "camera_jpeg": ".../NZF_0001.JPG",
         "nef_corners": [0,0, 0,0, 0,0, 0,0], "target_corners": [0,0, 0,0, 0,0, 0,0]},
        {"id": "B", "...": "...", "role": "test"}
      ]
    }
    
    • name 是顯示在相機上的名稱:ASCII 字元,最多 19 個字元。使用版本編號(R01、R02……)以免覆蓋任何檔案。
    • start_np3 必須是具有自訂色調曲線的「可靈活調整的色彩」NP3。隨附的 flexible_color_template.NP3 可作為任何風格的範本:fit 也會從同一個檔案嘗試中性色起始點,並保留擬合效果較好的一個。
    • neutralize_wb 使用色卡的灰色色塊(外圈灰色環加上每個讀取為接近中性的色塊,經過幾次疊代精煉)來校正白平衡:
      • "nikon":僅將 Nikon 渲染結果平衡到中性,並保持參考影像完全不變。當參考影像的色偏是風格的一部分時使用此選項,例如帶有白平衡偏移的 Fuji 配方(在 Fuji 的元資料中檢查 WhiteBalance 和 WhiteBalanceFineTune)。然後設定檔會將那種暖色或冷色學習為色調,而 Nikon 在現場拍攝時可以使用自動白平衡。
      • "both":將兩張影像都平衡到中性。當不希望有任何色偏時(例如不同的光線、意外的不匹配)使用此選項,這樣設定檔只學習色彩。
      • false:直接比較原始影像。當兩台相機使用相同的固定色溫時使用此選項。 日誌會顯示每張影像所需的校正量。幾個百分點是正常的;太多則表示相機看到的光線不同或其中一台設定錯誤。
    • 角落是色塊 A1、A38、Z1、Z38 中心點在該影像全解析度像素中的座標,格式為 [x1,y1, x2,y2, x3,y3, x4,y4]。請根據列印在色卡上的行字母和列數字來判斷,而不是根據螢幕位置,因為色卡常常是旋轉或倒置拍攝的;A1 可能在右下角。NEF 角落是相機 JPEG 的幾何座標(NX 渲染會套用相機的鏡頭校正,因此它們與相機 JPEG 對齊,而不是與 Lightroom 匯出對齊)。
  3. preview 會為每個 NEF 渲染結果和每個目標寫入標尺預覽。查看它們並讀出四個角落的色塊中心點;粗略即可(在半個色塊以內)。

  4. grid 會細化角落,寫入疊加影像,並儲存一個 _grid.json 設定。查看每一張疊加影像:每個黃色方塊必須完全位於單一色塊內部。從這裡開始使用 _grid.json。

  5. score 會給出起始點的分數,如果設定了 camera_jpeg,還會給出相機目前產生的分數。在擬合前報告這個基準線。

  6. fit(執行時間 10-40 分鐘,因此在背景執行並告知使用者大約需要多久)。它會寫入 <output_dir>/<name>/NIKON/CUSTOMPC/PICCONnn.NP3 和 settings.json,並且絕不覆蓋:如果資料夾已存在,則會增加 _rev2、_rev3。

  7. 誠實報告。 首先報告保留的 ΔE2000(role: test 的配對),然後是擬合的配對、日常色彩和中性的分數。提及卡在極限的控制項,因為這表示設定檔格式的調整範圍已用盡。

  8. 僅在使用者指示時才複製到記憶卡:使用 cp -n 複製到 <card>/NIKON/CUSTOMPC/,如有需要請建立該資料夾,然後比較校驗碼。相機選單:照片拍攝選單 → 管理 Picture Control → 載入/儲存 → 複製到相機,然後設定 Picture Control。

  9. 在相機上驗證。 在為任何相機 JPEG 評分之前,先用 exiftool 讀取其 PictureControlName。然後使用該 JPEG 作為 camera_jpeg 執行 score。

閱讀結果

  • ΔE2000 是首要指標。數值越低越接近;很小的數值在並排比較時難以用肉眼察覺。
  • NP3 設定檔的控制項有限,因此重複的擬合輪次最終會在某個點停止改善。發生這種情況時,請說明已達到格式的限制,而不是繼續循環。
  • 色卡分數是強有力的參考,並非最終證明。建議最後拍攝幾張真實照片,並誠實說明尚未測試過膚色。

重要事項

  • 絕不覆蓋檔案;所有檔案都應進行版本控制。
  • Nikon 軟體會根據控制點重建曲線,因此 np3lib 會寫入 20 個遵循 LUT 的點。不要手動編輯曲線而不執行相同操作。
  • 如果修改 NP3 後 SaveProcess 輸出看起來沒有變化,請檢查是否正確讀取了 sidecar 檔案:一個綠色色調 -100 的測試應該只使綠色去飽和。

相關技能