Added support for fitting images to a width or height regardless of orientation.

Added test cases for all new ops and updated README.

Author: Riyad Kalla

README

@@ -94,12 +94,16 @@ down-sizes images for use as thumbnails (along with some additional minor
 optimizations).
 
 imgscalr also provides support for applying arbitrary BufferedImageOps against
-resultant images directly in the library and provides defaults out of the box
-for common, hardware-accelerated options like applying a light "anti-aliasing"
-filter to the results.
+resultant images directly in the library.
+
+TIP: imgscalr provides a default "anti-aliasing" Op that will very lightly soften
+an image; this was a common request. Check Scalr.OP_ANTIALIAS
 
 TIP: All resizing operations maintain the original images proportions.
 
+TIP: You can ask imgscalr to fit an image to a specific width or height regardless 
+of its orientation using a Mode argument.
+
 This class attempts to make scaling images in Java as simple as possible by providing
 a handful of approaches tuned for scaling as fast as possible or as best-looking 
 as possible and the ability to let the algorithm choose for you to optionally create 
@@ -122,6 +126,43 @@ and write out the scaled result immediately to a single line:
   ImageIO.write(Scalr.resize(ImageIO.read(...), 150));
 
 
+Working with GIFs
+-----------------
+Java's support for writing GIF is... terrible. In Java 5 is was patent-encumbered
+which made it mostly totally broken. In Java 6 the quantizer used to downsample
+colors to the most accurate 256 colors was fast but inaccurate, yielding 
+poor-looking results. The handling of an alpha channel (transparency) while writing
+out GIF files (e.g. ImageIO.write(...)) was non-existent in Java 5 and in Java 6
+would remove the alpha channel completely and replace it with solid BLACK.
+
+In Java 7, support for writing out the alpha channel was added but unfortunately
+many of the remaining image operations (like ConvoleOp) still corrupt the
+resulting image when written out as a GIF.
+
+NOTE: Support for scaling animated GIFs don't work at all in any version.
+
+My recommendation for working with GIFs is as follows in order of preference:
+
+1. Save the resulting BufferedImage from imgscalr as a PNG; it looks
+better as no quantizer needs to be used to cull down the color space and 
+transparency is maintained. 
+
+2. If you mostly need GIF, check the resulting BufferedImage.getType() to see
+if it is TYPE_INT_RGB (no transparency) or TYPE_INT_ARGB (transparency); if the
+type is ARGB, then save the image as a PNG to maintain the alpha channel, if not,
+you can safely save it as a GIF.
+
+3. If you MUST have GIF, upgrade your runtime to Java 7 and save your images as
+GIF. If you run Java 6, any GIF using transparency will have the transparent
+channel replaced with BLACK and in Java 5 I think the images will most all be
+corrupt/invalid.
+
+REMINDER: Even in Java 7, applying some BufferedImageOps (like ConvolveOp) to
+the scaled GIF before saving it totally corrupts it; so you would need to avoid
+that if you didn't want to save it as a PNG. If you decide to save as a PNG, you
+can apply any Ops you want.
+ 
+
 Troubleshooting
 ---------------
 Image-manipulation in Java can take more memory than the size of the source image