Download source, binaries, plugins, and sample code (15MB) or Download core binary only (170K)
Note: this release has a compatibility issue with .NET 4 and VB.NET. Use 3.2.1 instead.
This is an alpha release containing heavy refactoring. Hundreds of changes were made to more than 258 code files. While the changes were quadruple-checked, there may still be some bugs.
Be the first to report a given bug to [email protected] and claim the bounty! The best place to look for bugs is probably in querystring parsing, or the newly added Instructions class.
Note for NuGet users: The latest ImageResizer.WebConfig package may insert a duplicate element in Web.config. Simply delete the one that doesn't include
<section name="resizer" type="ImageResizer.ResizerSection"/> <section name="resizer" type="ImageResizer.ResizerSection" requirePermission="false"/>
Known bugs still in this release
- S3Reader has concurrency issues when accessing S3 buckets over SSL. This issue existed in previous releases. The temporary workaround is to only use public buckets with SSL disabled. The next release will migrate from LitS3 to AWSSDK to avoid this and potentially other undiscovered issues.
What didn't make the cut, but was expected to
- URL Builder API & MVC URL/HTML helpers; I need more users to volunteer for private beta testing before I can publish this kind of API. Please e-mail your Github username to
[email protected]if you can volunteer.
- GetCurrentConfig - multi-tenanting support for Umbraco & Orchard.
Bug fixes in Core (ImageResizer.dll)
- Fixed background transparency bug when using
s.alphaon a jpeg image.
- Fixed bug where specifying both
maxheightwould cause 'mode' to be ignored, assuming it to be 'max'.
- Fixed bug where ResponseHeaders wouldn't convert LastModified value to UTC before checking against UTCNow, triggering an ArgumentException from the ASP.NET framework for invalid modified dates. (Usually, from SqlReader)
- Fixed Diagnostics page false error:
Virtual path outside of the current application is not supported.
Bug fixes in plugins
- Watermark: Fixed
InvalidOperationException: Object is currently in use elsewhere.issue.
- WhitespaceTrimmer: Upgraded to hotfix release of AForge, fixes AccessViolationException
- WIC: Fixed GC bug (underlying bytes were being disposed before WIC had finished reading them).
- SqlReader now assumes SQL modified dates are UTC instead of server-local. Bug effects: items with a modified date don't get cached until they are X hours old, where X is the time zone offset.
- SqlReader: Changed behavior - If UntrustedData is set, RequireImageExtension automatically becomes false to prevent recoding circumvention.
- All datasource plugins now support multiple instances
- SeamCarving: now triggered by just &mode=carve, both &mode=carve and &carve=true are not required.
Major changes to Core
- All querystring parsing is now handled through
ImageResizer.Util.Utils. Update your custom plugins.
- All stream copying is now handled through
- Enumeration parsing and serialization is now handled through
ImageResizer.ExtensionMethods, to allow support for alternate (yet unlisted) variants for given values, and for custom serialization preferences.
ImageResizer.Util.ParseUtilswas introduced to restore
System.Drawing.Colorparsing and serialization, and it contains some aliases to NameValueCollectionExtensions.
- System.Drawing dependencies are being minimized. Introduced enumerations
JpegSubsamplingMode, and class
- The new MVC-friendly
Instructionsclass is replacing
ResizeSettings, and adding support for more of the available commands. The two are easily convertible via their constructors:
new ResizeSettings(new Instructions())or
new Instructions(new ResizeSettings).
- CLSCompliant has been set to false for the ImageResizer.dll assembly. While it's generally CLS compliant, some protected members don't qualify. I don't expect this change to have any ill effects.
- Implemented new rendering stage, PreRenderImage (and matching ImageState.preRenderBitmap variable). This stage permits 'mid-resizing' operations to take place in a chained manner, like seam carving, FreeImageResizing, Red-eye removal, etc.
- Added support for source file caching plugins, via
- Added support for opt-in automatic native dependency installation with the new
NativeDependencyManagerclass and the
NativeDependenciesAttributeassembly attribute. Extremely useful for PdfRenderer, RedEye, Faces, and FreeImage plugins.
- Removed ImageResizer.X, ImageResizer.Plugins.X, and ImageResizer.Plugins.Pro.X class location patterns. I.E, you can no longer specify
<add name="Plugins.DiskCache.DiskCachePlugin" />or
<add name="DiskCache.DiskCachePlugin" />, only
<add name="DiskCache" />or
<add name="ImageResizer.Plugins.DiskCache.DiskCachePlugin" />.
- Added ResponseArgs.GetSourceImage so plugins can override the entire processing method to, say, return JSON instead of an encoded image.
Minor changes to Core
- PathUtils now (generally) supports parsing URLs with fragments
- PathUtils.ParseQueryStringFriendly no longer assumes a path is a querystring unless it contains '='.
- Renamed PathUtils.FromBase64UToButes to FromBase64UToBytes
- Removed stub 'Caption' plugin and legacy FriendlyUrls plugin (now called FolderResizeSyntax).
- Querystring commands that accept comma-delimited lists: leading and trailing commas are now ignored, they no longer indicate 'empty' slots.
Minor additions to Core
- Introduced ImageResizer.Util.ParseUtils as a replacement for certain Obsolete Utils methods.
- Added Plugins.GetOrInstall
- Added Plugins/ImageStudio stub project.
- Added AWSSDK, Newtonsoft.Json, and OpenCVSharp to Plugins/Libs
Marked obsolete in Core
- ImageResizer.Util.Utils (moved to extension methods and ParseUtils)
- ImageResizer.Util.StreamUtils (moved to extension methods)
- ImageResizer.Util.UrlHasher (moved to DiskCache)
- ImageResizer.StretchMode (Use FitMode.Stretch instead)
- ImageResizer.CropMode (Use FitMode.Crop instead)
- ImageResizer.CropUnits (Use cropxunits and cropyunits instead)
- ImageResizer.ResizeSettings was not marked obsolete, but will be in a future release. Time to start using Instructions.cs
This release includes the following new draft plugins: RedEye, DiskCache\SourceMemCache, ImageInfoAPI, Encrypted, and Samples\CustomOverlayPlugin. These plugins are not yet alpha, and will be changing before their final release.
- Changed the way blur/a.blur, sharpen/a.sharpen, a.removnoise, and a.oilpainting values are interpreted - With this release, your existing images may become slightly blurrier or sharper if you use these commands. This change was only made after consulting all registered users of the plugin. This change makes the specified radius values percentages of the image size. This will allow &blur=5 to have the same effect regardless of the image size, as expected. To be exact, the value will be interpreted as 1/1000ths of the smaller of the image width and height. This provides both granularity and very good consistency.
- Now supports multiple instances
- Added SourceMemCache plugin prototype to DiskCache.dll.
- Now supports downloadNativeDependencies="true" auto-install!
- FreeImageResizer now supports PreRenderImage system
- Now supports multiple instances and IVirtualFileSourceCacheKey.
- Now ignores requests where an alternate decoder is requested, and always attempts decoding with
- Alpha version released - supports JSON API for eye detection, URL API for correction.
- Added support for extension-less remote URLs.
- Added support for IVirtualFileSourceCacheKey.
- Added alpha support for XML-defined URL pattern whitelisting. (Needs testing)
- Added support for IVirtualFileSourceCacheKey
- Added support for multiple instances
- Added alpha support for RequireImageExtension, CacheUnmodifiedFiles, and UntrustedData settings
- Added alpha support for manual object removal/preservation with carve.data, LZW/custom dictionary-derived compressed block array.
- Implementation not fully complete.
- Added Plugins/Security project
- Added first draft of the Encrypted plugin
- Added draft support for
s.roundcornerscommand, supporting single and individual radii.
- Added multi-instance support
- SqlReader: Added checkForModifiedFiles setting - (eliminates per-request DB hit when false).
- Fixed bug: SqlReader now assumes SQL modified dates are UTC instead of server-local. Bug effects: items with a modified date don't get cached until they are X hours old, where X is the time zone offset.
- Changed behavior - If UntrustedData is set, RequireImageExtension automatically becomes false.
- Fixed bug: InvalidOperationException: Object is currently in use elsewhere.
- Eliminated use of AForge.UnamangedImage, which seems to have solved some memory consistency issues.
- Got hotfix from AForge author to solve AccessViolationExceptions.
- Now supports downloadNativeDependencies="true" auto-install!
- Resizer 4.1.9 - Jun-22-2017 - Important fix for constant CPU use
- Resizer 4.1.8 - Jun-17-2017 - 2 bug fixes
- Resizer 4.1.7 - Jun-6-2017 - 166 commits
- Resizer 4.0.5 - Jan-31-2016 - 3 bug fixes
- Resizer 4.0.4 - Oct 25 2015 - Major release with security and massive performance improvements
- Resizer 3.4.3 - May 8 2014 - New release adds metadata copy support, fixes 4 bugs.
- Resizer 3.4.2 - November 26 2013 - New Release adds support for AWSSDK 2
- Resizer 3.4.1 - October 30 2013 - New release features 1 bug fix and 1 enhancement.
- Resizer 3.4.0 - October 17 2013 - New release comes with 4 new plugins and 11 bug fixes.
- Resizer 3.3.3 - March 2 2013 - 2 bug fixes, one in S3Reader, one in WicDecoder
- Resizer 3.3.2 - Jan 24 2013 - 2 bug fixes
- Resizer 3.3.1 - Dec 19 2012 - 8 bug fixes, 1 new plugin
- Resizer 3.3.0 - Dec 3 2012 - 10 bug fixes, 2 new filters, 2 new alpha plugins
- Resizer 3.2.4 - Aug 6 2012 - 7 bug fixes, S3Reader changes, 2 new alpha plugins
- Resizer 3.2 beta 3 - June 30 2012 - 4 bug fixes
- Resizer 3.2 beta 2 - June 20 2012 - 3 bug fixes
- Resizer 3.2 alpha 1 - June 4 2012 - 1 bug fix
- Resizer 3.2 alpha 0 - June 3 2012 - 11 bug fixes (reliability improvements in WicBuilder, Watermark, WhitespaceTrimmer, SqlReader), heavy refactoring, 5 new draft plugins
- Resizer 3.1.5 - Feb 22 2012 - 19 bug fixes, 8 new features, 2 potentially breaking changes
- Resizer 3.1.4 - Jan 22 2012 - 5 bug fixes, 2 minor new features
- Resizer 3.1.3 - Jan 14 2012 - 2 new free plugins, 7 bug fixes
- Resizer 3.1 alpha 2 - Dec 7 2011 - 5 new free plugins, 6 new bundle plugins, 5 rewritten plugins, and innumerable bug fixes
- Resizer 3.0.13 - Oct 12 2011 - 6 bug fixes, raw support, and 1 breaking change (renaming the FriendlyUrls plugin)
- Resizer 3.0.12 - Aug 15 2011 - 12 bug fixes, 10 new features, 3 new plugins since 3.0.11
- Resizer 3.0.11 - July 29 2011 - 5 bug fixes and 2 new plugins since alpha 10
- Resizer 3 alpha 10 - Jun 16 2011 -
- Resizer 3 alpha 9 - Jun 8 2011 - 8 bug fixes and 8 new features
- Resizer 3 alpha 8 - Jun 2 2011 - 4 core bug fixes, 2 new sample projects, and the important fixes to the DiskCache, SqlReader, and AnimatedGifs plugins
- Resizer 2.8 - May 27 2011 - The last build of the version 2 line.
- Resizer 3 alpha 7 - May 26 2011 - 3 stability fixes, jCrop support, COM support, better diagnostics.
- Resizer 3 alpha 5 - May 15 2011 - 7 bug fixes, 5 API changes, and 3 new plugins
- Resizer 3 alpha 3 - May 2 2011 -
- Resizer 3 alpha 2 - Apr 24 2011 -