Aplique un filtro sepia a píxeles RGB de imagen

Aplique un filtro sepia a píxeles de imagen ya decodificados sin cargar un archivo ni depender de un códec. Envíe una matriz ordenada de muestras RGB y reciba las muestras correspondientes en tonos marrones cálidos, calculadas con la matriz de transformación sepia estándar. Cada canal resultante se redondea y se limita al intervalo válido de cero a 255. La validación completa evita que píxeles incompletos o incorrectos alteren el resultado de forma silenciosa, y el procesamiento determinista permite usar el conversor en producción, pruebas del navegador, formación y tests automatizados exactos.

Prepare muestras completas de píxeles RGB

Coloque los píxeles decodificados en el campo samples como una matriz no vacía de objetos. Cada objeto debe contener los canales r, g y b, y cada canal debe ser un valor numérico finito entre cero y 255, ambos incluidos. Aunque lo habitual son enteros, se admiten fracciones porque algunos flujos de imagen generan muestras intermedias de coma flotante antes de codificarlas.

El conversor verifica cada registro y nunca interpreta un componente ausente como cero. Este criterio estricto protege la estructura de la imagen: omitir un registro desplazaría todos los píxeles posteriores, mientras que sustituir un valor inventaría información de color. Mantenga el orden del ráster, ya que la salida conserva exactamente el orden de entrada.

Para imágenes mayores, divida el ráster en bloques de tamaño fijo y vuelva a unir las respuestas en el mismo orden. La capacidad trabaja con muestras RGB, no con bytes PNG, JPEG, AVIF o WebP. Decodifique primero el archivo y conserve aparte la anchura, altura, orientación, paso de fila y canal alfa.

Comprenda la transformación sepia estándar

Cada píxel de salida procede de tres sumas ponderadas. El rojo se calcula como 0.393 por r más 0.769 por g más 0.189 por b. El verde usa 0.349 por r más 0.686 por g más 0.168 por b.

El azul emplea 0.272 por r más 0.534 por g más 0.131 por b. Esta conocida matriz sepia modifica tanto la luminancia como el equilibrio de canales, crea luces dominadas por rojos y verdes cálidos y reduce el azul. El conversor redondea cada suma al entero más próximo y luego la limita al intervalo inclusivo de cero a 255.

La limitación es necesaria porque las filas de la matriz pueden producir valores superiores a 255 en píxeles claros. Sin ella, un búfer de bytes posterior podría desbordarse, rechazar el valor o mostrar otro color. La respuesta incluye la matriz, las muestras transformadas y el recuento para que registros y pruebas indiquen exactamente qué transformación se utilizó.

El proceso es puro y determinista: no usa red, modelos, azar, hora actual, perfiles de color ocultos ni caché mutable. No linealiza RGB con gamma, interpreta perfiles ICC, simula película química, añade grano, conserva transparencia ni mezcla la salida con el original.

Integre y verifique el resultado convertido

Interprete la matriz samples devuelta como sustitución posicional de la matriz RGB enviada. El campo count debe coincidir con el número de registros de entrada; compárelo antes de reconstruir una tesela, línea, miniatura, búfer de lienzo o ráster completo. Si la imagen original tiene transparencia, conserve sus valores alfa en un búfer paralelo y restáurelos al codificar, porque este contrato solo transforma rojo, verde y azul.

Un buen conjunto de regresión incluye negro, blanco, gris neutro, rojo puro, verde puro, azul puro, una muestra fraccionaria y un registro incompleto que deba fallar. El blanco brillante comprueba que los tres resultados se limitan a 255. Los colores puros revelan cambios accidentales de coeficientes u orden, y los neutros muestran la separación cálida característica.

Trate los errores de validación como problemas de decodificación o construcción de la solicitud, no como fallos transitorios que deban reintentarse sin cambios. Corrija los canales ausentes, valores fuera de rango o NaN antes de reenviar.