ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**) 메서드(d2d1_3.h)

  • 아티클

이미지 원본 내의 모든 픽셀 메모리를 채운 상태에서 WIC 비트맵 원본에서 이미지 원본 개체를 만듭니다.
최소한의 메모리를 사용하는 동안 이미지가 로드되고 저장됩니다.

구문

HRESULT CreateImageSourceFromWic(
  [in]  IWICBitmapSource                  *wicBitmapSource,
        D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
        D2D1_ALPHA_MODE                   alphaMode,
  [out] ID2D1ImageSourceFromWic           **imageSource
);

매개 변수

[in] wicBitmapSource

형식: IWICBitmapSource*

이미지 원본을 만들 WIC 비트맵 소스입니다.

loadingOptions

형식: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

이미지 원본을 만들기 위한 옵션입니다. NULL인 경우 기본 옵션이 사용됩니다.

alphaMode

형식: D2D1_ALPHA_MODE

이미지의 알파 모드입니다. D2D1_ALPHA_MODE_UNKNOWN 전달되면 원본의 픽셀 형식에서 자동으로 결정됩니다.

[out] imageSource

형식: ID2D1ImageSourceFromWic**

새 이미지 원본 instance 받습니다.

반환 값

형식: HRESULT

S_OK 성공하면 실패 HRESULT입니다.

설명

이 메서드는 이미지를 그리는 데 사용할 수 있는 이미지 원본을 만듭니다.

이 메서드는 최대 텍스처 크기를 초과하는 이미지를 지원합니다. 큰 이미지는 내부적으로 스파스 타일 캐시 내에 저장됩니다.

이 API는 CreateBitmapFromWicBitmap에서 지원하는 동일한 픽셀 형식 및 알파 모드 집합을 지원합니다.
GPU가 지정된 픽셀 형식을 지원하지 않는 경우 이 메서드는 D2DERR_UNSUPPORTED_PIXEL_FORMAT 반환합니다. 이 메서드는 이미지의 모양에 영향을 미치는 감마 또는 알파 사전 제거와 같은 조정을 적용하지 않습니다.

alphaMode 매개 변수를 D2D1_ALPHA_MODE_STRAIGHT 설정하면 안 됩니다. alphaMode 매개 변수를 D2D1_ALPHA_MODE_PREMULTIPLIED 또는 D2D1_ALPHA_MODE_IGNORE 설정하여 알파 모드를 재정의하지 않는 한 WIC 원본에서 직선 알파가 있는 픽셀 형식을 사용하는 경우 이 메서드는 실패합니다.

원본 형식에 알파 채널이 있는 경우 D2D1_ALPHA_MODE_IGNORE 전달해야 합니다.
D2D1_ALPHA_MODE_IGNORE 전달되고 원본 형식에 알파 채널이 있는 경우 알파 채널은 무시됩니다.

이 메서드는 JPEG 이미지에 별도의 광도 및 색 텍스처를 사용하는 등 GPU 메모리 사용량을 최소화하기 위해 적절한 스토리지 형식을 자동으로 선택합니다.

loadingOptions 인수가 NULL인 경우 D2D는 D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE 사용합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d2d1_3.h
DLL D2d1.dll

추가 정보

ID2D1DeviceContext2