ID2D1ImageSourceFromWic::TrimCache(constD2D1_RECT_U&) メソッド (d2d1_3.h)

このメソッドは、イメージ ソース キャッシュの設定された領域を、指定した四角形のみにトリミングします。

構文

HRESULT TrimCache(
  [ref] const D2D1_RECT_U & rectangleToPreserve
);

パラメーター

[ref] rectangleToPreserve

型: const D2D1_RECT_U

イメージ ソース キャッシュに保持するイメージの領域をピクセル単位で指定します。 四角形の外側にある領域は、キャッシュから削除されます。 既定では、これは空の四角形です。つまり、イメージ全体がキャッシュから削除されます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

指定されたリージョンは、イメージ ソースが描画されるスケールを含むように構築する必要があります。 これらの座標は、ローカル座標で指定する必要があります。
つまり、DPI やその他の関連する変換 (ワールド変換やブラシ変換を含む) に従って API を呼び出す前に調整する必要があります。

イメージ ソースの作成時にオンデマンド キャッシュが要求されなかった場合、このメソッドは失敗します。

ID2D1Device::ClearResources と同様に、呼び出し元は、メモリ使用量を減らす前に、その後 D3D フラッシュを発行する必要があります。

この操作は、イメージ ソースが D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND オプションを使用して初期化されている場合にのみサポートされます。

要件

   
対象プラットフォーム Windows
ヘッダー d2d1_3.h
Library D2d1_3.lib
[DLL] D2d1_3.dll

こちらもご覧ください

ID2D1ImageSourceFromWic