Color

O que Color faz?

O material chega misturado: câmera em log, celular em HDR, arquivo, gerado por IA, fotos RAW. Usado como está, cada tomada traz sua própria luz e seu próprio tom, e a peça fica com aparência remendada. Esta skill mede o arquivo antes de tocá-lo, converte primeiro e corrige depois, e sempre entrega uma folha de antes e depois.

O detalhe está em referencias/, junto a este arquivo:

Arquivo	O que traz
perfiles.md	Detectar S-Log3 e HLG medindo; curva, matriz e LUT de conversão para Rec.709; etiquetas de cor
luts.md	Colorir clipes de arquivo, LUT por tomada (igualar tomadas), pessoa e fundo em duas camadas, formato .cube
lumetri-por-script.md	Gradear no Premiere por script: estrutura, índices do Lumetri, armadilhas, resposta medida, objetivos
fotos-raw.md	Revelar RAW com a pele como referência, e a orientação de fotos e clipes

Fluxo

1. Identifica o que chega, medindo. Etiquetas com ffprobe (color_transfer, color_primaries, color_space) e, se disserem unknown, percentis de luma. Olha também a rotação e os fps reais.
2. Converte para Rec.709 o que não for, antes de qualquer outra coisa: HLG → SDR, S-Log3 → Rec.709. Força as etiquetas de saída.
3. Colore cada clipe de arquivo (b-roll, stock, gerado, do cliente) antes de usá-lo, com uma folha de antes e depois.
4. Iguala as tomadas entre si. Oferece "neutro ou uma tomada de referência" e que a pessoa escolha qual é a verdade.
5. Pessoa e fundo separadamente quando a pele e o fundo estão próximos em tom: duas LUTs sobre a rotoscopia.
6. Gradea no Premiere: um Lumetri por plano em V1 com o balanço, e o look comum em uma camada de ajuste. Mede cada passada com um fotograma exportado.
7. Verifica no Premiere ou no render medido, nunca no QuickTime, e entrega a folha.

O que não se quebra

Cada regra saiu de uma correção real.

• Mede-se o arquivo, não seu nome nem sua etiqueta. Porque o S-Log3 chega com etiquetas unknown e parece "falta contraste"; e alguns HLG não dizem no nome.
• Primeiro converte-se, depois colore-se. Porque uma correção em cima de um log ou um HLG sem converter sai lavada ou com dominante laranja.
• Todo clipe de arquivo é colorido antes de entrar numa peça: boa exposição, saturação viva mas crível, contraste firme e temperatura neutra. Porque cada fonte traz sua luz e seu tom, e a peça fica com aparência remendada.
• Níveis comuns aos três canais; balanço de brancos só com os pixels quase cinza. Porque esticar cada canal separadamente toma a cor do tema por uma dominante: um óxido vermelho saiu amarelo e roxo, e um pó de ouro com véu azul.
• Nada de ganho por canal num lugar que é realmente quente. O calor é modelado com split-tone e setores de tom. Porque o ganho por canal torna não neutro o que era cinza (nota-se na roupa branca e no papel).
• A tomada de referência é escolhida pela pessoa. Porque uma referência "quente" escolhida por ti pode ficar amarela demais; já aconteceu.
• Debaixo de um toldo ou de uma barraca colorida, mede-se a pele desde a primeira passada, não a mediana nem os cinzas. Porque o toldo domina o quadro e os rostos ficaram escuros, amarelados e esverdeados.
• Se os rostos ocupam pouco do quadro, manda o contraste do plano. O preto fica preto, com detalhe. Porque levantar rostos pequenos à força de exposição e sombras levantou os pretos e apagou a cor: "parece plano".
• Pergunta o gosto antes da passada final: luminoso e arejado, ou contrastado. Se não houver resposta, mais claro. Porque um look contrastado e escuro, embora bem medido, foi recebido como "a colorização está muito escura".
• Julga-se no Premiere ou medindo o render, não no QuickTime nem na visualização rápida do Finder. Porque estes aplicam o gamma da Apple e mostram lavado um export que está correto.
• Olha a folha de antes e depois sempre; com sujeitos de cor forte (ouro, óxido, produto), a 100% contra a tomada original. Porque uma correção automática pode mudar o tom do tema sem que se note em miniatura.
• O produto do cliente sobre fundo de estúdio toca-se só se for preciso. Porque seu fundo já vem ajustado e qualquer mudança o desalinha.
• O material de baixa resolução não vai para tela cheia. Um primeiro plano grande pede 1080 nativo ou mais; o redimensionamento só vale para cartões pequenos. Porque nenhuma cor conserta uma imagem mole.
• Antes de julgar uma foto ou um clipe "mal tirado", lê sua orientação. Porque algumas ferramentas ignoram a orientação e descarta-se material bom que só está mal exibido.

Números

