Aplique um filtro sépia a pixels RGB de imagem

Aplique um filtro sépia a pixels de imagem já decodificados sem enviar um arquivo nem depender de um codec. Informe uma lista ordenada de amostras RGB e receba as amostras correspondentes em tons marrons quentes, calculadas com a matriz de transformação sépia padrão. Cada canal transformado é arredondado e limitado ao intervalo válido de zero a 255. A validação completa impede que pixels incompletos ou inválidos alterem silenciosamente o resultado, enquanto o processamento determinístico torna o conversor adequado para produção, conferências no navegador, ensino e testes automatizados exatos.

Prepare amostras completas de pixels RGB

Coloque os pixels decodificados no campo samples como uma lista não vazia de objetos. Cada objeto deve conter os canais r, g e b, e todo canal deve ter um valor numérico finito entre zero e 255, inclusive. Inteiros são convencionais, mas valores fracionários são aceitos porque alguns fluxos de imagem produzem amostras intermediárias de ponto flutuante antes da codificação final.

O conversor verifica cada registro e não supõe que um componente ausente seja zero. Esse comportamento rigoroso protege a estrutura da imagem: ignorar um registro deslocaria todos os pixels seguintes, enquanto substituir um valor inventaria informação de cor. Preserve a ordem do raster, pois a saída mantém exatamente a ordem da entrada.

Uma solicitação aceita até cem mil registros. Divida imagens maiores em blocos de tamanho fixo e concatene os resultados na mesma sequência. A capacidade processa amostras RGB, não bytes PNG, JPEG, AVIF ou WebP.

Decodifique o arquivo antes e mantenha largura, altura, passo de linha, orientação e canal alfa separados para recombiná-los durante a codificação.

Entenda a transformação sépia padrão

Cada pixel de saída resulta de três somas ponderadas. O vermelho é calculado como 0.393 vezes r mais 0.769 vezes g mais 0.189 vezes b. O verde usa 0.349 vezes r mais 0.686 vezes g mais 0.168 vezes b.

O azul usa 0.272 vezes r mais 0.534 vezes g mais 0.131 vezes b. Essa matriz sépia conhecida altera a luminância e o equilíbrio dos canais, produz realces dominados por vermelho e verde quentes e reduz o azul. O conversor arredonda cada soma para o inteiro mais próximo e depois a limita ao intervalo inclusivo de zero a 255.

Essa limitação é importante porque as linhas da matriz podem gerar valores acima de 255 em pixels claros. Sem ela, buffers de bytes posteriores poderiam estourar, rejeitar o valor ou exibir outra cor. A resposta inclui a matriz, as amostras convertidas e a contagem, permitindo registrar exatamente qual transformação foi aplicada.

O processamento é puro e determinístico: não usa rede, modelo, aleatoriedade, hora atual, perfil de cor oculto nem cache mutável. Ele não lineariza RGB com gama, interpreta perfis ICC, simula filme químico, adiciona granulação, preserva transparência nem mistura o resultado com o original.

Integre e confira o resultado convertido

Use a lista samples retornada como substituição posicional da lista RGB enviada. O campo count deve ser igual ao número de registros de entrada; compare os valores antes de reconstruir um bloco, linha, miniatura, buffer de canvas ou raster completo. Caso a imagem original tenha transparência, mantenha os valores alfa em um buffer paralelo e restaure-os na codificação, pois este contrato transforma somente vermelho, verde e azul.

O branco claro confirma que os três resultados são limitados a 255. Cores puras revelam mudanças acidentais nos coeficientes ou na ordem dos canais, e tons neutros mostram a separação quente característica. Considere falhas de validação como problemas na decodificação ou construção da solicitação, e não como erros transitórios para repetir sem alterações.

Corrija canais ausentes, valores fora do intervalo ou NaN antes de reenviar.