ID2D1DeviceContext::D rawImage(ID2D1Effect,constD2D1_POINT_2F,constD2D1_RECT_F*,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) 메서드(d2d1_1.h)

아티클
02/26/2024

디바이스 컨텍스트에 이미지를 그립니다.

구문

void DrawImage(
  [in]           ID2D1Effect             *effect,
  [in, optional] const D2D1_POINT_2F     *targetOffset,
  [in, optional] const D2D1_RECT_F       *imageRectangle,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

매개 변수

[in] effect

형식: ID2D1Effect*

디바이스 컨텍스트에 그릴 효과입니다.

[in, optional] targetOffset

형식: const D2D1_POINT_2F*

이미지가 렌더링될 대상 공간의 오프셋입니다. 이미지의 전체 논리적 범위가 해당 대상으로 렌더링됩니다. 지정하지 않으면 대상 원본은 (0, 0)이 됩니다. 이미지의 왼쪽 위 모서리가 대상 오프셋에 매핑됩니다. 반드시 원본은 아닙니다. 이 기본값은 NULL입니다.

[in, optional] imageRectangle

형식: const D2D1_RECT_F*

이미지를 처리할 때 이미지 공간의 해당 사각형이 지정된 원본에 매핑됩니다. 이 기본값은 NULL입니다.

interpolationMode

형식: D2D1_INTERPOLATION_MODE

필요한 경우 이미지 크기를 조정하는 데 사용할 보간 모드입니다.

compositeMode

형식: D2D1_COMPOSITE_MODE

현재 선택한 클립의 제한에 적용할 복합 모드입니다. 기본값은 D2D1_COMPOSITE_MODE_SOURCE_OVER

반환 값

없음

설명

interpolationMode가 D2D1_INTERPOLATION_MODE_HIGH_QUALITY 경우 월드 변환에 내포된 배율 인수에 따라 다른 스칼라가 사용됩니다.

이 호출에 의해 그려지는 모든 효과에 누적된 잘못된 사각형은 이미지 사각형의 어느 부분을 그려도 무시됩니다.

compositeMode가 D2D1_COMPOSITE_MODE_SOURCE_OVER 경우 DrawImage는 ID2D1DeviceContext::SetPrimitiveBlend에 지정된 현재 선택된 기본 혼합을 사용합니다. compositeMode가 D2D1_COMPOSITE_MODE_SOURCE_OVER 않으면 이미지가 현재 축 맞춤 클립까지 투명하게 확장됩니다.

이미지 사각형과 월드 변환이 있는 경우 이는 이미지 사각형을 나타내는 클립 효과를 삽입하고 월드 변환을 고려하여 2D 아핀 변환을 삽입하는 것과 같습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	d2d1_1.h
DLL	D2d1.dll