Appliquez un filtre sépia aux pixels RGB d’une image

Appliquez un filtre sépia à des pixels d’image déjà décodés sans transférer de fichier ni dépendre d’un codec. Fournissez une liste ordonnée d’échantillons RGB et recevez les échantillons correspondants dans des tons bruns chaleureux, calculés avec la matrice de transformation sépia standard. Chaque canal transformé est arrondi puis borné dans l’intervalle valide de zéro à 255. Une validation complète empêche les pixels incomplets ou incorrects de modifier silencieusement le résultat, tandis que le traitement déterministe convient aux chaînes de production, contrôles dans le navigateur, formations et tests automatisés exacts.

Préparez des échantillons RGB complets

Placez les pixels décodés dans le champ samples sous forme de liste non vide d’objets. Chaque objet doit contenir les canaux r, g et b, chacun étant une valeur numérique finie comprise entre zéro et 255 inclus. Les entiers sont habituels, mais les valeurs fractionnaires sont acceptées, car certaines chaînes d’image produisent des échantillons intermédiaires en virgule flottante avant l’encodage final.

Le convertisseur vérifie chaque enregistrement et ne considère jamais qu’un composant absent vaut zéro. Cette rigueur protège la structure de l’image : ignorer un enregistrement décalerait tous les pixels suivants, tandis que remplacer une valeur inventerait une information de couleur. Conservez l’ordre du raster, car la sortie reproduit exactement l’ordre d’entrée.

Une requête accepte jusqu’à cent mille enregistrements. Découpez les rasters plus grands en blocs de taille fixe, puis concaténez les réponses dans le même ordre. Cette capacité traite des échantillons RGB, pas des octets PNG, JPEG, AVIF ou WebP.

Décodez d’abord le fichier et conservez séparément largeur, hauteur, pas de ligne, orientation et canal alpha.

Comprenez la transformation sépia standard

Chaque pixel de sortie provient de trois sommes pondérées. Le rouge vaut 0.393 fois r plus 0.769 fois g plus 0.189 fois b. Le vert emploie 0.349 fois r plus 0.686 fois g plus 0.168 fois b.

Le bleu emploie 0.272 fois r plus 0.534 fois g plus 0.131 fois b. Cette matrice sépia courante modifie la luminance et l’équilibre des canaux, produit des hautes lumières dominées par des rouges et verts chauds, et atténue le bleu. Le convertisseur arrondit chaque somme à l’entier le plus proche, puis la borne dans l’intervalle inclusif de zéro à 255.

Ce bornage est indispensable, car les lignes de la matrice peuvent dépasser 255 pour des pixels clairs. Sans lui, un tampon d’octets ultérieur pourrait déborder, refuser la valeur ou afficher une couleur inattendue. La réponse contient la matrice, les échantillons convertis et leur nombre afin que journaux et tests précisent la transformation employée.

Le calcul est pur et déterministe : aucun réseau, modèle, hasard, horaire actuel, profil colorimétrique caché ou cache mutable. Il ne linéarise pas le RGB corrigé par gamma, n’interprète pas les profils ICC, ne simule pas une pellicule, n’ajoute pas de grain, ne préserve pas la transparence et ne mélange pas le résultat avec l’original.

Intégrez et contrôlez le résultat converti

Utilisez la liste samples renvoyée comme remplacement positionnel de la liste RGB transmise. Le champ count doit être égal au nombre d’enregistrements d’entrée ; comparez-les avant de reconstruire une tuile, une ligne, une miniature, un tampon de canevas ou un raster complet. Si l’image originale contient de la transparence, gardez ses valeurs alpha dans un tampon parallèle et restaurez-les à l’encodage, car ce contrat transforme uniquement le rouge, le vert et le bleu.

Un bon jeu de régression comprend le noir, le blanc, un gris neutre, les trois couleurs primaires pures, une valeur fractionnaire et un enregistrement incomplet qui doit échouer. Le blanc vérifie le bornage des trois résultats à 255. Les couleurs pures révèlent une modification accidentelle des coefficients ou de l’ordre des canaux.

Considérez les erreurs de validation comme des défauts du décodage ou de la construction de requête, et non comme des incidents temporaires à réessayer sans changement. Corrigez les canaux absents, valeurs hors plage ou NaN avant un nouvel envoi.