CheckColorsInGamut-Funktion (wingdi.h)
Die CheckColorsInGamut-Funktion bestimmt, ob ein angegebener Satz von RGB-Triples im Ausgabeumfang eines angegebenen Geräts liegt. Die RGB-Dreifache werden im logischen Farbraum der Eingabe interpretiert.
Syntax
BOOL CheckColorsInGamut(
HDC hdc,
LPRGBTRIPLE lpRGBTriple,
LPVOID dlpBuffer,
DWORD nCount
);
Parameter
hdc
Handle für den Gerätekontext, dessen Ausgabeumfang überprüft werden soll.
lpRGBTriple
Zeiger auf ein Zu überprüfende Array von RGB-Dreifachen.
dlpBuffer
Zeiger auf den Puffer, in dem die Ergebnisse platziert werden sollen. Dieser Puffer muss mindestens so groß wie nCount Bytes sein.
nCount
Die Anzahl der Elemente im Array von Dreifachen.
Rückgabewert
Wenn diese Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn diese Funktion fehlschlägt, ist der Rückgabewert null.
Hinweise
Die Funktion platziert die Testergebnisse im Puffer, auf den lpBuffer verweist. Jedes Byte im Puffer entspricht einem RGB-Triple und hat einen Wert ohne Vorzeichen zwischen CM_IN_GAMUT (= 0) und CM_OUT_OF_GAMUT (= 255). Der Wert 0 gibt an, dass sich die Farbe im Gamut befindet, während ein Wert ungleich null angibt, dass sie sich außerhalb des Farbraums befindet. Für alle ganzzahligen Werte n , die 0 <n< 255 aufweisen, gibt der Ergebniswert n + 1 an, dass die entsprechende Farbe mindestens so weit außerhalb des Farbraums liegt, wie durch den Ergebniswert n angegeben wird, wie in der ICC-Profilformatspezifikation angegeben. Weitere Informationen zur ICC-Profilformatspezifikation finden Sie in den Quellen, die unter Weitere Informationen aufgeführt sind.
Beachten Sie, dass WCS für das Gerätekontexthandle aktiviert sein muss, das über den hDC-Parameter übergeben wird, damit diese Funktion erfolgreich ist. WCS kann für ein Gerätekontexthandle aktiviert werden, indem die SetICMMode-Funktion aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |