다음을 통해 공유

TranslateBitmapBits 함수(icm.h)

  • 아티클

요청된 형식으로 다른 비트맵을 생성하도록 정의된 형식을 갖는 비트맵의 색을 변환합니다.

구문

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

매개 변수

hColorTransform

사용할 색 변환을 식별합니다.

pSrcBits

번역할 비트맵에 대한 포인터입니다.

bmInput

입력 비트맵의 형식을 지정합니다. BMFORMAT 열거형 형식의 값 중 하나로 설정해야 합니다.

참고

이 함수는 입력으로 BM_XYZTRIPLETS 또는 BM_YxyTRIPLETS 지원하지 않습니다.

dwWidth

입력 비트맵의 스캔 줄당 픽셀 수를 지정합니다.

dwHeight

입력 비트맵의 스캔 줄 수를 지정합니다.

dwInputStride

입력 비트맵에서 한 스캔 줄의 시작부터 다음의 시작 부분까지의 바이트 수를 지정합니다. 0으로 설정하면 함수는 스캔 선이 DWORD 정렬되도록 패딩된 것으로 가정합니다.

pDestBits

번역된 비트맵을 배치할 버퍼에 대한 포인터입니다.

bmOutput

출력 비트맵의 형식을 지정합니다. BMFORMAT 열거형 형식의 값 중 하나로 설정해야 합니다.

dwOutputStride

출력 비트맵에서 한 스캔 줄의 시작부터 다음의 시작 부분까지의 바이트 수를 지정합니다. 0으로 설정하면 함수는 스캔 줄이 DWORD 정렬되도록 패딩되어야 한다고 가정합니다.

pfnCallBack

TranslateBitmapBits에서 주기적으로 호출하여 진행률을 보고하고 호출 프로세스가 번역을 취소할 수 있도록 하는 콜백 함수에 대한 포인터입니다. ( ICMProgressProcCallback 참조)

ulCallbackData

예를 들어 진행률을 보고하는 번역을 식별하기 위해 콜백 함수로 다시 전달된 데이터입니다.

반환 값

이 함수가 성공하면 반환 값은 TRUE입니다.

이 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보는 GetLastError를 호출합니다.

설명

입력 및 출력 형식이 색 변환과 호환되지 않으면 이 함수가 실패합니다.

부동 소수점 BMFORMAT, BM_32b_scARGB 또는 BM_32b_scRGB 사용하는 경우 변환되는 색 데이터에 NaN 또는 무한대를 포함해서는 안 됩니다. NaN 및 무한대는 합법적인 색 구성 요소 값을 나타내는 것으로 간주되지 않으며 NaN 또는 무한대를 포함하는 픽셀을 변환한 결과는 색 측면에서 의미가 없습니다. 처리 중인 색 데이터의 NaN 또는 무한대 값은 자동으로 처리되며 오류가 반환되지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 icm.h
라이브러리 Mscms.lib
DLL Mscms.dll

추가 정보