Share via


EnableCacheVisualization (Silverlight Plug-in Object)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that indicates whether to use a non-production analysis visualization mode, which shows areas of a page that are not being GPU accelerated with a colored overlay. Do not use in production code.

Syntax

object Element

<object ...>
  <param name="enableCacheVisualization" value="true"/>
  ...
</object>
NoteNote:

By default, cache visualization is disabled. You set enableCacheVisualization to true if you want to enable cache visualization.

Silverlight.js

If used for initialization, you must use the createObjectEx method's JSON notation. You set the EnableCacheVisualization property in the Settings object.

JavaScript

value = silverlightObject.settings.enableCacheVisualization;

COM

Not available.

Managed Code

Remarks

Important noteImportant Note:

   Do not enable cache visualization in production code.

To visualize areas in your UI that are GPU accelerated, you must also enable GPU acceleration and set the cache mode for specific objects. To enable GPU acceleration, set EnableGPUAcceleration (Silverlight Plug-in Object) to true (in a param of the object tag). You can also set the OutOfBrowserSettings.EnableGPUAcceleration property for out-of-browser applications, but not through the property itself. For more information, see How to: Configure an Application for Out-of-Browser Support.

To set the cache mode, set the CacheMode property on specific objects that might invoke the GPU acceleration path for rendering.

Each texture being rendered in software (and thus not receiving benefit from hardware acceleration) is rendered with a colored overlay. Different texture layers might have different colors. The particular color of a given layer has no significance; this debug render mode simply chooses a different color for each new layer so that they can be separately visualized.