eu.etaxonomy.taxeditor.store/src/main/java/eu/etaxonomy/taxeditor/model/ImageResources.java

   1 /**
   2 * Copyright (C) 2007 EDIT
   3 * European Distributed Institute of Taxonomy
   4 * http://www.e-taxonomy.eu
   5 *
   6 * The contents of this file are subject to the Mozilla Public License Version 1.1
   7 * See LICENSE.TXT at the top of this package for the full license terms.
   8 */
   9
  10 package eu.etaxonomy.taxeditor.model;
  11
  12 import java.net.MalformedURLException;
  13 import java.net.URI;
  14 import java.net.URL;
  15
  16 import org.eclipse.core.runtime.FileLocator;
  17 import org.eclipse.core.runtime.IPath;
  18 import org.eclipse.core.runtime.Path;
  19 import org.eclipse.jface.resource.DeviceResourceException;
  20 import org.eclipse.jface.resource.ImageDescriptor;
  21 import org.eclipse.jface.resource.ImageRegistry;
  22 import org.eclipse.swt.graphics.Image;
  23
  24 import eu.etaxonomy.taxeditor.store.StoreUtil;
  25 import eu.etaxonomy.taxeditor.store.internal.TaxeditorStorePlugin;
  26
  27 /**
  28  * <p>ImageResources class.</p>
  29  *
  30  * @author n.hoffmann
  31  * @created 24.03.2009
  32  * @version 1.0
  33  */
  34 public class ImageResources {
  35
  36         private static ImageResources instance;
  37
  38         /**
  39          * <p>Getter for the field <code>instance</code>.</p>
  40          *
  41          * @return a {@link eu.etaxonomy.taxeditor.model.ImageResources} object.
  42          */
  43         public static ImageResources getInstance(){
  44                 if(instance == null){
  45                         instance = new ImageResources();
  46                 }
  47                 return instance;
  48         }
  49
  50
  51         /* ***************************************************************************************
  52         ICONS
  53         ************************************************************************************** */
  54         /** Constant <code>ADD_ICON="add_icon"</code> */
  55         public static final String ADD_ICON = "add_icon";
  56         /** Constant <code>TRASH_ICON="trash_icon"</code> */
  57         public static final String TRASH_ICON = "trash_icon";
  58         /** Constant <code>BROWSE_ICON="browse_icon"</code> */
  59         public static final String BROWSE_ICON = "browse_icon";
  60         /** Constant <code>EDIT_ICON="edit_icon"</code> */
  61         public static final String EDIT_ICON = "edit_icon";
  62         /** Constant <code>EDIT_LOGO_ICON="edit_logo_icon"</code> */
  63         public static final String EDIT_LOGO_ICON = "edit_logo_icon";
  64         /** Constant <code>WARNING_ICON="warning_icon"</code> */
  65         public static final String WARNING_ICON = "warning_icon";
  66         /** Constant <code>BLACK_SQUARE_ICON="black_square_icon"</code> */
  67         public static final String BLACK_SQUARE_ICON = "black_square_icon";
  68         /** Constant <code>HOMOTYPIC_SYN_ICON="homotypic_syn_icon"</code> */
  69         public static final String HOMOTYPIC_SYN_ICON = "homotypic_syn_icon";
  70         /** Constant <code>HOMOTYPIC_SYN_ORIGINAL_ICON="homotypic_syn_original_icon"</code> */
  71         public static final String HOMOTYPIC_SYN_ORIGINAL_ICON = "homotypic_syn_original_icon";
  72         /** Constant <code>HETEROTYPIC_SYN_ICON="heterotypic_syn_icon"</code> */
  73         public static final String HETEROTYPIC_SYN_ICON = "heterotypic_syn_icon";
  74         public static final String NOM_INVAL_NUD_SYN_ICON = "nom_inval_nud_syn_icon";
  75         public static final String HOMOTYPIC_SYNONYM_IN_HETEROTYPIC_GROUP_ICON = "homotypic_synonym_in_heterotypic_group_icon";
  76         /** Constant <code>HETEROTYPIC_SYN_ORIGINAL_ICON="heterotypic_syn_original_icon"</code> */
  77         public static final String HETEROTYPIC_SYN_ORIGINAL_ICON = "heterotypic_syn_original_icon";
  78         /** Constant <code>MISAPPLIED_NAME_ICON="misapplied_icon"</code> */
  79         public static final String MISAPPLIED_NAME_ICON = "misapplied_icon";
  80         /** Constant <code>CONCEPT_ICON="concept_icon"</code> */
  81         public static final String CONCEPT_ICON = "concept_icon";
  82         /** Constant <code>AUTONYM_ICON="autonym_icon"</code> */
  83         public static final String AUTONYM_ICON = "autonym_icon";
  84         /** Constant <code>BASIONYM_ICON="basionym_icon"</code> */
  85         public static final String BASIONYM_ICON = "basionym_icon";
  86         /** Constant <code>ORTHOGRAPHIC_VARIANT_ICON="orthographic_variants_icon"</code> */
  87         public static final String ORTHOGRAPHIC_VARIANT_ICON = "orthographic_variants_icon";
  88         /** Constant <code>DB_ICON="db_icon"</code> */
  89         public static final String DB_ICON = "db_icon";
  90         /** Constant <code>MOVE_ICON="move_icon"</code> */
  91         public static final String MOVE_ICON = "move_icon";
  92         /** Constant <code>ACTIVE_DELETE_ICON="active_delete_icon"</code> */
  93         public static final String ACTIVE_DELETE_ICON = "active_delete_icon";
  94         /** Constant <code>SYNONYM_TO_TAXON_ICON="synoynm_to_taxon_icon"</code> */
  95         public static final String SYNONYM_TO_TAXON_ICON = "synoynm_to_taxon_icon";
  96         /** Constant <code>OPEN_TAXON_ICON="open_taxon_icon"</code> */
  97         public static final String OPEN_TAXON_ICON = "open_taxon_icon";
  98         /** Constant <code>ADD_CHILD_TAXON_ICON="add_taxon_icon"</code> */
  99         public static final String ADD_CHILD_TAXON_ICON = "add_taxon_icon";
 100         /** Constant <code>SWAP_SYNONYM_AND_TAXON_ICON="swap_syn_and_tax_icon"</code> */
 101         public static final String SWAP_SYNONYM_AND_TAXON_ICON = "swap_syn_and_tax_icon";
 102         /** Constant <code>QUICK_ADD_ICON="quick_add_icon"</code> */
 103         public static final String QUICK_ADD_ICON = "quick_add_icon";
 104         /** Constant <code>TAXON_TO_SYNONYM_ICON="tax_to_syn_icon"</code> */
 105         public static final String TAXON_TO_SYNONYM_ICON = "tax_to_syn_icon";
 106         /** Constant <code>ERROR_ANNOTATION_ICON="error_annotation_icon"</code> */
 107         public static final String ERROR_ANNOTATION_ICON = "error_annotation_icon";
 108         /** Constant <code>EDIT_BITMAP_ICON="edit_bitmap_icon"</code> */
 109         public static final String EDIT_BITMAP_ICON = "edit_bitmap_icon";
 110         /** Constant <code>IMG_DATASOURCE_CONNECTED="IMG_DATASOURCE_CONNECTED"</code> */
 111         public static final String IMG_DATASOURCE_CONNECTED = "IMG_DATASOURCE_CONNECTED";
 112         /** Constant <code>IMG_DATASOURCE_DISCONNECTED="IMG_DATASOURCE_DISCONNECTED"</code> */
 113         public static final String IMG_DATASOURCE_DISCONNECTED = "IMG_DATASOURCE_DISCONNECTED";
 114         /** Constant <code>IMG_NOT_FOUND="IMG_NOT_FOUND"</code> */
 115         public static final String IMG_NOT_FOUND = "IMG_NOT_FOUND";
 116         /** Constant <code>WARNING_ANNOTATION_ICON="warning"</code> */
 117         public static final String WARNING_ANNOTATION_ICON = "warning";
 118
 119         /** Constant <code>LOCK_ICON="locked"</code> */
 120         public static final String LOCK_ICON = "lock";
 121
 122         /** Constant <code>LOCK_OPEN_ICON="lock_open"</code> */
 123         public static final String LOCK_OPEN_ICON = "lock_open";
 124
 125         /** Constant <code>THREE_PRONGED_EQUAL="3_pronged_equal"</code> */
 126         public static final String THREE_PRONGED_EQUAL = "3_pronged_equal";
 127         /** Constant <code>TWO_PRONGED_EQUAL="2_pronged_equal"</code> */
 128         public static final String TWO_PRONGED_EQUAL = "2_pronged_equal";
 129         /** Constant <code>MISAPPLIED_NAME="misapplied_name"</code> */
 130         public static final String MISAPPLIED_NAME = "misapplied_name";
 131         /** Constant <code>ORPHANED_TAXON="orphaned_taxon"</code> */
 132         public static final String ORPHANED_TAXON = "orphaned_taxon";
 133         /** Constant <code>EXPAND_ALL="expand_all"</code> */
 134         public static final String EXPAND_ALL = "expand_all";
 135         /** Constant <code>COLLAPSE_ALL="collapse_all"</code> */
 136         public static final String COLLAPSE_ALL = "collapse_all";
 137
 138         public static final String TISSUE_SAMPLE_DERIVATE = "derivate_view_icon";
 139
 140         public static final String DNA_DERIVATE = "dna_derivate";
 141         public static final String FIELD_UNIT = "field_unit";
 142
 143
 144
 145         /***************************************************************************
 146          * IMAGE REGISTRY
 147          **************************************************************************/
 148         private ImageRegistry imageRegistry;
 149
 150         /**
 151          * <p>getImageDescriptor</p>
 152          *
 153          * @param key a {@link java.lang.String} object.
 154          * @return a {@link org.eclipse.jface.resource.ImageDescriptor} object.
 155          */
 156         public static ImageDescriptor getImageDescriptor(String key) {
 157                 return getInstance().getImageRegistry().getDescriptor(key);
 158         }
 159
 160         /**
 161          * <p>getImage</p>
 162          *
 163          * @param key a {@link java.lang.String} object.
 164          * @return a {@link org.eclipse.swt.graphics.Image} object.
 165          */
 166         public static Image getImage(String key) {
 167                 return getInstance().getImageRegistry().get(key);
 168         }
 169
 170         /**
 171          * Gets an image for the given URL. Adds the image to the registry as needed.
 172          *
 173          * @param uri a {@link java.net.URI} object.
 174          * @return a {@link org.eclipse.swt.graphics.Image} object.
 175          */
 176         public static Image getImage(URI uri) {
 177
 178                 String key = uri.toString();
 179                 ImageRegistry registry = getInstance().getImageRegistry();
 180
 181                 Image image = registry.get(key);
 182
 183                 if (image == null) {
 184                         ImageDescriptor desc;
 185                         try {
 186                                 desc = ImageDescriptor.createFromURL(new URL(key));
 187                                 registry.put(key, desc);
 188                                 image = registry.get(key);
 189                         } catch (DeviceResourceException e) {
 190                                 return getImageNotFound();
 191                         } catch (MalformedURLException e) {
 192                                 // should never happen
 193                         } catch (Exception e) {
 194                                 StoreUtil.error(ImageResources.class, e);
 195                         }
 196
 197 //                      logger.warn(ImageDescriptor.getMissingImageDescriptor().getClass());
 198 //                      logger.warn(desc.getClass());
 199 //
 200 //                      if (ImageDescriptor.getMissingImageDescriptor().equals(desc)) {
 201 //                              logger.warn("img not found");
 202 //                      }
 203
 204                 }
 205
 206                 return image;
 207         }
 208
 209         /**
 210          * <p>getImageNotFound</p>
 211          *
 212          * @return a {@link org.eclipse.swt.graphics.Image} object.
 213          */
 214         public static Image getImageNotFound() {
 215                 return getImage(ImageResources.IMG_NOT_FOUND);
 216         }
 217
 218         /**
 219          * <p>Getter for the field <code>imageRegistry</code>.</p>
 220          *
 221          * @return a {@link org.eclipse.jface.resource.ImageRegistry} object.
 222          */
 223         public ImageRegistry getImageRegistry() {
 224         if (imageRegistry == null) {
 225             imageRegistry = TaxeditorStorePlugin.getDefault().createImageRegistry();
 226             initializeImageRegistry(imageRegistry);
 227         }
 228         return imageRegistry;
 229     }
 230
 231         /**
 232          * <p>initializeImageRegistry</p>
 233          *
 234          * @param registry a {@link org.eclipse.jface.resource.ImageRegistry} object.
 235          */
 236         protected void initializeImageRegistry(ImageRegistry registry) {
 237                 registerImage(registry, ADD_ICON,
 238                                 "add_no_bg.gif");
 239                 registerImage(registry, TRASH_ICON,
 240                                 "trash.gif");
 241                 registerImage(registry, EDIT_ICON,
 242                                 "text.gif");
 243                 registerImage(registry, EDIT_LOGO_ICON,
 244                                 "edit_16x16.ico");
 245                 registerImage(registry, WARNING_ICON,
 246                                 "warn_tsk.gif");
 247                 registerImage(registry, BLACK_SQUARE_ICON,
 248                                 "accepted_small.gif");
 249                 registerImage(registry, HOMOTYPIC_SYN_ICON,
 250                                 "homosyn_no_bg.gif");
 251                 registerImage(registry, HOMOTYPIC_SYN_ORIGINAL_ICON,
 252                                 "homosyn_original_no_bg.gif");
 253                 registerImage(registry, HETEROTYPIC_SYN_ICON,
 254                                 "heterosyn_no_bg.gif");
 255                 registerImage(registry, NOM_INVAL_NUD_SYN_ICON,
 256                                 "nominval_nud_no_bg.gif");
 257                 registerImage(registry, HETEROTYPIC_SYN_ORIGINAL_ICON,
 258                                 "heterosyn_original_no_bg.gif");
 259                 registerImage(registry, HOMOTYPIC_SYNONYM_IN_HETEROTYPIC_GROUP_ICON,
 260                                 "homotypic_syn_hetero_group.gif");
 261                 registerImage(registry, MISAPPLIED_NAME_ICON,
 262                                 "misapplied_no_bg.gif");
 263                 registerImage(registry, CONCEPT_ICON,
 264                                 "concept_no_bg.gif");
 265                 registerImage(registry, AUTONYM_ICON,
 266                                 "autonym_no_bg.gif");
 267                 registerImage(registry, BASIONYM_ICON,
 268                                 "basionym_no_bg.gif");
 269                 registerImage(registry, ORTHOGRAPHIC_VARIANT_ICON,
 270                                 "orthovariant_no_bg.gif");
 271                 registerImage(registry, DB_ICON,
 272                                 "db.gif");
 273                 registerImage(registry, MOVE_ICON,
 274                                 "correction_change.gif");
 275                 registerImage(registry, ACTIVE_DELETE_ICON,
 276                                 "delete_edit.gif");
 277                 registerImage(registry, SYNONYM_TO_TAXON_ICON,
 278                                 "change.gif");
 279                 registerImage(registry, OPEN_TAXON_ICON,
 280                                 "open.gif");
 281                 registerImage(registry, ADD_CHILD_TAXON_ICON,
 282                                 "new_child.gif");
 283                 registerImage(registry,
 284                                 SWAP_SYNONYM_AND_TAXON_ICON, "swap2.gif");
 285                 registerImage(registry, QUICK_ADD_ICON,
 286                                 "quick_add.gif");
 287                 registerImage(registry, TAXON_TO_SYNONYM_ICON,
 288                                 "tax_to_syn.gif");
 289                 registerImage(registry, ERROR_ANNOTATION_ICON,
 290                                 "error_co.gif");
 291                 registerImage(registry, EDIT_BITMAP_ICON,
 292                                 "256color_16x16.bmp");
 293                 registerImage(registry, IMG_DATASOURCE_CONNECTED,
 294                                 "prj_obj.gif");
 295                 registerImage(registry, IMG_DATASOURCE_DISCONNECTED,
 296                                 "cprj_obj.gif");
 297                 registerImage(registry, IMG_NOT_FOUND,
 298                                 "pic_not_found.PNG");
 299                 registerImage(registry, WARNING_ANNOTATION_ICON,
 300                                 "warning_co.gif");
 301                 registerImage(registry, THREE_PRONGED_EQUAL,
 302                                 "3_pronged_equal_small.GIF");
 303                 registerImage(registry, TWO_PRONGED_EQUAL,
 304                                 "2_pronged_equal_small.GIF");
 305                 registerImage(registry, MISAPPLIED_NAME,
 306                                 "ma_12x12.gif");
 307                 registerImage(registry, ORPHANED_TAXON,
 308                                 "orphaned.gif");
 309                 registerImage(registry, EXPAND_ALL,
 310                                 "expandAll.jpg");
 311                 registerImage(registry, COLLAPSE_ALL,
 312                                 "collapseall.gif");
 313                 registerImage(registry, BROWSE_ICON,
 314                                 "prj_obj.gif");
 315                 registerImage(registry, LOCK_ICON,
 316                         "lock.png");
 317                 registerImage(registry, LOCK_OPEN_ICON,
 318                         "lock_open.png");
 319                 registerImage(registry, DNA_DERIVATE,
 320                         "dna_derivate-16x16-32.gif");
 321                 registerImage(registry, FIELD_UNIT,
 322                         "fieldunit-16x16-32.gif");
 323                 registerImage(registry, TISSUE_SAMPLE_DERIVATE,
 324                         "tissue_sample_derivate-16x16-32.gif");
 325         }
 326
 327         private void registerImage(ImageRegistry registry, String key,
 328                         String fileName) {
 329                 try {
 330                         IPath path = new Path("icons/" + fileName); //$NON-NLS-1$
 331                         URL url = FileLocator.find(TaxeditorStorePlugin.getDefault().getBundle(), path, null);
 332                         if (url != null) {
 333                                 ImageDescriptor desc = ImageDescriptor.createFromURL(url);
 334                                 registry.put(key, desc);
 335                         }
 336                 } catch (Exception e) {
 337                 }
 338         }
 339 }