Images - ImageIcon

javax.swing.ImageIcon is used for images, both to
use on buttons and labels, and to draw in a graphics panel.
The supported formats are .gif, .jpg, and .png.

Choice: Wait until loaded or overlap loading with other execution

Wait until loaded (recommended where timing is not critical)

This simple approach loads the image "synchronously", meaning that
whenever you request an image to be loaded, the
program waits until the image loading is
finished. If you do this, you don't have the extra complication
of using ImageObserver.
For a small number of small images from disk, this is the best choice.
The examples here are written in this style.

Overlap (use only for performance problems)

Start loading each image in its own thread, and
proceed with other initialization. To check the status of
the load (disks, and the Internet are so slow compared to the
CPU), use ImageObserver. Unless you are loading many
images, or a large image, over the Internet, I don't
recommend the extra complication.

To load an ImageIcon from a URL

java.net.URL where = new URL("http://www.yahoo.com/logo.jpeg");
ImageIcon anotherIcon = new ImageIcon(where);

To load an ImageIcon from a file

A file name in an ImageIcon constructor specifies the
file name relative to the location of the class file.
This constructor doesn't return until the ImageIcon is
completely loaded.

Warning: Just putting the file name or path in the ImageIcon constructor
won't work in general for applets or executable jar files.
See discussion of class loader in the NetBeans section below.

ImageIcon myIcon = new ImageIcon("images/myPic.gif");

Warning: Just putting the file name or path in the ImageIcon constructor
won't work in general for applets, WebStart applications, and executable jar files.
See below.

Bundling images in your .jar file using NetBeans and ClassLoader

Let's say you have a directory (cardimages) of images (cardimages/ad.gif, ...),
and the program is in a package called cardplayer, and you're
trying to load the image within the class Card.

Your Java source files will be in the src/cardplayer directory,
as is normal for a NetBeans project with a cardplayer package.
Add the directory containing the images (cardimages) to the src/cardplayer directory, so you have
src/cardplayer/cardimages/ad.gif, etc.

ClassLoader. Using a file path is not possible when running
a program that's in a jar file, especially if the program is being
loaded as an applet or WebStart application. The way to find
images that are bundled in the jar file is to ask the
Java class loader, the code that loaded your program,
to get the files. It knows where things are.

The double-clickable jar file (located at dist/cardplayer.jar) can now be run,
or the program can be executed in NetBeans.

To use an ImageIcon in a JButton

ImageIcon leftArrow = new ImageIcon("leftarrow.gif");
JButton left = new JButton(leftArrow);

To draw (paint) an ImageIcon

An ImageIcon, img, can be drawn on components (a JComponent or JPanel) using

img.paintIcon(Component c, Graphics g, int x, int y);

Display the image on
a subclass of JPanel used for graphics. Put the paintIcon
call in the paintComponent method of that panel.
To paint the ImageIcon img on the current panel
(ie, this), use a call like: