Share via


IXRBitmapCache (Compact 2013)

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

See Also

Reference

Classes for Application Management
IXRTransform
IXRUIElement::SetClip
IXRGradientStop
IXRStoryboard