Struttura COLORADJUSTMENT (wingdi.h)

Articolo
08/27/2023

La struttura COLORADJUSTMENT definisce i valori di regolazione dei colori utilizzati dalle funzioni StretchBlt e StretchDIBits quando la modalità di estensione è HALFTONE. È possibile impostare i valori di regolazione dei colori chiamando la funzione SetColorAdjustment .

Sintassi

typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT, *LPCOLORADJUSTMENT;

Members

caSize

Dimensione, in byte, della struttura.

caFlags

Specifica la modalità di preparazione dell'immagine di output. Questo membro può essere impostato su NULL o su qualsiasi combinazione dei valori seguenti.

Valore	Significato
CA_NEGATIVE	Specifica che deve essere visualizzato il valore negativo dell'immagine originale.
CA_LOG_FILTER	Specifica che una funzione logaritmica deve essere applicata alla densità finale dei colori di output. Ciò aumenterà il contrasto del colore quando la luminanza è bassa.

caIlluminantIndex

Tipo di sorgente luminosa standard in cui viene visualizzata l'immagine. Questo membro può essere impostato su uno dei valori seguenti.

Valore	Significato
ILLUMINANT_DEVICE_DEFAULT	Impostazione predefinita del dispositivo. Standard usato dai dispositivi di output.
ILLUMINANT_A	Lampada Di Tipo.
ILLUMINANT_B	Sole di mezzogiorno.
ILLUMINANT_C	NTSC giorno.
ILLUMINANT_D50	Stampa normale.
ILLUMINANT_D55	Stampa carta bond.
ILLUMINANT_D65	Luce solare standard. Standard per CTS e immagini.
ILLUMINANT_D75	Giorno settentrionale.
ILLUMINANT_F2	Lampada bianca fredda.
ILLUMINANT_TUNGSTEN	Uguale a ILLUMINANT_A.
ILLUMINANT_DAYLIGHT	Uguale a ILLUMINANT_C.
ILLUMINANT_FLUORESCENT	Uguale a ILLUMINANT_F2.
ILLUMINANT_NTSC	Uguale a ILLUMINANT_C.

caRedGamma

Specifica il n valore^{di correzione} gamma di alimentazione per il primario rosso dei colori di origine. Il valore deve essere compreso nell'intervallo compreso tra 2500 e 65.000. Un valore pari a 10.000 indica che non è prevista alcuna correzione gamma.

caGreenGamma

Specifica il n° valore di correzione gamma di alimentazione per la primaria verde dei colori di origine. Il valore deve essere compreso nell'intervallo compreso tra 2500 e 65.000. Un valore pari a 10.000 indica che non è prevista alcuna correzione gamma.

caBlueGamma

Specifica il n valore^{di correzione} gamma di alimentazione per la primaria blu dei colori di origine. Il valore deve essere compreso nell'intervallo compreso tra 2500 e 65.000. Un valore pari a 10.000 indica che non è prevista alcuna correzione gamma.

caReferenceBlack

Riferimento nero per i colori di origine. Tutti i colori più scuri di questo vengono trattati come neri. Il valore deve essere compreso nell'intervallo compreso tra 0 e 4000.

caReferenceWhite

Riferimento bianco per i colori di origine. Tutti i colori più chiari di questo vengono trattati come bianchi. Il valore deve essere compreso nell'intervallo compreso tra 6000 e 10.000.

caContrast

Quantità di contrasto da applicare all'oggetto di origine. Il valore deve essere compreso nell'intervallo compreso tra -100 e 100. Il valore 0 non indica alcuna regolazione del contrasto.

caBrightness

Quantità di luminosità da applicare all'oggetto di origine. Il valore deve essere compreso nell'intervallo compreso tra -100 e 100. Il valore 0 indica che non viene eseguita alcuna regolazione della luminosità.

caColorfulness

Quantità di colori da applicare all'oggetto di origine. Il valore deve essere compreso nell'intervallo compreso tra -100 e 100. Un valore pari a 0 non indica alcuna regolazione del colore.

caRedGreenTint

Quantità di regolazione della tinta rossa o verde da applicare all'oggetto di origine. Il valore deve essere compreso nell'intervallo compreso tra -100 e 100. I numeri positivi si adattano verso i numeri rossi e negativi si adattano verso il verde. Zero significa che nessuna regolazione della tinta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	wingdi.h (include Windows.h)