Community图像github.com

相机匹配测试

通过测量,将参考外观转化为尼康相机内置配置文件(.NP3),例如匹配富士胶片模拟、Lightroom预设或LUT效果,实现高精度色彩还原。

相机匹配测试 是什么?

该技能通过精确的测量而非猜测,将参考外观转化为尼康相机内置的灵活色彩图像控制(NP3)文件。其核心机制是利用尼康NX Studio的`SaveProcess`二进制程序,在约2秒内渲染带有任意NP3的NEF文件,且渲染结果与相机直出的JPEG高度一致。这使得每个候选配置文件都能在Mac上进行真实的尼康处理流程测试,直到最后一步才需要相机参与。技能支持多种输入:富士HEIF/JPEG、Lightroom导出的TIFF或经过LUT处理的图像,通过对比CMP色卡(988色块)的测量数据,使用ΔE2000色差公式优化Color Blender、色调曲线等参数,最终生成带版本号的PICCONnn.NP3文件,并可一键复制到相机的SD卡中。适用于需要将尼康相机匹配成富士风格、将特定外观或LUT转化为相机内预设、或验证配置文件色彩的Delta E精度等场景。

兼容平台~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 的新对话。

文档

相机匹配测试 是做什么的?

该技能通过测量而非猜测,将参考外观转化为尼康相机内置配置文件。核心思路:NX Studio的SaveProcess二进制程序能在约2秒内渲染带有任意NP3的NEF文件,其渲染结果与相机直出的JPEG高度吻合。因此,每个候选配置文件都可以在Mac上通过真实的尼康处理流程进行测试,直到最后一步才需要相机介入。

输入 = 通过NX Studio渲染的、带有待拟合配置文件的尼康NEF色卡文件。

参考(目标) = 需要匹配的外观,例如同一光照条件下拍摄的富士HEIF/JPEG色卡,或由尼康NEF在Lightroom中导出的TIFF文件。

拍摄前须知(务必提前告知用户)

对于跨相机参考(富士到尼康),色卡对必须仅在相机上存在差异:

  • 使用同一色卡(CMP Digital Target Ultimate,988色块),同一光照条件,同一位置。光线需均匀、漫射;避免色卡上出现眩光。
  • 白平衡:两台相机使用相同的固定色温最为纯净,但自动白平衡也可以,因为拟合器能进行校正(参见下方的neutralize_wb)。NP3本身没有白平衡设置,因此校正后残留的任何色偏都会被作为外观的一部分学习。
  • 曝光设置应确保白色色块在任一相机上都不被裁切。曝光值的匹配不如两者都清晰重要,因为拟合器可以调整曝光水平(参见match_exposure)。
  • 富士相机:选择所需的胶片模拟,关闭颗粒效果,除非色偏效果是外观的一部分则关闭色彩效果,设置为DR100,设定您希望固化的高光/阴影值,将锐度和降噪设为最低,镜头校正设为默认。HEIF需要较新的富士机型(X-H2/X-T5/X100VI系列);较旧的X100系列只能输出JPEG,JPEG也完全可以。
  • 尼康相机:使用灵活色彩图像控制作为基础,关闭动态D-Lighting,同时拍摄RAW和JPEG。
  • 至少拍摄三组色卡对,每组之间稍微移动色卡或调整曝光,以便保留一些组作为公正的测试集。
  • 曝光包围可以很好地形成配对:将每个尼康帧与具有相同曝光偏移的富士帧配对(使用exiftool检查ExposureCompensation和快门速度,而不是依赖文件顺序)。五组包围曝光中,使用中间的三组进行拟合,保留两端的两组作为测试。
  • 两台相机的取景可以不同(不同的焦距、镜头校正、裁切)。这没有问题,因为每张图像都会独立测量其色卡角落,仅比较色块平均值。只需确保整个色卡在两台相机中均位于画面内且合焦即可。
  • 在CMP色卡旁放置一个ColorChecker有助于在屏幕上目测白平衡和精度,但拟合器仅测量CMP色卡。
  • HEIF目标文件会通过macOS的sips工具转换为sRGB,输出为8位。这没有问题,因为每个色块平均了数千个像素。
  • 使用富士相机直出的JPEG或HEIF作为目标,而不是RAF原始文件。该文件就是胶片模拟效果;RAF文件需要原始文件转换器,这会引入转换器本身的外观,而非富士的原始效果。

工作流程

脚本位于此文件旁边的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":仅将尼康渲染图像平衡为中性,保持参考图像完全按拍摄时状态。当参考图像的色偏是外观的一部分时使用此选项,例如带有白平衡偏移的富士配方(在富士元数据中检查WhiteBalance和WhiteBalanceFineTune)。这样,配置文件将学习该暖色或冷色作为色调,尼康相机在现场可以使用自动白平衡拍摄。
      • "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. 如实报告结果。 首先报告保留数据(角色为test的色卡对)的ΔE2000值,然后是拟合数据、日常色彩和中性色彩的得分。如果某些控制项卡在极限值,也需要说明,因为这表示配置文件的格式已用尽调整空间。

  8. 仅在用户要求时复制到存储卡: 使用cp -n命令复制到<card>/NIKON/CUSTOMPC/目录,必要时创建该目录,然后比较校验和。相机菜单路径:照片拍摄菜单 → 管理图像优化校准 → 加载/保存 → 复制到相机,然后选择设置图像优化校准。

  9. 在相机上验证。 在评估任何相机JPEG之前,使用exiftool读取其PictureControlName标签。然后,将该JPEG作为camera_jpeg参数运行score命令。

解读结果

  • ΔE2000是核心指标。数值越低表示越接近;较小的数值在并排对比时难以察觉差异。
  • NP3配置文件的控制项有限,因此重复多轮拟合后,改善会在某个点停止。此时,应说明已接近该格式的极限,而非继续循环。
  • 色卡得分是强有力的参考,而非绝对证明。建议最后使用一些真实照片进行验证,并明确说明尚未测试肤色表现。

关键事项

  • 绝不覆盖文件;为所有内容添加版本号。
  • Nikon软件从控制点重建色调曲线,因此np3lib库会写入20个跟随LUT曲线的控制点。请勿在没有执行相同操作的情况下手动编辑曲线。
  • 如果更改NP3后SaveProcess的输出看起来没有变化,请检查侧边栏文件是否被正确读取:一个绿色色度−100的测试应仅使绿色部分去饱和。

相关技能