We need you!

Icon

The IzPack documentation needs work, and you are invited to edit it!

Skip to end of metadata
Go to start of metadata

Left side picture in the installer

You can specify a picture to be displayed on the left side of your installer frames, like on the following screenshot:

This picture is specified by a resource whose id shall be Installer.image, such as:

The image must be in a format that Java/Swing can read, such as the common PNG, GIF and JPEG formats. We recommend PNG as this format compresses well without any loss in quality.

A nice feature is that this picture can change depending on the displayed panel. This can be done by suffixing the resource id as follows:

  • Installer.image.n where n is a 0-based index of the displayed panel within the installation, or
  • Installer.image.id where id is the id of the matching panel.

The index-based solution is less flexible than using identifiers, but that is really up to you. You may also combine both styles, although this may cause some maintenance headaches on your side. If you use conditions with panels, you should always use the Installer.image.id version, or panels may not display the intended image.

As an example, here is how we do for IzPack own installer:

Always specify *Installer.image.0*!

Icon

If you opt to change the picture depending on the displayed panel, then you must specify the Installer.image.0 resource.
You will encounter exceptions otherwise.

  • No labels