Funzione ColorMatchToTarget (wingdi.h)

  • Articolo

La funzione ColorMatchToTarget consente di visualizzare in anteprima i colori quando vengono visualizzati nel dispositivo di destinazione.

Sintassi

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Parametri

hdc

Specifica il contesto del dispositivo per l'anteprima, in genere lo schermo.

hdcTarget

Specifica il contesto del dispositivo di destinazione, in genere una stampante.

action

Costante che può avere uno dei valori seguenti.

 

Valore Significato
CS_ENABLE
 Eseguire il mapping dei colori alla gamma di colori del dispositivo di destinazione. In questo modo viene attivata la correzione dei colori. Tutti i comandi di disegno successivi al controller di dominio eseguiranno il rendering dei colori in quanto verranno visualizzati nel dispositivo di destinazione.
CS_DISABLE
 Disabilitare la correzione dei colori.
CS_DELETE_TRANSFORM
 Se la gestione dei colori è abilitata per il profilo di destinazione, disabilitarla ed eliminare la trasformazione concatenata.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE.

Commenti

ColorMatchToTarget può essere usato per verificare i colori di un dispositivo di output dei colori in un altro dispositivo di output dei colori. Se si imposta il parametro uiAction su CS_ENABLE, tutti i comandi di disegno successivi vengono visualizzati nel controller di dominio per eseguire il rendering dei colori quando vengono visualizzati nel dispositivo di destinazione. Se uiAction è impostato su CS_DISABLE, la correzione viene disattivata. Tuttavia, la trasformazione del colore corrente non viene eliminata dal controller di dominio. È solo inattivo.

Quando colorMatchToTarget viene chiamato, la trasformazione del colore per il dispositivo di destinazione viene eseguita prima e quindi la trasformazione nel dispositivo di anteprima viene applicata ai risultati della prima trasformazione. Questa operazione viene usata principalmente per controllare le condizioni di mapping di gamut. Prima di usare questa funzione, è necessario abilitare WCS per entrambi i contesti del dispositivo.

Questa funzione non può essere a cascata. Mentre il mapping dei colori alla destinazione è abilitato impostando uiAction su CS_ENABLE, le modifiche dell'applicazione allo spazio dei colori o al metodo di mapping di gamut vengono ignorate. Queste modifiche diventano quindi effettive quando il mapping dei colori alla destinazione è disabilitato.

Nota Una perdita di memoria non si verificherà se un'applicazione non elimina una trasformazione usando CS_DELETE_TRANSFORM. La trasformazione verrà eliminata quando il contesto del dispositivo (DC) viene chiuso o quando viene eliminato lo spazio dei colori dell'applicazione. Tuttavia, se la trasformazione non verrà usata di nuovo o se l'applicazione non eseguirà più corrispondenze di colore nel controller di dominio, dovrebbe eliminare in modo esplicito la trasformazione per liberare la memoria occupata dall'applicazione.
 
Il parametro uiAction deve essere impostato solo su CS_DELETE_TRANSFORM se la gestione dei colori è abilitata prima che venga chiamata la funzione ColorMatchToTarget .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche