다음을 통해 공유

CMCheckColors 함수(icm.h)

  • 아티클

지정된 색이 지정된 변환의 출력 영역 내에 있는지 여부를 결정합니다.

구문

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

매개 변수

hcmTransform

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

lpaInputColors

출력 영역과 검사 COLOR 구조의 배열에 대한 포인터입니다.

nColors

배열에 있는 요소의 수를 지정합니다.

ctInput

입력 색 형식을 지정합니다.

lpaResult

테스트 결과를 포함하는 바이트 배열을 배치할 버퍼에 대한 포인터입니다. 버퍼의 각 바이트는 COLOR 구조에 해당하며 종료 시 0에서 255 사이의 부호 없는 값으로 설정되었습니다. 값 0은 색이 영역 안에 있음을 나타내고, 0이 아닌 값은 영역 외부임을 나타냅니다. 0 <n< 255인 정수 n의 경우 n + 1의 결과 값은 n의 결과 값으로 표시되는 것과 같이 해당 색이 적어도 영역에서 멀리 떨어져 있음을 나타냅니다. 이러한 값은 일반적으로 ICC 프로필의 gamutTag 에서 생성됩니다.

반환 값

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

이 함수가 실패하면 반환 값은 FALSE입니다. 함수가 성공하지 못하면 CMM은 SetLastError 를 호출하여 마지막 오류를 Winerror.h에 정의된 유효한 오류 값으로 설정해야 합니다.

설명

이 함수를 내보내려면 모든 CMM이 필요합니다.

입력 색 형식이 색 변환 CMCheckColors 와 호환되지 않는 경우 실패합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 icm.h

참고 항목