Difference between a BitmapFrame and BitmapImage in WPF

Question

What is the difference between a BitmapFrame and BitmapImage in WPF? Where would you use each (ie. why would you use a BitmapFrame rather than a BitmapImage?)

Answer 1

You should stick to using the abstract class BitmapSource if you need to get at the bits, or even ImageSource if you just want to draw it.

The implementation BitmapFrame is just the object oriented nature of the implementation showing through. You shouldn't really have any need to distinguish between the implementations. BitmapFrames may contain a little extra information (metadata), but usually nothing but an imaging app would care about.

You'll notice these other classes that inherit from BitmapSource:

• BitmapFrame
• BitmapImage
• CachedBitmap
• ColorConvertedBitmap
• CroppedBitmap
• FormatConvertedBitmap
• RenderTargetBitmap
• TransformedBitmap
• WriteableBitmap

You can get a BitmapSource from a URI by constructing a BitmapImage object:

Uri uri = ...;
BitmapSource bmp = new BitmapImage(uri);
Console.WriteLine("{0}x{1}", bmp.PixelWIdth, bmp.PixelHeight);

The BitmapSource could also come from a decoder. In this case you are indirectly using BitmapFrames.

Uri uri = ...;
BitmapDecoder dec = BitmapDecoder.Create(uri, BitmapCreateOptions.None, BitmapCacheOption.Default);
BitmapSource bmp = dec.Frames[0];
Console.WriteLine("{0}x{1}", bmp.PixelWIdth, bmp.PixelHeight);

Answer 2

BitmapFrame is a low level primitive for image manipulation. It is usually used when you want to encode/decode some image from one format to another.

BitmapImage is more high level abstraction that has some neat data-binding properties (UriSource, etc).

If you are just displaying images and want some fine tuning BitmapImage is what you need.

If you are doing low level image manipulation then you will need BitmapFrame.