ForHosting KIT · Strumenti per sviluppatori

Convertitore da XYZ a xyY

Il convertitore da XYZ a xyY trasforma tre valori tristimolo CIE in due coordinate di cromaticità e in un valore separato di luminanza.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Lei può così confrontare il colore indipendentemente dalla luminosità, conservando il componente Y originale nei flussi sensibili alla luminanza. Inserisca X, Y e Z non negativi su una scala coerente: lo strumento valida i dati, rifiuta la cromaticità indefinita del nero e restituisce risultati numerici stabili mediante le equazioni CIE standard.

Comprendere cosa cambia tra XYZ e xyY

CIE XYZ rappresenta uno stimolo con tre valori tristimolo, ma unisce la loro grandezza e i rispettivi rapporti. La rappresentazione xyY separa questi concetti. Le coordinate x e y minuscole descrivono la cromaticità, ossia, in termini generali, il colore senza l’intensità complessiva. La Y maiuscola conserva il componente tristimolo originale legato alla luminanza. Questa separazione è utile quando Lei deve collocare colori su un diagramma di cromaticità CIE 1931, confrontare misure effettuate a livelli di luminosità diversi oppure memorizzare la luminanza insieme a una coppia compatta di coordinate. La conversione non applica adattamento del punto di bianco, curva gamma, matrice RGB o correzione percettiva; normalizza esclusivamente i valori XYZ forniti. Di conseguenza, osservatore, illuminante, condizioni di misura e scala XYZ restano responsabilità del flusso colorimetrico circostante. Convertire in xyY due terne prodotte in condizioni di riferimento diverse non rende equivalenti tali condizioni. Utilizzi valori appartenenti allo stesso contesto colorimetrico previsto e interpreti le coordinate restituite in quel contesto.

Come funziona il calcolo deterministico

Il convertitore verifica innanzitutto che X, Y e Z siano numeri finiti e non negativi. Calcola quindi la somma X + Y + Z. La x minuscola è X diviso tale somma, mentre la y minuscola è Y diviso lo stesso denominatore. La Y maiuscola del risultato viene copiata dall’ingresso senza normalizzazione, conservando la grandezza collegata alla luminanza e la scala originale. Poiché le due coordinate condividono il denominatore, x e y non dipendono dalla scala: moltiplicando i tre valori XYZ per lo stesso fattore positivo, x e y restano invariate, mentre Y viene moltiplicata per tale fattore. I risultati sono arrotondati a una precisione significativa stabile, così esecuzioni ripetute producono valori JSON coerenti. Il calcolo non usa rete, casualità, orologio, tabelle di ricerca o profili colore locali. La terna X = 0, Y = 0, Z = 0 viene rifiutata perché il denominatore è zero e uno stimolo perfettamente scuro non possiede una cromaticità definita. Sono rifiutate anche somme che superano l’intervallo numerico finito.

Preparare gli ingressi e interpretare l’uscita

Usi una sola scala coerente per tutti e tre gli ingressi. XYZ viene spesso espresso con un bianco di riferimento vicino a Y = 100, ma sono ugualmente validi valori normalizzati prossimi a Y = 1; il convertitore non presume nessuna convenzione. La Y maiuscola restituita rimane sulla scala da Lei fornita. Le x e y minuscole sono rapporti e quindi non hanno unità. Con ingressi XYZ validi e non negativi, ogni coordinata è compresa tra zero e uno e x + y non supera uno; la terza coordinata implicita è z = 1 - x - y, se necessaria per un’elaborazione successiva. Non confonda y con Y: la prima è una coordinata di cromaticità normalizzata, la seconda è il valore tristimolo originale legato alla luminanza. Ricordi inoltre che xyY non è percettivamente uniforme: distanze geometriche uguali su un diagramma xy non corrispondono necessariamente a differenze visive uguali. Usi la conversione per scambio standardizzato, grafici, strumentazione o calcoli intermedi. Per misurare differenze percettive, prosegua in uno spazio adeguato come CIELAB dopo aver applicato le necessarie regole di adattamento e del bianco di riferimento.

Tracciare un colore misurato

Converta l’uscita XYZ di uno spettrofotometro in coordinate x e y per un diagramma CIE 1931, mantenendo la luminanza.

Confrontare la cromaticità a luminosità diverse

Normalizzi misure XYZ scalate proporzionalmente per confrontarne le coordinate di cromaticità separatamente da Y.

Preparare dati colorimetrici

Trasformi record XYZ nella rappresentazione xyY richiesta da software per illuminazione, display, imaging o calibrazione.

Quanto costa la conversione?

Il prezzo dell’API è $0.002 per richiesta. La versione eseguita nel browser è gratuita.

Quale scala XYZ devo usare?

Qualsiasi scala coerente è valida. Usi la stessa per X, Y e Z; la Y maiuscola dell’uscita conserva tale scala.

Perché un ingresso XYZ completamente nullo viene rifiutato?

Le formule dividono per X + Y + Z. Per uno stimolo interamente nullo, la somma è zero e la cromaticità non è definita matematicamente.

Il convertitore esegue l’adattamento cromatico?

No. Normalizza soltanto XYZ in coordinate xy e conserva Y; non modifica i punti di bianco né le condizioni dell’osservatore.

Perché y minuscola e Y maiuscola sono diverse?

La y minuscola è un rapporto di cromaticità senza unità. La Y maiuscola è il componente XYZ originale collegato alla luminanza.

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/color/xyz-xyy

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/color/xyz-xyy \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x_value":41.24,"y_value":21.26,"z_value":1.93}'
{
  "x_value": 41.24,
  "y_value": 21.26,
  "z_value": 1.93
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.xyz_xyy",
  "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.

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 →