SetStretchBltMode 함수(wingdi.h)
SetStretchBltMode 함수는 지정된 디바이스 컨텍스트에서 비트맵 스트레치 모드를 설정합니다.
구문
int SetStretchBltMode(
[in] HDC hdc,
[in] int mode
);
매개 변수
[in] hdc
디바이스 컨텍스트에 대한 핸들입니다.
[in] mode
스트레치 모드입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
제거된 픽셀과 기존 픽셀의 색 값을 사용하여 부울 AND 연산을 수행합니다. 비트맵이 단색 비트맵인 경우 이 모드는 흰색 픽셀을 희생하여 검은색 픽셀을 유지합니다. |
|
픽셀을 삭제합니다. 이 모드는 해당 정보를 보존하지 않고 제거된 모든 픽셀 줄을 삭제합니다. |
|
원본 사각형의 픽셀을 대상 사각형의 픽셀 블록에 매핑합니다. 대상 픽셀 블록의 평균 색은 원본 픽셀의 색과 유사합니다.
HALFTONE 스트레치 모드를 설정한 후 애플리케이션은 SetBrushOrgEx 함수를 호출하여 브러시 원점 설정해야 합니다. 이렇게 하지 않으면 브러시 정렬이 잘못 발생합니다. |
|
BLACKONWHITE와 동일합니다. |
|
COLORONCOLOR와 동일합니다. |
|
HALFTONE과 동일합니다. |
|
WHITEONBLACK과 동일합니다. |
|
제거된 픽셀과 기존 픽셀의 색 값을 사용하여 부울 OR 연산을 수행합니다. 비트맵이 단색 비트맵인 경우 이 모드는 검은색 픽셀을 희생하여 흰색 픽셀을 유지합니다. |
반환 값
함수가 성공하면 반환 값은 이전 스트레치 모드입니다.
함수가 실패하면 반환 값은 0입니다.
이 함수는 다음 값을 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
하나 이상의 입력 매개 변수가 잘못되었습니다. |
설명
스트레치 모드는 애플리케이션이 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 |