Image Resizer

WIC Plugins (V3.1+)

ImageResizer.Plugins.Wic.dll contains 3 plugins: WicImageDecoder, WicImageEncoder, and WicImageBuilder.

These plugins require Windows 7 or Windows Server 2008 R2 for best performance and correct behavior.

Vista or Windows Server 2008 with the Platform Update applied should also work.

Installation

  1. Either run Install-Package ImageResizer.Plugins.Wic in the NuGet package manager, or add ImageResizer.Plugins.Wic.dll to your project
  2. Add <add name="WicDecoder" /> inside the <plugins> section of Web.config.
  3. Add <add name="WicEncoder" /> inside the <plugins> section of Web.config.
  4. Add <add name="WicBuilder" /> inside the <plugins> section of Web.config.

WicDecoder

Supports decoding images through WIC, supporting any image codecs installed on the computer. When combined with a codec pack, can open RAW files.

Activate with &decoder=wic.

  • page=1..?
  • frame=1..?

WicEncoder

Encode jpeg, gif, and png images through WIC for better performance and more control. Adjust jpeg quality, subsampling, gif dithering, and palette size.

Vs. PrettyGifs: 3-8x faster for encoding 8-bit PNG images. 2-5x faster for GIF images.

Activate with &encoder=wic

  • quality = 0..100
  • subsampling=444|422|420
  • dither=false|true (default is true, unlike PrettyGifs)
  • colors=2..256

WicBuilder

Provides a completely alternate pipeline, which supports most basic resize/crop/pad operations.

2-4x faster than the default pipeline. Slightly reduced image quality.

Activate with &builder=wic

Select the resizing filter with w.filter=fant|bicubic|linear|nearest

Supported settings

  • page=1..?
  • frame=1..?
  • width
  • height
  • mode=max|pad|crop
  • scale
  • maxwidth
  • maxheight
  • crop
  • bgcolor
  • margin
  • quality
  • subsampling
  • dither
  • colors

License

This set of plugins is part of the Design bundle, and licensed accordingly.

This plugin (WIC Plugins (V3.1+)) is part of the Creative 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?