O quê	Valor
Assinatura de S-Log3 (8 bits)	percentil 1 ≈ 24–30 · percentil 99 ≈ 148 · máximo ≈ 167
HLG	color_transfer = arib-std-b67, primárias bt2020; no Premiere, getColorSpace() trc 18 / prim 9 (Rec.709 = 1 / 1)
LUT	33³ (35.937 entradas), interpolação tetraédrica
Colorir	preto no percentil 0,4 do mínimo de canal e branco no 99,6 do máximo · balanço com pixels de saturação < 0,14 e luma 0,18–0,85, a 80% e limitado a ±10% · luma média alvo 0,44 (0,34 em cenas escuras) · saturação ×1,15 (×1,0 com ouro ou outra cor forte)
Igualar tomadas	Reinhard em LAB sobre um recorte central do sujeito · força 0,6 · escala limitada a 0,65–1,6
Plano de dia bem gradeado	p1 ≈ 7 · p50 ≈ 92–124 · p99 ≈ 243 · cinzas a* +0,8 / b* +4 (quente natural)
Plano bem exposto	p95 de luma ≈ 190–230
Rostos à sombra	L* ≈ 45–52, sem passar a mediana do quadro de ~150
Exteriores nublados, look luminoso	mediana ≈ 110–125 sobre 255
Vinheta no look	−0,25 (a −0,5 já escurece os cantos uns 17%)

Armadilhas técnicas

• ffmpeg arrasta as etiquetas de HLG embora lhe passes -color_trc bt709, e Premiere ou Remotion voltam a converter: o ouro sai laranja. Força setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709 ao final do filtro e comprova com ffprobe.
• Uma sequência sem tone mapping automático coloca o HLG tal qual e exporta-se lavado. E a preferência do Premiere "Monitorização de faixa dinâmica estendida" mostra no ecrã um HDR bonito que não é o que se exporta: desliga-a.
• Uma LUT aprendida em baixa resolução pinta laranja as cores saturadas: aprende-a a 1080 ou mais.
• As matrizes de cor "de memória" costumam trazer mal as linhas do verde e do azul: deriva-as das primárias.
• Lumetri por script: uma única mudança de temperatura pinta-se como se fosse matiz; fixa o par três vezes seguidas (lumetri-por-script.md).
• As LUTs novas só carregam ao iniciar Premiere, e a "LUT de entrada" por script é um índice, não um caminho.
• O "Auto" do Lumetri não é uma base: tende a esfriar, deixa matiz magenta e sobe a exposição demais.
• Com rotoscopia, o desfoque do fundo vai na pista do plano inteiro, não na rotoscopiada: aí desfoca a pessoa.
• Por script não se pode criar uma camada de ajuste nem remover um efeito: a camada é criada pela pessoa; um efeito que sobra deixa-se a zero e avisa-se.
• Ao meter fotogramas crus no ffmpeg por uma tubulação, etiqueta a entrada com a mesma cor que a saída, ou converte a curva e escurece uns 3 níveis.
• Os "120 fps" do celular costumam ser 30 reais: olha avg_frame_rate ou nb_frames.

"No QuickTime vê-se lavado"

Quase nunca é o export. QuickTime e a visualização rápida do Finder (o mesmo motor da Apple) leem o Rec.709 com um gamma de ~1,96: levantam as sombras e lavam a cor. Um iPhone provavelmente mostra igual; Android parece-se mais com Premiere. E se Premiere tiver desligada a gestão de cor do ecrã, o seu monitor mostra os valores crus, algo mais saturados num ecrã P3.

Antes de discutir, mede. Tira o mesmo instante do export e do Premiere (QE exportFramePNG ou export_frame_uxp):

ffmpeg -nostdin -v error -ss 12.0 -i export.mp4 -frames:v 1 export_12s.png

Mesmos RGB numa zona plana (uma parede, um céu) = o export é fiel. Confirma também qual janela é qual: a que oferece "Abrir com QuickTime Player" é a visualização rápida; a que diz "Programa:" é Premiere.

O que se entrega e o que se verifica

Entrega	Verifica-se
Clipe corrigido, com sufixo _c junto ao original (e as composições apontando para _c)	ffprobe: etiquetas bt709 / bt709 / bt709, mesmo tamanho, fps e duração que o original
Folha de antes e depois por clipe ou por plano	Pele natural, sem negros nem brancos queimados, sem dominantes; o tema conserva sua cor
LUT .cube (por tomada, ou fundo e pessoa)	Aplicada com ffmpeg -vf lut3d dá o mesmo que a transformação calculada
Gradeação no Premiere	Fotograma exportado de cada plano: p1, p50 e p99 de luma, a*/b* dos cinzas e L* da pele, antes e depois

Diz o que fica pendente: uma LUT nova que pede reiniciar Premiere, uma camada de ajuste que a pessoa tem que criar, ou um plano que não atinge o objetivo sem forçá-lo (rostos debaixo de uma viseira, por exemplo). Anota o feito em pieza.md.