CommunityImagemgithub.com

camera-match-test

Testa o quão próximo uma câmera Nikon Z (Zf, Z6III, Z5II, Z50II, Z8, ZR) pode igualar uma aparência de referência na câmera e cria um perfil Nikon Flexible Color Picture Control (.NP3) correspondente — seja uma simulação de filme Fujifilm JPEG/HEIF, exportação de preset ou perfil do Lightroom, ou uma imagem com LUT. Ele ajusta o NP3 a partir de uma foto de carta de cores processando NEFs sem interface gráfica através do mecanismo NX Studio (SaveProcess), medindo a carta CMP de 988 patches e ajustando Color Blender, Color Grading, saturação e curva de tom para minimizar o ΔE2000, em seguida grava um PICCONnn.NP3 com versão e pode copiá-lo para o cartão SD. Use esta skill sempre que o usuário quiser igualar uma Nikon a uma Fuji, transformar uma aparência, LUT ou simulação de filme em um perfil Nikon na câmera, criar uma 'receita Nikon' a partir de uma imagem de referência, ou verificar quão próximo um perfil está em Delta E — mesmo que ele apenas diga 'faça minha Zf parecer com minha X100' ou 'construa o perfil a partir desta carta'.

O que é camera-match-test?

Esta skill transforma uma aparência de referência (como uma simulação de filme Fujifilm, um preset do Lightroom, ou uma imagem com LUT) em um perfil Nikon que pode ser carregado diretamente na câmera (NP3). O processo é totalmente automatizado: ela utiliza o mecanismo de processamento de imagem NX Studio (SaveProcess) para renderizar NEFs com diferentes perfis NP3 sem intervenção manual, mede a precisão das cores usando uma carta de cores CMP de 988 patches, e ajusta automaticamente os controles disponíveis no formato NP3 (Color Blender, Color Grading, saturação e curva de tom) para minimizar a diferença de cor ΔE2000 entre a referência e a imagem Nikon processada. A skill suporta diferentes modos de correspondência de balanço de branco (neutro na referência, neutro em ambos, ou sem correção) para lidar com diferentes situações de iluminação e intenções artísticas. O resultado final é um arquivo PICCONnn.NP3 que pode ser copiado para o cartão SD da câmera e ativado no menu Picture Control. Ela é ideal para usuários avançados que desejam criar 'receitas' Nikon precisas a partir de referências de outras marcas ou editadas em softwares externos, garantindo que a aparência seja reproduzida fielmente na câmera — seja para fotografia cotidiana ou para projetos criativos que exigem consistência de cor.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Camera Match Test

Esta skill transforma uma aparência de referência em um perfil Nikon na câmera por medição, não por tentativa e erro. A ideia central: o binário SaveProcess do NX Studio renderiza um NEF com qualquer NP3 em cerca de 2 segundos, e suas renderizações se aproximam muito dos JPEGs da própria câmera. Assim, cada perfil candidato pode ser testado no processamento Nikon real, no Mac, sem a necessidade da câmera até o final.

Entrada = o NEF Nikon da carta, renderizado através do NX Studio com o perfil que está sendo ajustado. Referência (alvo) = a aparência a ser igualada, por exemplo um HEIF/JPEG Fuji da mesma carta na mesma luz, ou uma exportação TIFF do Lightroom do NEF Nikon.

Antes de fotografar (informe o usuário antecipadamente)

Para uma referência entre câmeras (Fuji para Nikon), o par de cartas deve diferir apenas na câmera:

  • Mesma carta (CMP Digital Target Ultimate, 988 patches), mesma luz, mesma posição. Luz difusa e uniforme; evite reflexos na carta.
  • Balanço de branco: um Kelvin fixo e correspondente em ambas as câmeras é o mais limpo, mas o WB automático é aceitável porque o ajustador pode corrigi-lo (veja neutralize_wb abaixo). Um NP3 não possui configuração de balanço de branco própria, então qualquer tonalidade residual após a correção é aprendida como parte da aparência.
  • Exponha para que os patches brancos não estourem em nenhuma das câmeras. Valores de exposição correspondentes são menos importantes do que ambos estarem limpos, porque o ajustador pode nivelar a exposição (veja match_exposure).
  • Fuji: simulação de filme escolhida, Grain desligado, Color Chrome desligado a menos que faça parte da aparência, DR100, Highlight/Shadow nos valores que você deseja incorporar na aparência, Sharpness e NR no mínimo, correções de lente no padrão. HEIF requer uma Fuji recente (era X-H2/X-T5/X100VI); uma X100-série mais antiga grava apenas JPEG, e JPEG é aceitável.
  • Nikon: Flexible Color Picture Control como base, Active D-Lighting desligado, RAW + JPEG.
  • Fotografe pelo menos três pares, movendo a carta ou a exposição ligeiramente entre eles, para que alguns pares possam ser reservados como teste justo.
  • Brackets de exposição funcionam bem como pares: combine cada quadro Nikon com o quadro Fuji com o mesmo deslocamento de exposição (verifique ExposureCompensation e velocidade do obturador com exiftool em vez de confiar na ordem dos arquivos). Com cinco brackets, ajuste nos três pares do meio e reserve as duas extremidades.
  • As duas câmeras podem enquadrar de forma diferente (distâncias focais diferentes, correções de lente, corte). Isso é aceitável, porque cada imagem obtém seus próprios cantos da carta e apenas as médias dos patches são comparadas. A carta inteira só precisa estar no quadro e em foco em ambas.
  • Um ColorChecker ao lado da carta CMP é útil para avaliar visualmente o balanço de branco e a precisão na tela, mas o ajustador mede apenas a carta CMP.
  • Os alvos HEIF são convertidos para sRGB com o sips do macOS, que grava 8 bits. Isso é aceitável, porque cada patch faz a média de milhares de pixels.
  • Use o próprio JPEG ou HEIF da Fuji como alvo, não o RAF. Esse arquivo é a simulação de filme; um RAF precisaria de um conversor raw, que traria a aparência desse conversor em vez da Fuji.

