IWICBitmapScaler::Initialize method (wincodec.h)

Initializes the bitmap scaler with the provided parameters.

Syntax

HRESULT Initialize(
  [in] IWICBitmapSource           *pISource,
  [in] UINT                       uiWidth,
  [in] UINT                       uiHeight,
  [in] WICBitmapInterpolationMode mode
);

Parameters

[in] pISource

Type: IWICBitmapSource*

The input bitmap source.

[in] uiWidth

Type: UINT

The destination width.

[in] uiHeight

Type: UINT

The destination height.

[in] mode

Type: WICBitmapInterpolationMode

The WICBitmapInterpolationMode to use when scaling.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IWICBitmapScaler can't be initialized multiple times. For example, when scaling every frame in a multi-frame image, a new IWICBitmapScaler must be created and initialized for each frame.

Examples

For an example using an IWICBitmapScaler, see the How to Scale a Bitmap Source topic.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps | UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps | UWP apps]
Target Platform	Windows
Header	wincodec.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll