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。 此方法不应用影响图像外观的调整,如伽玛或 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 |