Merge branch 'zuul-mvc' into 'master'

Zuul Mvc

1 files changed, 372 insertions, 0 deletions

diff --git a/src/com/wordpress/tipsforjava/swing/StretchIcon.java b/src/com/wordpress/tipsforjava/swing/StretchIcon.java
new file mode 100644
index 0000000..667f1cd
--- /dev/null
+++ b/src/com/wordpress/tipsforjava/swing/StretchIcon.java
@@ -0,0 +1,372 @@
+/**
+ * @(#)StretchIcon.java 1.0 03/27/12
+ */
+package com.wordpress.tipsforjava.swing;
+
+import java.awt.Component;
+import java.awt.Container;
+import java.awt.Graphics;
+import java.awt.Image;
+import java.awt.Insets;
+import java.awt.image.ImageObserver;
+import java.net.URL;
+import javax.swing.ImageIcon;
+
+/**
+ * An <CODE>Icon</CODE> that scales its image to fill the component area,
+ * excluding any border or insets, optionally maintaining the image's aspect
+ * ratio by padding and centering the scaled image horizontally or vertically.
+ * <P>
+ * The class is a drop-in replacement for <CODE>ImageIcon</CODE>.
+ * <P>
+ * As the size of the Icon is determined by the size of the component in which
+ * it is displayed, <CODE>StretchIcon</CODE> must only be used in conjunction
+ * with a component and layout that does not depend on the size of the
+ * component's Icon.
+ * 
+ * @version 1.0 03/22/12
+ * @author Darryl
+ */
+public class StretchIcon extends ImageIcon {
+
+        /**
+         * Determines whether the aspect ratio of the image is maintained. Set to
+         * <code>false</code> to distort the image to fill the component.
+         */
+        protected boolean proportionate = true;
+
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         */
+        public StretchIcon(byte[] imageData) {
+                super(imageData);
+        }
+
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
+         * specified behavior.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         */
+        public StretchIcon(byte[] imageData, boolean proportionate) {
+                super(imageData);
+                this.proportionate = proportionate;
+        }
+
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param description
+         *            a brief textual description of the image
+         * 
+         * @see ImageIcon#ImageIcon(byte[], java.lang.String)
+         */
+        public StretchIcon(byte[] imageData, String description) {
+                super(imageData, description);
+        }
+
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
+         * specified behavior.
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param description
+         *            a brief textual description of the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(byte[], java.lang.String)
+         */
+        public StretchIcon(byte[] imageData, String description, boolean proportionate) {
+                super(imageData, description);
+                this.proportionate = proportionate;
+        }
+
+        /**
+         * Creates a StretchIcon from the image.
+         * 
+         * @param image
+         *            the image
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image)
+         */
+        public StretchIcon(Image image) {
+                super(image);
+        }
+
+        /**
+         * Creates a StretchIcon from the image with the specifiec behavior.
+         * 
+         * @param image
+         *            the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image)
+         */
+        public StretchIcon(Image image, boolean proportionate) {
+                super(image);
+                this.proportionate = proportionate;
+        }
+
+        /**
+         * Creates a StretchIcon from the image.
+         * 
+         * @param image
+         *            the image
+         * @param description
+         *            a brief textual description of the image
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
+         */
+        public StretchIcon(Image image, String description) {
+                super(image, description);
+        }
+
+        /**
+         * Creates a StretchIcon from the image with the specified behavior.
+         * 
+         * @param image
+         *            the image
+         * @param description
+         *            a brief textual description of the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
+         */
+        public StretchIcon(Image image, String description, boolean proportionate) {
+                super(image, description);
+                this.proportionate = proportionate;
+        }
+
+        /**
+         * Creates a StretchIcon from the specified file.
+         * 
+         * @param filename
+         *            a String specifying a filename or path
+         * 
+         * @see ImageIcon#ImageIcon(java.lang.String)
+         */
+        public StretchIcon(String filename) {
+                super(filename);
+        }
+
+        /**
+         * Creates a StretchIcon from the specified file with the specified
+         * behavior.
+         * 
+         * @param filename
+         *            a String specifying a filename or path
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(java.lang.String)
+         */
+        public StretchIcon(String filename, boolean proportionate) {
+                super(filename);
+                this.proportionate = proportionate;
+        }
+
+        /**
+         * Creates a StretchIcon from the specified file.
+         * 
+         * @param filename
+         *            a String specifying a filename or path
+         * @param description
+         *            a brief textual description of the image
+         * 
+         * @see ImageIcon#ImageIcon(java.lang.String, java.lang.String)
+         */
+        public StretchIcon(String filename, String description) {
+                super(filename, description);