source: josm/src/org/openstreetmap/josm/tools/ImageProvider.java@ 79

package org.openstreetmap.josm.tools;

import java.awt.Graphics;
import java.awt.GraphicsConfiguration;
import java.awt.GraphicsEnvironment;
import java.awt.Image;
import java.awt.Toolkit;
import java.awt.Transparency;
import java.awt.image.BufferedImage;
import java.net.URL;
import java.util.HashMap;
import java.util.Map;

import javax.swing.Icon;
import javax.swing.ImageIcon;

import org.openstreetmap.josm.Main;

/**
 * Helperclass to support the application with images.
 * @author imi
 */
public class ImageProvider {

        /**
         * Position of an overlay icon
         * @author imi
         */
        public final static class OverlayPosition {
                private OverlayPosition() {}
                public static OverlayPosition NORTHWEST = new OverlayPosition();
                public static OverlayPosition NORTHEAST = new OverlayPosition();
                public static OverlayPosition SOUTHWEST = new OverlayPosition();
                public static OverlayPosition SOUTHEAST = new OverlayPosition();
        }
        
        
        /**
         * The icon cache
         */
        private static Map<URL, Image> cache = new HashMap<URL, Image>();
        
        /**
         * Return an image from the specified location.
         *
         * @param subdir        The position of the directory, e.g. "layer"
         * @param name          The icons name (without the ending of ".png")
         * @return The requested Image.
         */
        public static ImageIcon get(String subdir, String name) {
                if (subdir != "")
                        subdir += "/";
        String ext = name.indexOf('.') != -1 ? "" : ".png";
                URL path = Main.class.getResource("/images/"+subdir+name+ext);
                if (path == null)
                        throw new NullPointerException("/images/"+subdir+name+ext+" not found");
                Image img = cache.get(path);
                if (img == null) {
                        img = Toolkit.getDefaultToolkit().createImage(path);
                        cache.put(path, img);
                }
                return new ImageIcon(img);
        }

        /**
         * Shortcut for get("", name);
         */
        public static ImageIcon get(String name) {
                return get("", name);
        }

        /**
         * Return an icon that represent the overlay of the two given icons. The
         * second icon is layed on the first relative to the given position.
         *
         * @param ground The ground icon (base)
         * @param overlay The icon to put on top of the ground (overlay)
         * @return The merged icon.
         */
        public static Icon overlay(Icon ground, Icon overlay, OverlayPosition pos) {
                GraphicsConfiguration conf = GraphicsEnvironment.getLocalGraphicsEnvironment().getDefaultScreenDevice().getDefaultConfiguration();
                int w = ground.getIconWidth();
                int h = ground.getIconHeight();
                int wo = overlay.getIconWidth();
                int ho = overlay.getIconHeight();
                BufferedImage img = conf.createCompatibleImage(w,h, Transparency.TRANSLUCENT);
                Graphics g = img.createGraphics();
                ground.paintIcon(null, g, 0, 0);
                int x = 0, y = 0;
                if (pos == OverlayPosition.NORTHWEST) {
                        x = 0;
                        y = 0;
                } else if (pos == OverlayPosition.NORTHEAST) {
                        x = w-wo;
                        y = 0;
                } else if (pos == OverlayPosition.SOUTHWEST) {
                        x = 0;
                        y = h-ho;
                } else if (pos == OverlayPosition.SOUTHEAST) {
                        x = w-wo;
                        y = h-ho;
                }
                overlay.paintIcon(null, g, x, y);
                return new ImageIcon(img);
        }
}