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

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 static enum OverlayPosition {NORTHWEST, NORTHEAST, SOUTHWEST, SOUTHEAST}
        
        /**
         * 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.
         */
        public static Icon overlay(Icon ground, String overlayImage, OverlayPosition pos) {
                GraphicsConfiguration conf = GraphicsEnvironment.getLocalGraphicsEnvironment().getDefaultScreenDevice().getDefaultConfiguration();
                int w = ground.getIconWidth();
                int h = ground.getIconHeight();
                ImageIcon overlay = ImageProvider.get("overlay",overlayImage);
                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;
                switch (pos) {
                case NORTHWEST:
                        x = 0;
                        y = 0;
                        break;
                case NORTHEAST:
                        x = w-wo;
                        y = 0;
                        break;
                case SOUTHWEST:
                        x = 0;
                        y = h-ho;
                        break;
                case SOUTHEAST:
                        x = w-wo;
                        y = h-ho;
                        break;
                }
                overlay.paintIcon(null, g, x, y);
                return new ImageIcon(img);
        }
}