ID2D1DeviceContext2：：CreateImageSourceFromWic (IWICBitmapSource*，D2D1_IMAGE_SOURCE_LOADING_OPTIONS，ID2D1ImageSourceFromWic**) 方法 (d2d1_3.h)

  • 發行項

從 WIC 位圖來源建立影像來源對象，同時填入影像來源內的所有圖元記憶體。
映像會在使用最少的內存量時載入並儲存。

語法

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

參數

[in] wicBitmapSource

類型： IWICBitmapSource*

要從中建立影像來源的 WIC 位圖來源。

loadingOptions

類型： D2D1_IMAGE_SOURCE_LOADING_OPTIONS

建立映像來源的選項。 如果 NULL，則會使用預設選項。

[out] imageSource

類型： ID2D1ImageSourceFromWic**

接收新的映像來源實例。

傳回值

類型： HRESULT

如果成功，S_OK，否則為失敗的 HRESULT。

備註

此方法會建立可用來繪製影像的影像來源。

這個方法支持超過紋理大小上限的影像。 大型影像會在內部儲存在疏鬆磚快取內。

此 API 支援 CreateBitmapFromWicBitmap 所支援的相同像素格式和 Alpha 模式。
如果 GPU 不支援指定的圖元格式，這個方法會傳回D2DERR_UNSUPPORTED_PIXEL_FORMAT。 此方法不會套用影響影像外觀的調整，例如 gamma 或 alpha 預先乘法。

此方法會自動選取適當的儲存格式，以將 GPU 記憶體使用量降到最低。例如，針對 JPEG 影像使用不同的亮度和色度紋理。

如果loadingOptions自變數為 NULL，D2D 會使用 D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE。

規格需求

需求 值
最低支援的用戶端 Windows 10 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2016 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_3.h
Dll D2d1.dll

另請參閱

ID2D1DeviceContext2