다음을 통해 공유

WcsCreateIccProfile 함수(icm.h)

  • 아티클

WCS 프로필을 ICC(International Color Consortium) 프로필로 변환합니다.

구문

HPROFILE WcsCreateIccProfile(
  HPROFILE hWcsProfile,
  DWORD    dwOptions
);

매개 변수

hWcsProfile

변환된 WCS 색 프로필에 대한 핸들입니다. 설명 부분을 참조하세요.

dwOptions

프로필 변환 옵션을 지정하는 플래그 값입니다.

기본적으로 변환에 사용되는 원래 WCS 프로필은 Microsoft 프라이빗 태그 인 WcsProfilesTag (서명 "MS000")의 출력 ICC 프로필에 포함됩니다. 이는 ICC 소프트웨어와 호환되는 ICC 프로필을 생성하지만 구문 분석하도록 설계된 코드에 사용할 수 있는 원래 WCS 프로필 데이터를 유지합니다.

이 매개 변수의 가능한 값은 다음과 같습니다. 이 목록에 정의되지 않은 모든 비트는 예약되어 있으며 0으로 설정해야 합니다.

값 설명
WCS_DEFAULT 새 ICC 프로필에 프라이빗 WcsProfilesTag의 원래 WCS 프로필이 포함되도록 지정합니다.
WCS_ICCONLY 새 ICC 프로필에 WcsProfilesTag 또는 원래 WCS 프로필이 포함되지 않도록 지정합니다.

반환 값

이 함수가 성공하면 반환 값은 새 색 프로필의 핸들입니다.

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

설명

이 함수는 ASCII 또는 유니코드 문자열과 함께 사용할 수 있습니다.

CloseColorProfile 함수는 더 이상 필요하지 않은 경우 반환된 HPROFILE 핸들을 닫는 데 사용해야 합니다.

HPROFILE의 DMP, CAMP 및 GMMP는 생성된 ICC 프로필 내의 프라이빗 태그에 포함됩니다.

이 API를 사용하여 만든 ICC 프로필에는 "DMP:[DMP ProfileName], CAMP:[CAMP ProfileName], GMMP:[GMMP ProfileName]에서 Microsoft WCS에서 생성됨" 패턴에 따라 WCS 프로필의 ProfileName 요소에서 생성된 프로필 설명 태그가 있습니다.

WCS가 OpenColorProfileW 또는 WcsOpenColorProfileW 를 통해 이 ICC 프로필을 발견하면 WcsProfilesTag에 포함된 WCS 프로필을 추출하고 사용합니다.

WCS에서 만든 영역 태그의 외부 영역 정보는 CIECAM02 Jab 공간의 평균 제곱근인 CIECAM02의 지각 색 거리를 사용합니다. 레거시 ICC 프로필 영역 태그의 거리는 CIELAB 공간의 평균 제곱근입니다. CIECAM02 공간을 사용할 수 있는 경우 더 정확하고 정확한 거리 메트릭을 제공하는 것이 좋습니다.

WCS는 디바이스와 명시적으로 연결된 XML 프로필 또는WcsProfilesTag가 있는 ICC 프로필을 통해 원래 WCS 프로필을 추출하고 사용합니다.

WcsProfilesTag는 WcsCreateIccProfile에 대한 WCS 프로필 입력을 포함하기 위해 WcsCreateIccProfile에서 만든 프로필에 사용되는 Microsoft 프라이빗 ICC 프로필 태그입니다. 이 태그는 프로필 태그에 대한 ICC 프로필 요구 사항을 준수합니다. 태그의 비 XML 구성 요소는 ICC 프로필에 대한 표준인 "Big-Endian" 바이트 순서에 있어야 합니다. 또한 태그 데이터는 ICC 프로필의 시작부터 측정된 4 바이트 경계에 맞춰야 합니다. 태그의 구조는 아래 WcsProfilesTagType 에 의해 정의됩니다. 태그의 XML 구성 요소인 WcsProfileTag에 포함된 WCS 프로필은 네이티브 바이트 순서에 남아 있습니다. XML 파서가 올바르게 처리되기 때문에 little-endian 또는 big-endian일 수 있습니다.

WcsProfilesTag 서명은 "MS00"입니다. WcsProfilesTag에 대한 ICC 프로필 태그 테이블에 표시되는 태그 서명입니다.

WcsProfilesTagType 구조체에는 다음과 같은 구조가 있습니다.

바이트 오프셋 콘텐츠
0-3 MS10 형식 서명입니다.
4-7 예약된 는 0(ICC 전통)으로 설정해야 합니다.
8-11 태그의 시작 부분에서 CDMP 데이터로의 바이트 오프셋입니다.
12-15 CDMP 데이터의 크기(바이트)입니다.
16-19 태그의 시작 부분에서 CAMP 데이터로의 바이트 오프셋입니다.
20-23 CAMP 데이터의 크기(바이트)입니다.
24-27 태그의 시작 부분에서 GMMP 데이터로의 바이트 오프셋입니다.
28-31 태그의 시작 부분에서 GMMP 데이터로의 바이트 오프셋입니다.
31-n (요소 크기 -32) 바이트 시퀀스[여기서 요소 크기는 이 태그에 대한 ICC 프로필 태그 테이블 항목에 기록된 태그 크기입니다.]

이러한 프로필은 WcsCreateIccProfile 에서 이 ICC 프로필을 만드는 데 사용한 WCS XML 프로필입니다. WCS 프로필은 순서가 지정됩니다. 먼저 DMP(필수)와 CAMP(있는 경우) 뒤에 GMMP(있는 경우)가 옵니다.

요구 사항

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

참고 항목