DynamicImage is a high-performance image manipulation library for ASP.NET
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


For the latest version, head over to tgjones/dynamic-image.

DynamicImage, from Sound in Theory Ltd

This is the source code repository for DynamicImage, an open source image manipulation library for ASP.NET. DynamicImage helps you simplify the way you deal with images in your ASP.NET websites.


DynamicImage allows images to be created in two ways:

  1. Programmatically, using the object model:

     Composition composition = new Composition();
     composition.Layers.Add(new ImageLayer
     	SourceFileName = "~/Assets/Images/AutumnLeaves.jpg",
     	Filters =
     		new ResizeFilter { Width = Unit.Pixel(800), Mode = ResizeMode.UseWidth }
     composition.Layers.Add(new TextLayer
     	Text = "Hello World",
     	Filters =
     		new OuterGlowFilter()
     string url = ImageUrlGenerator.GetImageUrl(composition);
  2. Programmatically, using a fluent interface:

     string imageUrl = new CompositionBuilder()
     	.WithLayer(LayerBuilder.Text.Text("Hello World")


Images in DynamicImage are composed of one or more layers, and each layer can have zero or more filters applied. DynamicImage includes several built-in layer types, and it is straightforward to create your own.

  • Image Layer
  • Fractal Layer (Julia and Mandelbrot)
  • Polygon Shape Layer
  • Rectangle Shape Layer
  • Text Layer

Image Sources

Image Layers accept input from a variety of sources, and it is also straightforward to write your own ImageSource. The image sources included with DynamicImage let you load images from:

  • Raw bytes
  • Binary database field
  • File
  • System.Windows.Media.Imaging.BitmapSource object


Filters are applied to layers to modify them in some way. DynamicImage provides more than 15 filters you can apply to your images, including:

  • Brightness Adjustment
  • Clipping Mask
  • Colour Key
  • Colour Tint
  • Contrast Adjustment
  • Crop
  • Distort Corners
  • Drop Shadow
  • Emboss
  • Feather
  • Gaussian Blur
  • Grayscale
  • Inversion
  • Opacity Adjustment
  • Outer Glow
  • Resize
  • Rotation
  • Sepia
  • Shiny Floor


Output images can be cached, based on settings in web.config. You can write your own cache provider, and the built-in cache providers are:

  • In-memory
  • XML file


DynamicImage uses Windows Presentation Foundation (WPF) internally for bitmap manipulation. Most of the filters are written as WPF shader effects, which are compiled into fast SSE instructions, and run with good performance in a server environment.

DynamicImage is made available to the community by Sound in Theory Ltd, a web design company based in Exeter, United Kingdom.

Sound in Theory Ltd