다음을 통해 공유

CheckColorsInGamut 함수(wingdi.h)

  • 아티클

CheckColorsInGamut 함수는 지정된 RGB 삼중 집합이 지정된 디바이스의 출력 영역 내에 있는지 여부를 결정합니다. RGB 삼중은 입력 논리 색 공간에서 해석됩니다.

구문

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

매개 변수

hdc

출력 영역을 확인할 디바이스 컨텍스트에 대한 핸들입니다.

lpRGBTriple

검사 RGB의 배열에 대한 포인터입니다.

dlpBuffer

결과를 배치할 버퍼에 대한 포인터입니다. 이 버퍼는 nCount 바이트만큼 커야 합니다.

nCount

삼중 배열의 요소 수입니다.

반환 값

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

이 함수가 실패하면 반환 값은 0입니다.

설명

함수는 테스트 결과를 lpBuffer가 가리키는 버퍼에 배치합니다. 버퍼의 각 바이트는 RGB 트리플에 해당하며 CM_IN_GAMUT(= 0)과 CM_OUT_OF_GAMUT(= 255) 사이에 부호 없는 값이 있습니다. 값 0은 색이 영역 안에 있음을 나타내는 반면, 0이 아닌 값은 색이 영역 외부임을 나타냅니다. 0 <n< 255인 정수 n의 경우 n + 1의 결과 값은 ICC 프로필 형식 사양에 지정된 대로 n의 결과 값으로 표시되는 것과 같이 해당 색이 적어도 범위에서 멀리 떨어져 있음을 나타냅니다. ICC 프로필 형식 사양에 대한 자세한 내용은 추가 정보 에 나열된 원본을 참조하세요.

이 함수가 성공하려면 hDC 매개 변수를 통해 전달되는 디바이스 컨텍스트 핸들에 대해 WCS를 사용하도록 설정해야 합니다. SetICMMode 함수를 호출하여 디바이스 컨텍스트 핸들에 대해 WCS를 사용하도록 설정할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wingdi.h
라이브러리 Gdi32.lib
DLL Gdi32.dll

추가 정보