2 Copyright (C) 2002, 2004, 2005 Free Software Foundation, Inc.
4 This file is part of GNU Classpath.
6 GNU Classpath is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Classpath is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Classpath; see the file COPYING. If not, write to the
18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
21 Linking this library statically or dynamically with other modules is
22 making a combined work based on this library. Thus, the terms and
23 conditions of the GNU General Public License cover the whole
26 As a special exception, the copyright holders of this library give you
27 permission to link this library with independent modules to produce an
28 executable, regardless of the license terms of these independent
29 modules, and to copy and distribute the resulting executable under
30 terms of your choice, provided that you also meet, for each linked
31 independent module, the terms and conditions of the license of that
32 module. An independent module is a module which is not derived from
33 or based on this library. If you modify this library, you may extend
34 this exception to your version of the library, but you are not
35 obligated to do so. If you do not wish to do so, delete this
36 exception statement from your version. */
40 import java.awt.Component;
41 import java.awt.Graphics;
42 import java.awt.Image;
43 import java.awt.MediaTracker;
44 import java.awt.Toolkit;
45 import java.awt.image.ImageObserver;
46 import java.io.Serializable;
50 public class ImageIcon
51 implements Icon, Serializable
53 private static final long serialVersionUID = 532615968316031794L;
55 /** A dummy Component that is used in the MediaTracker. */
56 protected static Component component = new Component(){};
58 /** The MediaTracker used to monitor the loading of images. */
59 protected static MediaTracker tracker = new MediaTracker(component);
61 /** The ID that is used in the tracker. */
62 private static int id;
66 ImageObserver observer;
68 /** The image loading status. */
69 private int loadStatus;
75 public ImageIcon(String file)
80 public ImageIcon(String file, String description)
82 this(Toolkit.getDefaultToolkit().getImage(file), description);
85 public ImageIcon(byte[] imageData)
87 this(imageData, null);
90 public ImageIcon(byte[] imageData, String description)
92 this(Toolkit.getDefaultToolkit().createImage(imageData), description);
95 public ImageIcon(URL url)
100 public ImageIcon(URL url, String description)
102 this(Toolkit.getDefaultToolkit().getImage(url), description);
105 public ImageIcon(Image image)
110 public ImageIcon(Image image, String description)
113 setDescription(description);
116 public ImageObserver getImageObserver()
121 public void setImageObserver(ImageObserver newObserver)
123 observer = newObserver;
126 public Image getImage()
131 public void setImage(Image image)
137 public String getDescription()
142 public void setDescription(String description)
144 this.description = description;
147 public int getIconHeight()
149 return image.getHeight(observer);
152 public int getIconWidth()
154 return image.getWidth(observer);
157 public void paintIcon(Component c, Graphics g, int x, int y)
159 g.drawImage(image, x, y, observer != null ? observer : c);
163 * Loads the image and blocks until the loading operation is finished.
165 * @param image the image to be loaded
167 protected void loadImage(Image image)
171 tracker.addImage(image, id);
173 tracker.waitForID(id - 1);
175 catch (InterruptedException ex)
177 ; // ignore this for now
181 loadStatus = tracker.statusID(id - 1, false);
186 * Returns the load status of the icon image.
188 * @return the load status of the icon image
190 * @see {@link MediaTracker.COMPLETE}
191 * @see {@link MediaTracker.ABORTED}
192 * @see {@link MediaTracker.ERRORED}
194 public int getImageLoadStatus()