ImageHandlerSyntax plugin

Adds support for the syntaxes used by 4 image resizing handlers. This plugin allows painless, gradual migration from them by supporting their URL syntax.

Supported projects



  1. Add <add name="ImageHandlerSyntax" /> to the <plugins /> section.

WebImageResizer compatibility status

As of V3.1, support has been added for all WebImageResizer querystring commands, all WebImageResizer encoding options, and all WebImageResizer file provider options. 100% URL compatibility has been added, and full feature parity (with improved performance and stability) is available when the DiskCache, SimpleFilters, WicEncoder, and FreeImageEncoder plugins are installed. However, unless you're doing grayscale or inversion, the only plugin you really need is the DiskCache.

Supports: src, width, height, format, greyscale, rotate, zoom, invert

To encode with WPF/WIC, add encoder=wic. To encode with FreeImage, add encoder=freeimage.

All normal commands are also supported, and all 27+ plugins can be used in combination with the ImageHandlerSyntax compatibility plugin.

If you have implemented an IImageProvider class for WebImageResizer, you will need to modify it to implement the IVirtualImageProvider interface instead.

Please report any compatibility issues or discrepancies between ImageHandlerSyntax and WebImageResizer.

This plugin (ImageHandlerSyntax plugin) is part of the Essential edition

Where is the plugins section?

The <plugins> section is located in Web.config, and is nested inside the <resizer> element, which is nested inside <configuration>. For examples, see this sample Web.config file.

Where can I find the dll?

We prefer that you install via NuGet, but you can also find the plugin DLL files in the /dlls/release folder of your download.

How do I typically install a plugin via Web.Config?

  1. In Visual Studio, right click on your project and choose "Add reference". Browse to the plugin DLL and click "OK".
  2. In the <plugins> section of Web.config, insert <add name="PluginName" />
  3. Look at the plugin documentation to see what configuration options (if any) are available.

How do I typically install a plugin via code?