Applichi un filtro seppia ai pixel RGB di un’immagine

Applichi un filtro seppia ai pixel di un’immagine già decodificata senza caricare un file né dipendere da un codec. Fornisca un elenco ordinato di campioni RGB e riceva i campioni corrispondenti in calde tonalità brune, calcolati con la matrice di trasformazione seppia standard. Ogni canale trasformato viene arrotondato e limitato all’intervallo valido da zero a 255. La convalida completa impedisce che pixel incompleti o errati modifichino il risultato senza avvisi, mentre l’elaborazione deterministica rende il convertitore adatto a pipeline di produzione, controlli nel browser, formazione e test automatici esatti.

Prepari campioni completi di pixel RGB

Inserisca i pixel decodificati nel campo samples come elenco non vuoto di oggetti. Ogni oggetto deve contenere i canali r, g e b, e ciascun canale deve essere un valore numerico finito compreso fra zero e 255 inclusi. Gli interi sono convenzionali, ma sono accettati valori frazionari perché alcune pipeline generano campioni intermedi in virgola mobile prima della codifica finale.

Il convertitore verifica ogni record e non presume mai che un componente mancante valga zero. Mantenga l’ordine raster, poiché l’output conserva esattamente l’ordine dell’input. Una richiesta accetta fino a centomila record.

Divida raster più grandi in blocchi di dimensione fissa e concateni le risposte nello stesso ordine. La capacità elabora campioni RGB, non byte PNG, JPEG, AVIF o WebP. Decodifichi prima il file e conservi separatamente larghezza, altezza, passo di riga, orientamento e canale alfa.

Comprenda la trasformazione seppia standard

Ogni pixel di output deriva da tre somme ponderate. Il rosso è 0.393 per r più 0.769 per g più 0.189 per b. Il verde usa 0.349 per r più 0.686 per g più 0.168 per b.

Il blu usa 0.272 per r più 0.534 per g più 0.131 per b. Questa nota matrice seppia modifica sia la luminanza sia l’equilibrio dei canali, produce alte luci dominate da rossi e verdi caldi e riduce il blu. Il convertitore arrotonda ogni somma all’intero più vicino e poi la limita all’intervallo inclusivo da zero a 255.

Il limite è necessario perché le righe della matrice possono generare valori superiori a 255 nei pixel chiari. Senza questo controllo, un successivo buffer di byte potrebbe traboccare, rifiutare il valore o mostrare un colore inatteso. La risposta include matrice, campioni convertiti e conteggio, così registri e test possono indicare esattamente la trasformazione usata.

L’elaborazione è pura e deterministica: non usa rete, modelli, casualità, ora corrente, profili colore nascosti o cache mutabili. Non linearizza RGB corretto con gamma, non interpreta profili ICC, non simula pellicola chimica, non aggiunge grana, non conserva la trasparenza e non miscela il risultato con l’originale.

Integri e verifichi il risultato convertito

Usi l’elenco samples restituito come sostituzione posizionale dell’elenco RGB inviato. Il campo count deve coincidere con il numero di record di input; li confronti prima di ricostruire una tessera, una riga, una miniatura, un buffer canvas o un raster completo. Se l’immagine originale contiene trasparenza, conservi i valori alfa in un buffer parallelo e li ripristini durante la codifica, perché questo contratto trasforma soltanto rosso, verde e blu.

Il bianco brillante verifica che tutti i risultati siano limitati a 255. I colori puri rivelano modifiche accidentali ai coefficienti o all’ordine dei canali. Tratti gli errori di convalida come problemi di decodifica o costruzione della richiesta, non come guasti temporanei da riprovare senza modifiche.

Corregga canali assenti, valori fuori intervallo o NaN prima di inviare nuovamente.