ForHosting KIT · Immagini e foto

Regolare la temperatura colore

Questo calcolatore trasforma i valori medi rosso, verde e blu di un’immagine e uno spostamento Kelvin in tre moltiplicatori di canale.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Stima la temperatura colore correlata, applica la variazione calda o fredda richiesta e restituisce guadagni RGB normalizzati. Lei può usarli in un flusso colore a luce lineare per ottenere un bilanciamento del bianco riproducibile senza caricare l’immagine. Il calcolo è deterministico e ogni richiesta API costa $0.002.

Prepari un valore RGB medio rappresentativo

Inizi dalla media aritmetica di ciascun canale sRGB a 8 bit nei pixel che devono rappresentare la correzione. Inserisca avg_r, avg_g e avg_b nella scala da 0 a 255. La media dell’intera immagine è adatta a fotografie illuminate uniformemente, lotti di prodotti, miniature e anteprime automatiche. Se però il soggetto ha un colore dominante, la media di una zona neutra può descrivere l’illuminazione meglio dell’intero fotogramma. Una parete rossa o un oceano blu può dominare la media globale anche quando il bilanciamento del bianco è già corretto. Il calcolatore non esamina i pixel, non identifica oggetti neutri e non separa la luce dal colore del soggetto: usa esattamente il riepilogo fornito. Una media totalmente nera viene rifiutata perché non contiene cromaticità utile a stimare la temperatura. Sono respinti anche numeri non finiti e valori esterni all’intervallo a 8 bit. Mantenga invariato il metodo di campionamento in tutto il lotto per ottenere correzioni confrontabili.

Scelga lo spostamento Kelvin e comprenda il modello

Inserisca shift_kelvin come variazione relativa, non come destinazione assoluta. Un valore positivo aumenta la temperatura stimata e genera una correzione più fredda; uno negativo la riduce e genera una correzione più calda. Sono ammessi spostamenti da -10,000 a 10,000 Kelvin e il risultato deve restare tra 1,000 e 40,000 Kelvin. Il calcolo linearizza i canali sRGB medi, li converte nella cromaticità CIE XYZ e stima la temperatura correlata con l’approssimazione cubica di McCamy. Valuta poi curve RGB deterministiche di corpo nero alle temperature stimata e finale. Il rapporto tra i due punti di bianco diventa un insieme di guadagni normalizzati affinché il verde sia uno. È un’approssimazione tecnica, non una misura spettrale. La temperatura correlata è più significativa vicino al luogo planckiano, quindi una media molto satura offre solo una stima orientativa. Il metodo e le temperature restituiti rendono esplicita questa ipotesi e permettono di documentare ogni serie di guadagni.

Applichi i moltiplicatori senza danneggiare l’immagine

Applichi red_multiplier, green_multiplier e blue_multiplier ai valori RGB in luce lineare, non direttamente ai numeri di canale a 8 bit codificati con gamma. Un flusso affidabile decodifica sRGB in luce lineare, moltiplica ogni canale per il relativo guadagno, gestisce i valori oltre la gamma visibile con esposizione o mappatura tonale e ricodifica in sRGB. Moltiplicare direttamente i byte può sembrare accettabile per piccoli cambiamenti, ma non conserva la relazione corretta tra luce e valori registrati. Il verde è normalizzato a uno, quindi il risultato esprime il bilanciamento cromatico e non una variazione generale dell’esposizione. Rosso o blu possono superare uno e causare ritagli nelle alte luci; elabori in virgola mobile o con profondità sufficiente prima dell’esportazione. Verifichi immagini rappresentative prima di trattare una raccolta, soprattutto se la media deriva da scene colorate. L’API costa $0.002 per richiesta, mentre il calcolatore web esegue localmente la stessa operazione deterministica.

Uniformare un lotto di foto prodotto

Calcoli guadagni ripetibili con lo stesso campionamento prima di esportare le immagini del catalogo.

Prototipare un controllo del bianco

Trasformi il movimento di un selettore Kelvin in moltiplicatori RGB espliciti per un editor web o desktop.

Registrare correzioni riproducibili

Salvi temperature stimata e finale e guadagni accanto alla risorsa in un flusso multimediale automatico.

Che cosa produce uno spostamento Kelvin positivo?

Aumenta la temperatura finale stimata e genera una correzione più fredda, con più blu e meno rosso in proporzione.

Quale intervallo di spostamento è ammesso?

La variazione deve essere tra -10,000 e 10,000 Kelvin inclusi e il risultato tra 1,000 e 40,000 Kelvin.

Perché il moltiplicatore verde è sempre uno?

I guadagni sono normalizzati sul verde per esprimere il bilanciamento cromatico separatamente dall’esposizione.

Devo moltiplicare direttamente valori RGB a 8 bit?

No. Decodifichi sRGB in luce lineare, applichi i guadagni, gestisca le alte luci e ricodifichi in sRGB.

Quanto è precisa la temperatura stimata?

È un’approssimazione basata sulla cromaticità media, più affidabile con illuminazione neutra che con soggetti molto saturi.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. La versione web esegue gratuitamente lo stesso calcolo deterministico sul dispositivo.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/image/color-temperature-adjust

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/image/color-temperature-adjust \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"avg_r":142,"avg_g":128,"avg_b":110,"shift_kelvin":1200}'
{
  "avg_r": 142,
  "avg_g": 128,
  "avg_b": 110,
  "shift_kelvin": 1200
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.color_temperature_adjust",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

min_shift_kelvin-10000
max_shift_kelvin10000
min_temperature_kelvin1000
max_temperature_kelvin40000
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →