WPF Perf: RenderCapability.Tier & DesiredFrameRate

In this post, I’m going to talk about two key API’s for performance in WPF.  These are RenderCapability.Tier and Storyboard.DesiredFrameRate.  In this post, I’m going to show:


  1. How to leverage RenderCapability.Tier to scale your app up or down.
  2. How to use RenderCapability.Tier in markup.
  3. How to apply DesiredFrameRate to reduce CPU consumption.


For the machine on which it’s run, RenderCapability.Tier signals the machine’s hardware capabilities.  Tier=0 means software rendering; Tier=2 is hardware rendering (for those features that can be rendered in hardware); Tier=1 is a middle ground (some things in hardware and some in software.)  You can probably see how this might be useful to scale up or down the richness of an application depending on the hardware.


(Note: RenderCapability.Tier is an integer value using the high word to indicate the tier.  You’ll need to shift by 16 bits to get the corresponding tier values.  Adam Smith posts about why this was chosen.)


The second API I mentioned was Storyboard.DesiredFrameRate (DFR.)  DFR allows you to specify, manually, what the frame rate “should” be (the animation system attempts to get as close as possible to the DFR value but there are no guarantees.)  By default, WPF attempts 60 fps.  The up side to this is that animations look better; the down side is that you may not need 60 fps but you may be spending the extra CPU cycles.

Putting Them Together

You can use RenderCapability.Tier in markup with a small helper class.  The trick is to wrap up the property in a DependencyProperty.  From there, the property can be used to set DFR.  Below, you’ll find both the code for the RenderCapability.Tier, how to use it in markup and how to set DesiredFrameRate.  I picked different DFR values for the different Tiers.  The resulting UI isn’t that exciting (a spinning Button) but it demonstrates the concept.


using System;

using System.Windows;

using System.Windows.Media;


namespace PerformanceUtilities


    public static class RenderCapabilityWrapper


        public static readonly DependencyProperty TierProperty =





                new PropertyMetadata(RenderCapability.Tier >> 16));


        public static int GetTier(DependencyObject depObj)


            return (int)TierProperty.DefaultMetadata.DefaultValue;














    <Style x:Key={x:Type Button} TargetType={x:Type Button}>



        Property=Perf:RenderCapabilityWrapper.Tier Value=2>

          <Setter Property=Tag Value=60/>



        Property=Perf:RenderCapabilityWrapper.Tier Value=1>

          <Setter Property=Tag Value=30/>



        Property=Perf:RenderCapabilityWrapper.Tier Value=0>

          <Setter Property=Tag Value=15/>







  <Button Width=80 Height=80 Name=MyButton

  Content={Binding RelativeSource={RelativeSource Self}, Path=Tag}>


      <EventTrigger RoutedEvent=FrameworkElement.Loaded>


          <Storyboard RepeatBehavior=Forever

          Storyboard.DesiredFrameRate={Binding ElementName=MyButton,






            From=0.0 To=360 Duration=0:0:10 />







      <RotateTransform CenterX=40 CenterY=40







Comments (2)

  1. To avoid disappointing users after they&#39;ve gotten as far as running your application on their 1997