CachingHint CachingHint CachingHint CachingHint Enum

定義

並べて表示されたブラシ オブジェクトをキャッシュするかどうかを指定します。Specifies whether to cache tiled brush objects.

public enum class CachingHint
public enum CachingHint
type CachingHint = 
Public Enum CachingHint
継承

フィールド

Cache Cache Cache Cache 1

RenderOptions 設定で指定されたキャッシュ ヒントを使用して、並べて表示されたブラシ オブジェクトを画面外のバッファーにキャッシュします。Cache the tiled brush objects in an off-screen buffer, using the caching hints specified by the RenderOptions settings.

Unspecified Unspecified Unspecified Unspecified 0

キャッシュ ヒントは指定されません。No caching hints are specified.

次の例では、キャッシュ ヒント オプションを使用する方法を示しています、DrawingBrushします。The following example shows how to use the caching hint option for a DrawingBrush.

DrawingBrush drawingBrush = new DrawingBrush();
            
// Set the caching hint option for the brush.
RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache);

// Set the minimum and maximum relative sizes for regenerating the tiled brush.
// The tiled brush will be regenerated and re-cached when its size is
// 0.5x or 2x of the current cached size.
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5);
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0);
         Dim drawingBrush As New DrawingBrush()

         ' Set the caching hint option for the brush.
         RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache)

         ' Set the minimum and maximum relative sizes for regenerating the tiled brush.
         ' The tiled brush will be regenerated and re-cached when its size is
         ' 0.5x or 2x of the current cached size.
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5)
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0)

注釈

既定では、WPFWPFの描画された内容をキャッシュしませんDrawingBrushVisualBrushオブジェクト。By default, WPFWPF does not cache the rendered contents of DrawingBrush and VisualBrush objects. ビデオ メモリが節約のため、内容も、シーン内のブラシの使用が変更される、静的なシナリオでは、特典を提供キャッシュしないとします。In static scenarios where neither the contents nor the use of the brush in the scene is changing, not caching provides a benefit because it conserves video memory. 既定の動作の静的でない方法で静的コンテンツをブラシを使用するときにWPFWPFブラシの内容全体を再表示するためには、コンテンツが変化しない場合でもすべてのフレーム。When a brush with static content is used in a non-static way, the default behavior of WPFWPF is to re-render the entire content of the brush every frame, even though the content is unchanging. たとえば、これは静的DrawingBrushまたはVisualBrush回転する 3D オブジェクトの表面にマップされます。For example, this will happen when a static DrawingBrush or VisualBrush is mapped to the surface of a rotating 3D object. 静的コンテンツを再レンダリング パフォーマンスに悪影響を及ぼすことができます。Re-rendering the static content can have a negative impact on performance.

設定して、CachingHint添付プロパティのキャッシュにブラシ、並べて表示されたブラシ オブジェクトのキャッシュされたバージョンを使用してパフォーマンスを向上できます。By setting the CachingHint attached property on the brush to Cache, you can increase performance by using cached versions of the tiled brush objects.

CacheInvalidationThresholdMinimumCacheInvalidationThresholdMaximumプロパティの値は、タイミングを決定する相対的なサイズ値、TileBrushスケールが変更されたのため、オブジェクトを再生成する必要があります。The CacheInvalidationThresholdMinimum and CacheInvalidationThresholdMaximum property values are relative size values that determine when the TileBrush object should be regenerated due to changes in scale. 設定してなど、 CacheInvalidationThresholdMaximum 2.0 では、キャッシュするプロパティ、TileBrushだけのサイズが現在のキャッシュのサイズの 2 倍を超えると、再生成する必要があります。For example, by setting the CacheInvalidationThresholdMaximum property to 2.0, the cache for the TileBrush only needs to be regenerated when its size exceeds twice the size of the current cache.

適用対象

こちらもご覧ください