IWICProgressiveLevelControl

プログレッシブデコードに関する情報の取得と制御を行うためのメソッドを公開します。

画像は、プログレッシブエンコードされている場合にのみプログレッシブにデコードできます。プログレッシブ画像は、自動的に最も高い(最高品質の)プログレッシブレベルから開始されます。呼び出し側は、デコーダーをより低いプログレッシブレベルに手動で設定する必要があります。

コーデックがプログレッシブレベルのデコードをサポートしていない場合は、E_NOTIMPL が返されます。

コーデックがサポートするプログレッシブデコードのレベル数を取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

プログレッシブ JPEG 画像のプログレッシブレベルを反復処理するために、この関数を使用しないでください。JPEG のプログレッシブレベルは画像によって決定され、固定のレベル数を持ちません。このメソッドを使用すると、アプリケーションは戻る前にすべてのプログレッシブレベルがダウンロードされるまで待機させられます。代わりに、アプリケーションはプログレッシブ JPEG 画像のプログレッシブレベルを反復処理するために、次のコードを使用してください。

Examples

IWICProgressiveLevelControl *pProgressive = NULL;

HRESULT hr = (pBitmapFrame->QueryInterface(
   IID_IWICProgressiveLevelControl, 
   (void**) &pProgressive));
                
if (SUCCEEDED(hr))
{
   for (UINT uCurrentLevel = 0; SUCCEEDED(hr); uCurrentLevel++)
   {
      hr = pProgressive->SetCurrentLevel(uCurrentLevel);
      if (WINCODEC_ERR_INVALIDPROGRESSIVELEVEL == hr)
      {
         // No more levels
         break;
      }

      if (SUCCEEDED(hr))
      {
         // Output the current level
         hr = pBitmapFrame->CopyPixels(...);
      }                      
   }
}

if (pProgressive)
{
   pProgressive->Release();
}

デコーダーの現在のプログレッシブレベルを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

レベルは常に最も高いプログレッシブレベルが既定値となります。より低いプログレッシブレベルをデコードするには、まず SetCurrentLevel を呼び出す必要があります。

次回の CopyPixels 呼び出しで取得するレベルを指定します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

サポートされているすべてのレベルを要求する必要はありません。 呼び出し側がレベル 0 を事前に要求せずにレベル 1 を要求した場合、次回の CopyPixels 呼び出しで返されるビットには両方のレベルが含まれます。

要求されたレベルが無効な場合、返されるエラーは WINCODEC_ERR_INVALIDPROGRESSIVELEVEL です。

Examples

プログレッシブ JPEG 画像のプログレッシブレベルを反復処理するには、GetCurrentLevel メソッドではなくこのメソッドを使用してください。JPEG のプログレッシブレベルは画像によって決定され、固定のレベル数を持ちません。 GetCurrentLevel メソッドを使用すると、アプリケーションは戻る前にすべてのプログレッシブレベルがダウンロードされるまで待機させられます。 代わりに、アプリケーションはプログレッシブ JPEG 画像のプログレッシブレベルを反復処理するために、次のコードを使用してください。

IWICProgressiveLevelControl *pProgressive = NULL;

HRESULT hr = (pBitmapFrame->QueryInterface(
   IID_IWICProgressiveLevelControl, 
   (void**) &pProgressive));
                
if (SUCCEEDED(hr))
{
   for (UINT uCurrentLevel = 0; SUCCEEDED(hr); uCurrentLevel++)
   {
      hr = pProgressive->SetCurrentLevel(uCurrentLevel);
      if (WINCODEC_ERR_INVALIDPROGRESSIVELEVEL == hr)
      {
         // No more levels
         break;
      }

      if (SUCCEEDED(hr))
      {
         // Output the current level
         hr = pBitmapFrame->CopyPixels(...);
      }                      
   }
}

if (pProgressive)
{
   pProgressive->Release();
}