/**
* 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);
}
}
}