다음을 통해 공유


CreateColorTransformW 함수(icm.h)

애플리케이션에서 색 관리를 수행하는 데 사용할 수 있는 색 변환을 만듭니다.

구문

HTRANSFORM CreateColorTransformW(
  LPLOGCOLORSPACEW pLogColorSpace,
  HPROFILE         hDestProfile,
  HPROFILE         hTargetProfile,
  DWORD            dwFlags
);

매개 변수

pLogColorSpace

입력 LOGCOLORSPACEA에 대한 포인터입니다.

hDestProfile

대상 디바이스의 프로필에 대한 핸들입니다. 함수는 HPROFILE에 ICC(International Color Consortium) 또는 WCS(Windows Color System) 프로필 정보가 포함되어 있는지 여부를 결정합니다.

hTargetProfile

대상 디바이스의 프로필에 대한 핸들입니다. 함수는 HPROFILE에 ICC 또는 WCS 프로필 정보가 포함되어 있는지 여부를 결정합니다.

dwFlags

변환의 컨트롤 생성을 사용하는 플래그를 지정합니다. 설명 부분을 참조하세요.

반환 값

이 함수가 성공하면 반환 값은 색 변환에 대한 핸들입니다.

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

설명

대상 프로필이 NULL이면 변환이 원본 논리 색 공간에서 대상 프로필로 이동합니다. 대상 프로필이 지정된 경우 변환은 원본 논리 색 공간에서 대상 프로필로, 그리고 대상 프로필로 이동합니다. 이렇게 하면 대상 디바이스의 대상 디바이스에 대한 출력을 미리 볼 수 있습니다.

dwFlags의 값은 힌트로만 사용됩니다. 색 관리 모듈은 이를 사용하는 가장 좋은 방법을 결정해야 합니다.

Windows Vista: dwFlags와 함께 사용할 수 있는 세 개의 새 플래그가 추가되었습니다.

플래그 설명
PRESERVEBLACK 이 비트를 설정하면 변환 엔진은 적절한 검은색 세대 GMMP를 변환 시퀀스의 마지막 GMMP로 삽입합니다. 이 플래그는 순수 WCS 변환에서만 작동합니다.
SEQUENTIAL_TRANSFORM 이 비트를 설정하면 WCS 처리 파이프라인의 각 단계가 이미지의 모든 픽셀에 대해 수행되며 최적화된 색 변환이 빌드되지 않습니다. 이 플래그는 순수 WCS 변환에서만 작동합니다. 제한 사항: SEQUENTIAL_TRANSFORM 플래그 집합을 사용하여 만든 변환은 생성된 스레드에서만 사용할 수 있으며 한 번에 하나의 색 변환 호출에만 사용할 수 있습니다. 순차 변환을 만들기 전에 COM을 초기화해야 하며 변환 개체의 수명 동안 초기화된 상태를 유지해야 합니다.
WCS_ALWAYS 이 비트가 설정되면 모든 ICC 변환에서도 WCS 코드 경로를 사용합니다.

참고

SEQUENTIAL_TRANSFORM 실수로 Windows Vista SDK의 icm.h 헤더에서 생략되었습니다. SEQUENTIAL_TRANSFORM 플래그를 사용하려면 애플리케이션에서 다음과 같이 정의합니다#define SEQUENTIAL_TRANSFORM 0x80800000

자세한 내용은 CMM 변환 만들기 플래그를 참조하세요. 언급 된 모든 플래그는 순수 ICC - ICC 변환에서만 작동하는 FAST_TRANSLATE 제외하고 모든 유형의 변환에 대해 지원됩니다.

CreateColorTransform 함수는 디바이스 컨텍스트 외부에서 사용됩니다. 색 프로필에서 동일한 색 프로필로 변환할 때 색이 바뀔 수 있습니다. 정밀도 오류 때문입니다. 따라서 이러한 상황에서는 색 변환을 수행해서는 안 됩니다.

B2Ax 태그는 변환의 대상인 모든 프로필에 필요합니다.

ICC ColorSpace 프로필에 대한 WCS 변환 지원은 RGB 색 영역 프로필로 제한됩니다. 다음 ICC 프로필 형식은 CITE 처리 변환( 혼합 WCS/ICC 변환 또는 WCS_ALWAYS 집합이 있는 모든 ICC 변환)에서 사용할 수 없습니다.

  • RGB가 아닌 ColorSpace 프로필
  • NamedColor 프로필
  • n 채널 프로필(여기서 n > 8)
  • DeviceLink 프로필
  • 추상 프로필

요구 사항

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

추가 정보