다음을 통해 공유

CMTranslateRGBs 함수(icm.h)

  • 아티클

[CMTranslateRGB 는 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

색 변환을 사용하여 한 색 공간에서 다른 색 공간 으로 비트맵을 변환합니다.

구문

BOOL CMTranslateRGBs(
  HCMTRANSFORM hcmTransform,
  LPVOID       lpSrcBits,
  BMFORMAT     bmInput,
  DWORD        dwWidth,
  DWORD        dwHeight,
  DWORD        dwStride,
  LPVOID       lpDestBits,
  BMFORMAT     bmOutput,
  DWORD        dwTranslateDirection
);

매개 변수

hcmTransform

사용할 색 변환을 지정합니다.

lpSrcBits

번역할 비트맵을 가리킵니다.

bmInput

입력 비트맵 형식을 지정합니다.

dwWidth

입력 비트맵의 스캔 줄당 픽셀 수를 지정합니다.

dwHeight

입력 비트맵의 스캔 줄 수를 지정합니다.

dwStride

입력 비트맵에서 한 스캔 줄의 시작부터 다음 검사 줄의 시작 부분까지의 바이트 수를 지정합니다. dwStride가 0으로 설정된 경우 CMM은 스캔 줄이 DWORD 정렬되도록 안쪽 여백이 있다고 가정해야 합니다.

lpDestBits

번역된 비트맵을 배치할 대상 버퍼를 가리킵니다.

bmOutput

출력 비트맵 형식을 지정합니다.

dwTranslateDirection

변환에 사용되는 변환의 방향을 지정합니다. 이 매개 변수는 다음 값 중 하나를 사용해야 합니다.

값 의미
CMS_FORWARD

앞으로 변환 사용
CMS_BACKWARD

역방향 변환 사용

반환 값

Windows Vista부터 기본 CMM(Icm32.dll)은 FALSE 를 반환하고 GetLastError 는 ERROR_NOT_SUPPORTED 보고합니다.

Windows Server 2003, Windows XP 및 Windows 2000:

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

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

설명

Windows Vista부터 이 메서드를 구현하기 위해 CMM 구현자가 더 이상 필요하지 않습니다.

Windows Server 2003, Windows XP 및 Windows 2000:

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

대상 버퍼에 쓸 때 CMM은 스캔 줄이 DWORD 정렬되도록 패딩되어 있는지 확인해야 합니다.

입력 및 출력 형식이 색 변환과 호환되지 않으면 이 함수가 실패합니다.

입력 및 출력 비트맵 형식이 모두 BM_xRGBQUADS 경우와 같이 3 채널, 픽셀당 4바이트인 경우 4바이트가 유지되고 출력 버퍼에 복사되어야 합니다.

이 함수는 현재 위치 변환을 지원해야 합니다. 즉, 출력의 메모리 공간이 입력의 메모리 공간보다 작거나 같을 때마다 이 함수는 원본 버퍼와 대상 버퍼가 같더라도 비트맵 색을 변환할 수 있어야 합니다.

요구 사항

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

추가 정보