IWICBitmapSource の実装

[アーティクル]
06/13/2023

IWICBitmapSource

IWICBitmapSource は、アプリケーションの観点から画像を操作するために重要です。イメージソースの最上位レベルの抽象化を表し、IWICBitmapFrameDecode、IWICBitmap、およびすべての変換インターフェイス (IWICBitmapScaler、IWICBitmapClipper、IWICBitmapFlipRotator、IWICFormatConverter) を含む、イメージを表すすべての Windows イメージングコンポーネント (WIC) インターフェイスがそこから派生します。 IWICBitmapSource オブジェクトは、特定の時点で、メモリ内の実際のビットマップによってサポートされる場合とサポートされない場合があります。これにより、イメージを抽象化として処理できるため、アプリケーションによる非常に効率的な処理が可能になります。変換操作は、アプリケーションがイメージをレンダリングまたは印刷する準備ができるまで、メモリリソースを消費せずに変換パイプラインでチェーンできます。その時点で、最終的な変換で CopyPixels メソッドを呼び出して、選択した変換が適用されたイメージのメモリにビットマップを取得します。

interface IWICBitmapSource : IUnknown
{
   // Required methods
   HRESULT GetSize ( UINT *puiWidth, UINT *puiHeight );
   HRESULT GetPixelFormat ( WICPixelFormatGUID *pPixelFormat );
   HRESULT GetResolution ( double *pDpiX, double *pDpiY );
   HRESULT CopyPixels ( const WICRect *prc,
      UINT cbStride,
      UINT cbBufferSize, 
      BYTE *pbBuffer );
   // Optional method
   HRESULT CopyPalette ( IWICPalette *pIPalette );
}

コーデックの観点から、 IWICBitmapSource メソッドはフレームデコーダーオブジェクトに実装されます。これらのメソッドについては、「IWICBitmapSource の実装」と、 IWICBitmapSource から派生した IWICBitmapFrameDecode の他のメソッドについて説明 します。

リファレンス
IWICBitmapDecoder
IWICBitmapSource
IWICBitmapFrameDecode
概念
IWICBitmapCodecProgressNotification (デコーダー) の実装
IWICBitmapFrameDecode の実装
WIC-Enabled コーデックを記述する方法
Windows イメージングコンポーネントの概要

IWICBitmapSource の実装