다음을 통해 공유

ColorMatchToTarget 함수(wingdi.h)

  • 아티클

ColorMatchToTarget 함수를 사용하면 대상 디바이스에 표시되는 색을 미리 볼 수 있습니다.

구문

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

매개 변수

hdc

미리 보기용 디바이스 컨텍스트(일반적으로 화면)를 지정합니다.

hdcTarget

대상 디바이스 컨텍스트(일반적으로 프린터)를 지정합니다.

action

다음 값 중 하나를 가질 수 있는 상수입니다.

 

값 의미
CS_ENABLE
 대상 디바이스의 색 영역으로 색을 매핑합니다. 이렇게 하면 색 교정이 가능합니다. DC에 대한 모든 후속 그리기 명령은 대상 디바이스에 표시되는 대로 색을 렌더링합니다.
CS_DISABLE
 색 교정을 사용하지 않도록 설정합니다.
CS_DELETE_TRANSFORM
 대상 프로필에 대해 색 관리를 사용하도록 설정한 경우 사용하지 않도록 설정하고 연결된 변환을 삭제합니다.

반환 값

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

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

설명

ColorMatchToTarget 을 사용하여 다른 색 출력 디바이스에서 색 출력 디바이스의 색을 교정할 수 있습니다. uiAction 매개 변수를 CS_ENABLE 설정하면 DC에 대한 모든 후속 그리기 명령이 대상 디바이스에 표시되는 대로 색을 렌더링합니다. uiAction이 CS_DISABLE 설정되면 언어 교정이 해제됩니다. 그러나 현재 색 변환은 DC에서 삭제되지 않습니다. 그것은 단지 비활성입니다.

ColorMatchToTarget이 호출되면 대상 디바이스의 색 변환이 먼저 수행된 다음 미리 보기 디바이스로 변환이 첫 번째 변환의 결과에 적용됩니다. 이는 주로 영역 매핑 조건을 확인하는 데 사용됩니다. 이 함수를 사용하기 전에 두 디바이스 컨텍스트에 대해 WCS를 사용하도록 설정해야 합니다.

이 함수는 연계할 수 없습니다. uiAction을 CS_ENABLE 설정하여 대상에 대한 색 매핑을 사용하도록 설정하는 동안 색 공간 또는 영역 매핑 메서드에 대한 애플리케이션 변경 내용은 무시됩니다. 그런 다음 대상에 대한 색 매핑을 사용하지 않도록 설정하면 이러한 변경 내용이 적용됩니다.

참고 애플리케이션이 CS_DELETE_TRANSFORM 사용하여 변환을 삭제하지 않으면 메모리 누수는 발생하지 않습니다. DC(디바이스 컨텍스트)가 닫혀 있거나 애플리케이션 색 공간이 삭제되면 변환이 삭제됩니다. 그러나 변환을 다시 사용하지 않거나 애플리케이션이 DC에서 더 이상 색 일치를 수행하지 않는 경우 변환을 명시적으로 삭제하여 사용하는 메모리를 해제해야 합니다.
 
ColorMatchToTarget 함수가 호출되기 전에 색 관리를 사용하도록 설정한 경우에만 uiAction 매개 변수를 CS_DELETE_TRANSFORM 설정해야 합니다.

요구 사항

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

추가 정보