TranslateBitmapBits-Funktion (icm.h)

Artikel
03/01/2024

Übersetzt die Farben einer Bitmap mit einem definierten Format, um eine weitere Bitmap in einem angeforderten Format zu erzeugen.

Syntax

BOOL TranslateBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwInputStride,
  PVOID         pDestBits,
  BMFORMAT      bmOutput,
  DWORD         dwOutputStride,
  PBMCALLBACKFN pfnCallBack,
  LPARAM        ulCallbackData
);

Parameter

hColorTransform

Gibt die zu verwendende Farbtransformation an.

pSrcBits

Zeiger auf die zu übersetzende Bitmap.

bmInput

Gibt das Format der Eingabebitbitbit an. Muss auf einen der Werte des aufgezählten BMFORMAT-Typs festgelegt werden.

Hinweis

Diese Funktion unterstützt keine BM_XYZTRIPLETS oder BM_YxyTRIPLETS als Eingaben.

dwWidth

Gibt die Anzahl von Pixeln pro Scanzeile in der Eingabe-Bitmap an.

dwHeight

Gibt die Anzahl der Scanzeilen in der Eingabebitbit an.

dwInputStride

Gibt die Anzahl der Bytes vom Anfang einer Scanzeile bis zum Anfang der nächsten in der Eingabe-Bitmap an. wenn sie auf null festgelegt ist, geht die Funktion davon aus, dass die Scanzeilen gepolstert sind, um DWORD-ausgerichtet zu sein.

pDestBits

Zeiger auf den Puffer, in dem die übersetzte Bitmap platziert werden soll.

bmOutput

Gibt das Format der Ausgabebitbitbit an. Muss auf einen der Werte des aufgezählten BMFORMAT-Typs festgelegt werden.

dwOutputStride

Gibt die Anzahl der Bytes vom Anfang einer Scanzeile bis zum Anfang der nächsten in der Ausgabe-Bitmap an. wenn sie auf 0 festgelegt ist, geht die Funktion davon aus, dass die Scanzeilen mit DWORD-Ausrichtung gepolstert werden sollten.

pfnCallBack

Zeiger auf eine Rückruffunktion, die von TranslateBitmapBits regelmäßig aufgerufen wird, um den Fortschritt zu melden und dem aufrufenden Prozess das Abbrechen der Übersetzung zu ermöglichen. (Siehe ICMProgressProcCallback )

ulCallbackData

Daten, die an die Rückruffunktion zurückgegeben werden, z. B. zur Identifizierung der Übersetzung, die den Fortschritt meldet.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn die Eingabe- und Ausgabeformate nicht mit der Farbtransformation kompatibel sind, schlägt diese Funktion fehl.

Wenn eines der Gleitkomma-BMFORMATs, BM_32b_scARGB oder BM_32b_scRGB verwendet wird, sollten die zu übersetzenden Farbdaten weder NaN noch Unendlich enthalten. NaN und Unendlichkeit werden nicht als legitime Farbkomponentenwerte betrachtet, und das Ergebnis der Übersetzung von Pixeln, die NaN oder Unendlich enthalten, ist farblich bedeutungslos. NaN- oder Infinity-Werte in den verarbeiteten Farbdaten werden unbeaufsichtigt behandelt, und ein Fehler wird nicht zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h
Bibliothek	Mscms.lib
DLL	Mscms.dll

Freigeben über