SetWorldTransform 함수(wingdi.h)

아티클
08/27/2023

SetWorldTransform 함수는 지정된 디바이스 컨텍스트의 월드 공간과 페이지 공간 간에 2차원 선형 변환을 설정합니다. 이 변환은 그래픽 출력의 크기를 조정, 회전, 전단 또는 변환하는 데 사용할 수 있습니다.

구문

BOOL SetWorldTransform(
  [in] HDC         hdc,
  [in] const XFORM *lpxf
);

매개 변수

[in] hdc

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

[in] lpxf

변환 데이터를 포함하는 XFORM 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

다음은 변환 매트릭스입니다(요소 표기법의 숫자는 1 기반 열 번호 뒤에 1-기반 행 번호가 아니라 역방향이 아님).

| eM11 eM21 eDx |
| eM12 eM22 eDy |
| 0    0    1   |

따라서 월드 공간의 모든 좌표(x, y)의 경우 페이지 공간에서 변환된 좌표(x', y')를 아래와 같이 확인할 수 있습니다.

| x' |   | eM11 eM21 eDx |   | x |   
| y' | = | eM12 eM22 eDy | . | y |
| 1  |   | 0    0    1   |   | 1 |

x' = x * eM11 + y * eM21 + eDx
y' = x * eM12 + y * eM22 + eDy

이 함수는 논리 단위를 사용합니다.

월드 변환은 일반적으로 디바이스 독립적 방식으로 논리 이미지의 크기를 조정하거나 회전하는 데 사용됩니다.

기본 월드 변환은 오프셋이 0인 ID 행렬입니다.

SetWorldTransform 함수는 이전에 SetGraphicsMode 함수를 호출하여 지정된 디바이스 컨텍스트의 그래픽 모드가 GM_ADVANCED 설정되지 않은 한 실패합니다. 마찬가지로 SetWorldTransform 또는 ModifyWorldTransform을 호출하여 월드 변환을 기본 ID 변환으로 처음 다시 설정하지 않는 한 디바이스 컨텍스트의 그래픽 모드를 기본 GM_COMPATIBLE 모드로 다시 설정할 수 없습니다.

예제

예제는 좌표 공간 및 변환 사용을 참조하세요.

요구 사항


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