V5 fixes over 25 bugs (including memory leaks and wasteful RAM & IO usage) and introduces support for large images.
High-resolution images can now be cropped without sending the whole image to the browser; instead, a scaled, compressed version is used. This improves loading times by 2-20x and should make tablet/mobile support better. To enable, set ServerSideResizing=”true” and make 2 changes in web.config.
Image previews are much smoother, and now work even without a fixed aspect ratio, but you must set PreviewImageId to the ID of a server-side <div runat=”server”/> or <asp:Panel runat=”server” />. It cannot be the ID of an <img/> or <asp:Image /> control.
You can now force conversion to a specific image type with ForceImageFormat=”jpg/png/gif”. Tiff images are now automatically converted to Jpegs.
You can now specify a checkbox to enable fixed-aspect-ratio mode with the FixedAspectRatioCheckboxID=”id” property.
The properties X2 and Y2 are now readonly. Set W and H instead. This change prevents inconsistent X/X2/W and Y/Y2/H values, which was previously a common problem.
Users must now set FixedAspectRatio=”true” when setting ‘Ratio’. This breaking change was required to support FixedAspectRatioCheckboxID. PreviewImageId must be the server id of a Panel or Div, not an image.
Removed Cropped and Cropping events; they are now redundant as X,Y, W,H, X2, Y2 are properly updated on postback and can be modified before calling Crop().
IncludeJQuery property has been replaced by the JQueryInclude, JCropInclude, WebCropInclude, and JCropCssInclude properties and their associated enumerations. The default behavior for JQuery inclusion has changed to first attempt to use the Google CDN version, falling back to the embedded file. Other files default to WebResource.axd method. All behavior can be modified through the enumerations. You can even turn all (or individual) file inclusion off, and manually include the files for maximum control.