DrvDitherColor 함수(winddi.h)

DrvDitherColor 함수는 디바이스 팔레트에 대해 디더링된 브러시를 만들도록 디바이스에 요청합니다.

구문

ULONG DrvDitherColor(
  [in]      DHPDEV dhpdev,
  [in]      ULONG  iMode,
  [in]      ULONG  rgb,
  [in, out] ULONG  *pul
);

매개 변수

[in] dhpdev

지정된 색을 디더링해야 하는 색상표에 대해 물리적 디바이스를 설명하는 PDEV 구조체에 대한 핸들입니다.

[in] iMode

디더링할 팔레트를 결정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
DM_DEFAULT	드라이버는 디바이스의 기본 기본 색 공간에 대한 디더를 만들어야 합니다. 예를 들어 디바이스가 16bpp에서 실행되는 경우 결과 디더는 16bpp 형식이어야 합니다.
DM_MONOCHROME	드라이버는 단색 색 공간에 대한 디더를 만들어야 합니다. 즉, 디더는 1bpp 비트맵으로 반환되어야 합니다.

[in] rgb

디더링할 RGB 색을 지정합니다.

[in, out] pul

디더링 정보를 수신하는 메모리 위치에 대한 포인터입니다. 디더링된 브러시 차원 cxDither by cyDither를 사용하여 표준 형식 비트맵에 메모리를 할당해야 합니다. 이러한 차원은 DEVINFO 구조체의 멤버입니다. 비트맵 형식은 DEVINFO 구조체의 iDitherFormat 멤버에 의해 결정됩니다.

반환 값

드라이버에서 디더 값을 계산한 경우 반환 값은 DCR_DRIVER, 엔진이 색의 가장 단색 근사값을 사용해야 하는지 DCR_SOLID, 엔진이 드라이버에 대한 하프톤 근사값을 만들어야 하는지 DCR_HALFTONE.

설명

디더의 결과는 pul에 저장된 디바이스 색 인덱스 집합입니다. 패턴에 이러한 색을 사용하여 만든 브러시는 지정된 색 rgb의 근사치여야 합니다.

DrvDitherColor 는 cxDither 및 cyDither 가 0이 아닌 경우에만 호출되는 선택적 함수입니다. 대부분의 래스터 프린터를 포함한 단색 디바이스 드라이버는 iMode 매개 변수를 사용하여 GDI에 좋은 회색 배율 패턴을 가져오는 방법을 알려야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)

추가 정보

DEVINFO

DrvEnablePDEV