Fluxo de trabalho

Os scripts estão em scripts/ ao lado deste arquivo. Execute-os com python3 <skill>/scripts/np3fit.py <comando> <config.json>. Mantenha tudo — NEFs copiados, renderizações, configurações e o perfil ajustado — no scratchpad da sessão e pergunte ao usuário onde o perfil finalizado deve ser salvo antes de copiá-lo para qualquer outro lugar.

  1. Copie os NEFs do cartão para uma pasta de trabalho privada primeiro. Nunca edite ou exclua nada no cartão e verifique se o cartão não é somente leitura antes de copiar de volta posteriormente (mount | grep -i volumes).

  2. Escreva a configuração. Modelo:

    {
      "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 é o que aparece na câmera: ASCII, no máximo 19 caracteres. Use numeração de revisão (R01, R02 …) para que nada seja sobrescrito.
    • start_np3 deve ser um NP3 Flexible Color com uma curva de tom personalizada. O flexible_color_template.NP3 incluído funciona como modelo para qualquer aparência: o fit também tenta um início de cor neutra a partir do mesmo arquivo e mantém o que se ajustar melhor.
    • neutralize_wb corrige o balanço de branco usando os patches cinza da carta (anel cinza externo mais cada patch que lê quase neutro, refinado em algumas passagens):
      • "nikon": equilibra apenas a renderização Nikon para neutro e mantém a referência exatamente como foi fotografada. Use isso quando a tonalidade de cor da referência fizer parte da aparência, por exemplo uma receita Fuji com deslocamento de WB (verifique WhiteBalance e WhiteBalanceFineTune nos metadados da Fuji). O perfil então aprende esse calor ou frieza como um tom, e a Nikon pode fotografar com WB automático em campo.
      • "both": equilibra ambas as imagens para neutro. Use isso quando qualquer tonalidade for indesejada (luz diferente, incompatibilidade acidental), para que o perfil aprenda apenas a cor.
      • false: compara como fotografado. Use isso quando ambas as câmeras usaram o mesmo Kelvin fixo. O log mostra a correção que cada imagem precisou. Alguns por cento é normal; muito mais significa que as câmeras viram luz diferente ou uma foi configurada incorretamente.
    • Cantos são os centros dos patches A1, A38, Z1, Z38 em pixels de resolução total dessa imagem, como [x1,y1, x2,y2, x3,y3, x4,y4]. Guie-se pelas letras de linha e números de coluna impressos, não pela posição na tela, porque a carta geralmente é fotografada girada ou de cabeça para baixo; A1 pode estar no canto inferior direito. Os cantos do NEF estão na geometria do JPEG da câmera (as renderizações do NX aplicam as correções de lente da câmera, portanto se alinham com o JPEG da câmera, não com uma exportação do Lightroom).
  3. preview grava visualizações de régua de cada renderização NEF e de cada alvo. Observe-os e leia os centros dos quatro patches de canto; aproximado é suficiente (dentro de meio patch).

  4. grid refina os cantos, grava imagens de sobreposição e salva uma configuração _grid.json. Observe cada sobreposição: cada caixa amarela deve estar dentro de um único patch. Use o _grid.json daqui em diante.

  5. score fornece o ponto de partida e, se camera_jpeg estiver definido, o que a câmera produz atualmente. Relate esta linha de base antes do ajuste.

  6. fit (leva de 10 a 40 minutos, portanto inicie em segundo plano e informe ao usuário aproximadamente quanto tempo). Ele grava <output_dir>/<name>/NIKON/CUSTOMPC/PICCONnn.NP3 mais settings.json e nunca sobrescreve: se a pasta existir, adiciona _rev2, _rev3.

  7. Relate honestamente. Lidere com o ΔE2000 dos pares reservados (pares com role: test), depois pares ajustados, cores do dia a dia e neutros. Mencione controles presos em seus limites, porque isso significa que o formato ficou sem espaço.

  8. Copie para o cartão somente quando o usuário disser: cp -n para <card>/NIKON/CUSTOMPC/, criando essa pasta se necessário, depois compare checksums. Menu da câmera: Photo Shooting Menu → Manage Picture Control → Load/save → Copy to camera, depois Set Picture Control.

  9. Verifique na câmera. Antes de pontuar qualquer JPEG da câmera, leia seu PictureControlName com exiftool. Em seguida, execute score com esse JPEG como camera_jpeg.

Lendo resultados

  • ΔE2000 é a métrica principal. Quanto menor, mais próximo; valores pequenos são difíceis de ver lado a lado.
  • Os perfis NP3 possuem controles limitados, portanto rodadas repetidas param de melhorar em algum ponto. Quando isso acontecer, diga que o limite do formato foi atingido em vez de fazer loop.
  • As pontuações da carta são um guia forte, não uma prova. Sugira algumas fotos reais no final e diga claramente se a pele não foi testada.

Coisas que importam

  • Nunca sobrescreva arquivos; versione tudo.
  • O software da Nikon reconstrói a curva a partir de pontos de controle, então o np3lib escreve 20 pontos que seguem o LUT. Não edite curvas manualmente sem fazer o mesmo.
  • Se a saída do SaveProcess parecer inalterada após alterar o NP3, verifique se o sidecar está sendo lido: um teste de croma verde −100 deve dessaturar apenas os verdes.

Habilidades Relacionadas