다음을 통해 공유


SetStretchBltMode 함수(wingdi.h)

SetStretchBltMode 함수는 지정된 디바이스 컨텍스트에서 비트맵 스트레치 모드를 설정합니다.

구문

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] mode

스트레치 모드입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
BLACKONWHITE
제거된 픽셀과 기존 픽셀의 색 값을 사용하여 부울 AND 연산을 수행합니다. 비트맵이 단색 비트맵인 경우 이 모드는 흰색 픽셀을 희생하여 검은색 픽셀을 유지합니다.
COLORONCOLOR
픽셀을 삭제합니다. 이 모드는 해당 정보를 보존하지 않고 제거된 모든 픽셀 줄을 삭제합니다.
하프톤
원본 사각형의 픽셀을 대상 사각형의 픽셀 블록에 매핑합니다. 대상 픽셀 블록의 평균 색은 원본 픽셀의 색과 유사합니다.

HALFTONE 스트레치 모드를 설정한 후 애플리케이션은 SetBrushOrgEx 함수를 호출하여 브러시 원점 설정해야 합니다. 이렇게 하지 않으면 브러시 정렬이 잘못 발생합니다.

STRETCH_ANDSCANS
BLACKONWHITE와 동일합니다.
STRETCH_DELETESCANS
COLORONCOLOR와 동일합니다.
STRETCH_HALFTONE
HALFTONE과 동일합니다.
STRETCH_ORSCANS
WHITEONBLACK과 동일합니다.
WHITEONBLACK
제거된 픽셀과 기존 픽셀의 색 값을 사용하여 부울 OR 연산을 수행합니다. 비트맵이 단색 비트맵인 경우 이 모드는 검은색 픽셀을 희생하여 흰색 픽셀을 유지합니다.

반환 값

함수가 성공하면 반환 값은 이전 스트레치 모드입니다.

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

이 함수는 다음 값을 반환할 수 있습니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
하나 이상의 입력 매개 변수가 잘못되었습니다.

설명

스트레치 모드는 애플리케이션이 StretchBlt 함수를 호출할 때 시스템에서 비트맵의 행 또는 열을 디스플레이 디바이스의 기존 픽셀과 결합하는 방법을 정의합니다.

BLACKONWHITE(STRETCH_ANDSCANS) 및 WHITEONBLACK(STRETCH_ORSCANS) 모드는 일반적으로 전경 픽셀을 단색 비트맵으로 유지하는 데 사용됩니다. COLORONCOLOR(STRETCH_DELETESCANS) 모드는 일반적으로 색 비트맵에서 색을 유지하는 데 사용됩니다.

HALFTONE 모드는 느리며 다른 세 가지 모드보다 원본 이미지를 더 많이 처리해야 합니다. 은 더 높은 품질의 이미지를 생성합니다. 또한 브러시가 잘못 정렬되지 않도록 HALFTONE 모드를 설정한 후에 SetBrushOrgEx 를 호출해야 합니다.

디바이스 드라이버의 기능에 따라 추가 스트레치 모드를 사용할 수도 있습니다.

요구 사항

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

추가 정보

비트맵 함수

비트맵 개요

GetStretchBltMode

SetBrushOrgEx

Stretchblt