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 、およびVisualBrushオブジェクトのDrawingBrush表示内容はキャッシュされません。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.

適用対象

こちらもご覧ください