/** * Copyright (c) 2013-2016 Angelo ZERR. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * Angelo Zerr <angelo.zerr@gmail.com> - initial API and implementation */ package tern.eclipse.ide.tools.internal.ui; import java.net.URL; import java.util.HashMap; import java.util.Map; import org.eclipse.jface.resource.ImageDescriptor; import org.eclipse.jface.resource.ImageRegistry; import org.eclipse.swt.graphics.Image; /** * Utility class to handle image resources. */ public class ImageResource { // the image registry private static ImageRegistry imageRegistry; // map of image descriptors since these // will be lost by the image registry private static Map<String, ImageDescriptor> imageDescriptors; // base urls for images private static URL ICON_BASE_URL; private static final String URL_WIZBAN = "full/wizban/"; // Wizban public static final String IMG_NEWPLUGIN_WIZ = "newplugin_wiz"; public static final String IMG_NEWTYPEDEF_WIZ = "newtypedef_wiz"; static { try { String pathSuffix = "icons/"; ICON_BASE_URL = TernToolsUIPlugin.getDefault().getBundle() .getEntry(pathSuffix); } catch (Exception e) { Trace.trace(Trace.SEVERE, "Images error", e); } } /** * Cannot construct an ImageResource. Use static methods only. */ private ImageResource() { // do nothing } /** * Dispose of element images that were created. */ protected static void dispose() { // do nothing } /** * Return the image with the given key. * * @param key * java.lang.String * @return org.eclipse.swt.graphics.Image */ public static Image getImage(String key) { return getImage(key, null); } /** * Return the image with the given key. * * @param key * java.lang.String * @return org.eclipse.swt.graphics.Image */ public static Image getImage(String key, String keyIfImageNull) { if (imageRegistry == null) initializeImageRegistry(); Image image = imageRegistry.get(key); if (image == null) { if (keyIfImageNull != null) { return getImage(keyIfImageNull, null); } imageRegistry.put(key, ImageDescriptor.getMissingImageDescriptor()); image = imageRegistry.get(key); } return image; } /** * Return the image descriptor with the given key. * * @param key * java.lang.String * @return org.eclipse.jface.resource.ImageDescriptor */ public static ImageDescriptor getImageDescriptor(String key) { if (imageRegistry == null) initializeImageRegistry(); ImageDescriptor id = imageDescriptors.get(key); if (id != null) return id; return ImageDescriptor.getMissingImageDescriptor(); } /** * Initialize the image resources. */ protected static void initializeImageRegistry() { imageRegistry = TernToolsUIPlugin.getDefault().getImageRegistry(); imageDescriptors = new HashMap<String, ImageDescriptor>(); // Wizban registerImage(IMG_NEWPLUGIN_WIZ, URL_WIZBAN + "newplugin_wiz.png"); registerImage(IMG_NEWTYPEDEF_WIZ, URL_WIZBAN + "newtypedef_wiz.png"); } /** * Register an image with the registry. * * @param key * java.lang.String * @param partialURL * java.lang.String */ private static void registerImage(String key, String partialURL) { try { ImageDescriptor id = ImageDescriptor.createFromURL(new URL( ICON_BASE_URL, partialURL)); imageRegistry.put(key, id); imageDescriptors.put(key, id); } catch (Exception e) { Trace.trace(Trace.SEVERE, "Error registering image " + key + " from " + partialURL, e); } } }