다음을 통해 공유

CheckBitmapBits 함수(icm.h)

  • 아티클

지정된 비트맵의 픽셀이 지정된 변환의 출력 영역 내에 있는지 여부를 확인합니다.

구문

BOOL CheckBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwStride,
  PBYTE         paResult,
  PBMCALLBACKFN pfnCallback,
  LPARAM        lpCallbackData
);

매개 변수

hColorTransform

사용할 색 변환에 대한 핸들입니다.

pSrcBits

출력 영역과 검사 비트맵에 대한 포인터입니다.

bmInput

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

dwWidth

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

dwHeight

비트맵의 검사 줄 수를 지정합니다.

dwStride

첫 번째 검사 줄부터 다음 검사 줄의 시작까지의 바이트 수를 지정합니다. 0으로 설정하면 비트맵 검사 줄은 DWORD 정렬되도록 패딩된 것으로 간주됩니다.

paResult

테스트 결과를 배치할 바이트 배열에 대한 포인터입니다. 이 결과 버퍼는 비트맵에 픽셀이 있는 만큼 바이트를 포함해야 합니다.

pfnCallback

CheckBitmapBits에서 주기적으로 호출하여 진행 상황을 보고하고 호출 프로세스가 비트맵 테스트를 취소할 수 있도록 하는 콜백 함수에 대한 포인터입니다. ( ICMProgressProcCallback 참조).

lpCallbackData

예를 들어 보고되는 진행률에 대한 비트맵 테스트를 식별하기 위해 콜백 함수로 다시 전달된 데이터입니다.

반환 값

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

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

설명

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

이 함수는 테스트 결과를 paResult가 가리키는 버퍼에 배치합니다. 버퍼의 각 바이트는 비트맵의 픽셀에 해당하며 부호 없는 값은 0에서 255 사이입니다. 값 0은 색이 영역 안에 있음을 나타내는 반면, 0이 아닌 값은 색이 영역 외부임을 나타냅니다. 0 <n< 255인 정수 n의 경우 n + 1의 결과 값은 n의 결과 값으로 표시되는 것과 같이 해당 색이 적어도 범위에서 멀리 떨어져 있음을 나타냅니다.

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

WCS에서 만든 영역 태그의 영역 외 정보는 CIECAM02 Jab 공간의 평균 제곱근인 CIECAM02 지각 색 거리를 사용합니다. 레거시 ICC 프로필 영역 태그의 거리는 CIELAB 공간의 평균 제곱근입니다. 더 정확한 거리 메트릭을 제공하기 때문에 사용할 수 있는 경우 CIECAM02 공간을 사용하는 것이 좋습니다.

요구 사항

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

추가 정보