Funzione TranslateBitmapBits (icm.h)

  • Articolo

Converte i colori di una bitmap con un formato definito in modo da produrre un'altra bitmap in un formato richiesto.

Sintassi

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

Parametri

hColorTransform

Identifica la trasformazione del colore da utilizzare.

pSrcBits

Puntatore alla bitmap da convertire.

bmInput

Specifica il formato della bitmap di input. Deve essere impostato su uno dei valori del tipo enumerato BMFORMAT .

Nota

Questa funzione non supporta BM_XYZTRIPLETS o BM_YxyTRIPLETS come input.

dwWidth

Specifica il numero di pixel per riga di analisi nella bitmap di input.

dwHeight

Specifica il numero di righe di analisi nella bitmap di input.

dwInputStride

Specifica il numero di byte dall'inizio di una riga di analisi all'inizio della bitmap di input successiva; se impostato su zero, la funzione presuppone che le righe di analisi siano riempite in modo da essere allineate con DWORD.

pDestBits

Puntatore al buffer in cui posizionare la bitmap tradotta.

bmOutput

Specifica il formato della bitmap di output. Deve essere impostato su uno dei valori del tipo enumerato BMFORMAT .

dwOutputStride

Specifica il numero di byte dall'inizio di una riga di analisi all'inizio della bitmap di output successiva; se impostato su zero, la funzione presuppone che le righe di analisi debbano essere riempite in modo da essere allineate con DWORD.

pfnCallBack

Puntatore a una funzione di callback chiamata periodicamente da TranslateBitmapBits per segnalare lo stato di avanzamento e consentire al processo chiamante di annullare la traduzione. (Vedere ICMProgressProcCallback )

ulCallbackData

I dati passati alla funzione di callback, ad esempio, per identificare la traduzione che segnala lo stato di avanzamento.

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

Commenti

Se i formati di input e output non sono compatibili con la trasformazione del colore, questa funzione ha esito negativo.

Quando vengono utilizzati BMFORMAT a virgola mobile, vengono utilizzati BM_32b_scARGB o BM_32b_scRGB, i dati di colore tradotti non devono contenere NaN o infinity. NaN e infinity non sono considerati come valori legittimi dei componenti di colore e il risultato della conversione di pixel contenenti NaN o infinito non è significativo in termini di colore. I valori NaN o infinito nei dati di colore elaborati verranno gestiti automaticamente e non verrà restituito un errore.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche