IXRBitmapCache (Compact 2013)

Article
04/19/2017

3/28/2014

This class stores information about graphics hardware acceleration.

Syntax

class IXRBitmapCache : public IXRCacheMode

Inheritance Hierarchy

IXRDependencyObject

IXRCacheMode

IXRBitmapCache

Methods

Method	Description
IXRBitmapCache::GetRenderAtScale	Retrieves a multiplier value that indicates the amount by which to scale the size of the cached UI element when it is displayed.
IXRBitmapCache::SetRenderAtScale	Sets a multiplier value that indicates the amount by which to scale the size of the cached UI element when it is displayed.

Thread Safety

Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.

Remarks

If the DirectDraw or OpenGL plug-in renderer is included in the run-time image, objects that derive from IXRUIElement can request support for hardware-accelerated graphics from the DirectDraw renderer by passing an IXRBitmapCache object into IXRUIElement::SetCacheMode. Then, when your application runs on a Windows Embedded Compact powered device, the bitmaps that define the appearance of the UI element are processed by the Graphics Processing Unit (GPU), rendered by using hardware acceleration, and cached in video memory. This improves the stability and performance of the graphics environment for bitmaps.

You can use bitmap caching for a UI element if it implements one of the following features:

Transformations (such as translating, rotating, or stretching)
Clipping
Blending
Resources or child objects that are animation storyboards

When you create a class instance, use an IXRBitmapCachePtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.

.NET Framework Equivalent

None.

Requirements

Header	XamlRuntime.h
sysgen	SYSGEN_XAML_RUNTIME