CheckColors 함수(icm.h)
배열의 색이 지정된 변환의 출력 영역 내에 있는지 여부를 결정합니다.
구문
BOOL CheckColors(
HTRANSFORM hColorTransform,
PCOLOR paInputColors,
DWORD nColors,
COLORTYPE ctInput,
PBYTE paResult
);
매개 변수
hColorTransform
사용할 색 변환에 대한 핸들입니다.
paInputColors
변환할 nColorsCOLOR 구조체의 배열에 대한 포인터입니다.
nColors
paInputColors 및 paResult가 가리키는 배열의 요소 수를 포함합니다.
ctInput
입력 색 형식을 지정합니다.
paResult
테스트 결과를 수신하는 nColors 바이트 배열에 대한 포인터입니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
설명
입력 색 형식이 색 변환과 호환되지 않으면 CheckColors 가 실패합니다.
함수는 테스트 결과를 paResult가 가리키는 배열에 배치합니다. 배열의 각 바이트는 paInputColors가 가리키는 배열의 COLOR 요소에 해당하며 부호 없는 값은 0에서 255 사이입니다. 값 0은 색이 영역 안에 있음을 나타내는 반면, 0이 아닌 값은 색이 영역 외부임을 나타냅니다. 0 <n< 255인 정수 n의 경우 n +1의 결과 값은 n의 결과 값으로 표시되는 것과 같이 해당 색이 적어도 범위에서 멀리 떨어져 있음을 나타냅니다.
WCS에서 만든 영역 태그의 영역 외 정보는 CIECAM02 Jab 공간의 평균 제곱근인 CIECAM02 지각 색 거리를 사용합니다. 레거시 ICC 프로필 영역 태그의 거리는 CIELAB 공간의 평균 제곱근입니다. 더 정확한 거리 메트릭을 제공하기 때문에 사용할 수 있는 경우 CIECAM02 공간을 사용하는 것이 좋습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |