Compartilhar via


Função TranslateBitmapBits (icm.h)

Converte as cores de um bitmap com um formato definido para produzir outro bitmap em um formato solicitado.

Sintaxe

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

Parâmetros

hColorTransform

Identifica a transformação de cores a ser usada.

pSrcBits

Ponteiro para o bitmap a ser convertido.

bmInput

Especifica o formato do bitmap de entrada. Deve ser definido como um dos valores do tipo enumerado BMFORMAT .

Observação

Essa função não dá suporte a BM_XYZTRIPLETS ou BM_YxyTRIPLETS como entradas.

dwWidth

Especifica o número de pixels por linha de verificação no bitmap de entrada.

dwHeight

Especifica o número de linhas de verificação no bitmap de entrada.

dwInputStride

Especifica o número de bytes desde o início de uma linha de verificação até o início do próximo no bitmap de entrada; se definido como zero, a função pressupõe que as linhas de verificação sejam preenchidas para que sejam alinhadas com DWORD.

pDestBits

Ponteiro para o buffer no qual colocar o bitmap traduzido.

bmOutput

Especifica o formato do bitmap de saída. Deve ser definido como um dos valores do tipo enumerado BMFORMAT .

dwOutputStride

Especifica o número de bytes desde o início de uma linha de verificação até o início do próximo no bitmap de saída; se definido como zero, a função pressupõe que as linhas de verificação devem ser preenchidas para serem alinhadas a DWORD.

pfnCallBack

Ponteiro para uma função de retorno de chamada chamada chamada periodicamente por TranslateBitmapBits para relatar o progresso e permitir que o processo de chamada cancele a tradução. (Consulte ICMProgressProcCallback )

ulCallbackData

Os dados passados de volta para a função de retorno de chamada, por exemplo, para identificar a tradução que está relatando o progresso.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se os formatos de entrada e saída não forem compatíveis com a transformação de cores, essa função falhará.

Quando um dos BMFORMATs de ponto flutuante, BM_32b_scARGB ou BM_32b_scRGB são usados, os dados de cor que estão sendo traduzidos não devem conter NaN ou infinito. NaN e infinito não são considerados para representar valores de componente de cor legítimos e o resultado da tradução de pixels que contêm NaN ou infinito não tem sentido em termos de cor. Valores naN ou infinitos nos dados de cor que estão sendo processados serão tratados silenciosamente e um erro não será retornado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho icm.h
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também