IWICBitmap::SetResolution 方法 (wincodec.h)

更改图像的物理分辨率。

语法

HRESULT SetResolution(
  [in] double dpiX,
  [in] double dpiY
);

参数

[in] dpiX

类型: double

水平分辨率。

[in] dpiY

类型: double

垂直分辨率。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法不会影响位图中存储的实际像素或样本。 而是修改了采样率的解释。 这意味着宽度为 96 像素的 96 DPI 图像为 1 英寸。 如果将物理分辨率修改为 48 DPI,则位图被视为 2 英寸宽,但像素数相同。
如果分辨率小于 REAL_EPSILON (1.192092896e-07F) 返回错误代码 WINCODEC_ERR_INVALIDPARAMETER

要求

要求
最低受支持的客户端 Windows XP SP2、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll