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