Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GUI Preferences - <guiprefs>

This <guiprefs> element allows you to set the layout and behavior of the GUI when the installer runs. This information will not have any effect on the command-line installers that will be available in future versions of IzPack.The attributes that can be specified are:

Attribute Name

Description

Default Value

resizable

Indicates whether the window size can be changed or not.

no

width

Sets the initial window width in pixels.

600

height

Sets the initial window height in pixels.

480

...

 The available look and feels are:

  • Kunststoff: kunststoff (JDK <9)

  • Liquid: liquid (support removed in 5.0.7)

  • Metouia: metouia

  • JGoodies Looks: looks

  • Substance: substance

  • Windows: windows

  • Aqua: aqua

  • Metal: metal

...

Code Block
<installation version="5.0"
              xmlns:izpack="http://izpack.org/schema/installation"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://izpack.org/schema/installation http://izpack.org/schema/5.0/izpack-installation-5.0.xsd">

  <info>
    <appname>Test</appname>
    <appversion>0.0</appversion>
    <appsubpath>myapp</appsubpath>
    <javaversion>1.6</javaversion>
  </info>

  <guiprefs width="800" height="600" resizable="no">
    <splash>images/peas_load.gif</splash>
    <laf name="substance">
      <os family="windows" />
      <os family="unix" />
      <param name="variant" value="mist-silver" />
    </laf>
    <laf name="substance">
      <os family="mac" />
      <param name="variant" value="mist-aqua" />
    </laf>
    <modifier key="useHeadingPanel" value="yes" />
  </guiprefs>

</installation>

kunststoff

<laf name="kunststoff">

JDK: <9

Liquid Look and Feel

The Liquid Look and Feel supports the following variant attributes:

...

Support for Liquid removed in 5.0.7.

JGoodies Looks

<laf name="looks">

The JGoodies Looks look and feel can be specified by using the variant attributes. The values can be one of:

...

Code Block
languagehtml/xml
<guiprefs height="600" resizable="yes" width="800" splash="images/splash.png">   
  <laf name="substancelooks">      
    <os family="windows" />
    <os family="unix" /> 
    <param name="variant" value="mist-silverwindows" />
  </laf> 
  <laf name="substancelooks">
    <os family="mac" /> 
    <os family="unix" /> 
    <param name="variant" value="mist-aquaplastic" />
  </laf> 
</guiprefs>

Substance

...

The Substance look and feel toned-down themes can be specified using the variant parameter, with the value being one of:

...

Attribute

...

PushingPixels Theme Name

...

default

...

org.pushingpixels.substance.api.skin.SubstanceBusinessLookAndFeel

...

business

...

org.pushingpixels.substance.api.skin.SubstanceBusinessLookAndFeel

...

sahara

...

org.pushingpixels.substance.api.skin.SubstanceSaharaLookAndFeel

...

business-blue 

...

org.pushingpixels.substance.api.skin.SubstanceBusinessBlueSteelLookAndFeel

...

business-black 

...

org.pushingpixels.substance.api.skin.SubstanceBusinessBlackSteelLookAndFeel

...

creme 

...

org.pushingpixels.substance.api.skin.SubstanceCremeLookAndFeel

...

creme-coffee

...

org.pushingpixels.substance.api.skin.SubstanceCremeCoffeeLookAndFeel

...

graphite

...

org.pushingpixels.substance.api.skin.SubstanceGraphiteLookAndFeel

...

moderate

...

org.pushingpixels.substance.api.skin.SubstanceModerateLookAndFeel

...

nebula

...

org.pushingpixels.substance.api.skin.SubstanceNebulaLookAndFeel

...

nebula-brick-wall

...

org.pushingpixels.substance.api.skin.SubstanceNebulaBrickWallLookAndFeel

...

autumn

...

org.pushingpixels.substance.api.skin.SubstanceAutumnLookAndFeel

...

mist-silver

...

org.pushingpixels.substance.api.skin.SubstanceMistSilverLookAndFeel

...

mist-aqua

...

org.pushingpixels.substance.api.skin.SubstanceMistAquaLookAndFeel

...

dust

...

org.pushingpixels.substance.api.skin.SubstanceDustLookAndFeel

...

dust-coffee

...

org.pushingpixels.substance.api.skin.SubstanceDustCoffeeLookAndFeel

...

gemini

...

org.pushingpixels.substance.api.skin.SubstanceGeminiLookAndFeel

...

mariner

...

org.pushingpixels.substance.api.skin.SubstanceMarinerLookAndFeel

...

officesilver

...

org.pushingpixels.substance.api.skin.SubstanceOfficeSilver2007LookAndFeel

...

officeblue

...

org.pushingpixels.substance.api.skin.SubstanceOfficeBlue2007LookAndFeel

...

officeblack

...

org.pushingpixels.substance.api.skin.SubstanceOfficeBlack2007LookAndFeel

The Substance web site has been taken off line but is still available in the Substance project source code found at https://github.com/Insubstantial/insubstantial/tree/master/substance http://java.net/projects/substance/sources/svn/show/trunk/www.

To view the gallery of the different toned-down themes, you need to check out the source code and then navigate to the www/docs/skins/toneddown.html file from your browser.

Substance is not compatible with JDK >=9. There is evolution of Substance named Radiance (https://github.com/kirill-grouchnikov/radiance).

Radiance supports JDK >=9 but has class file format incompatible with JDK 8. Radiance has same set of themes as Subsance. So since version 5.2.4 IzPack use Substance themes if run on JDK <9, otherwise use Radiance themes.
Istallation jar includes Radiance only if required JDK min version is >8 (<javaversion> in install.xml)

Istallation jar includes Substance only if required JDK <9 and JDK is strict (<javaversion strict="true"> in install.xml))

...

<laf name="substance">

Here is a small sample:

Code Block
languagehtml/xml
<guiprefs height="600" resizable="yes" width="800" splash="images/splash.png">   
  <laf name="substance">      
    <os family="windows" />
    <os family="unix" /> 
    <param name="variant" value="mist-silver" />
  </laf> 
  <laf name="substance">
    <os family="mac" /> 
    <param name="variant" value="mist-aqua" />
  </laf> 
</guiprefs>

The Substance web site has been taken off line but is still available in the Substance project source code found at https://github.com/Insubstantial/insubstantial/tree/master/substance http://java.net/projects/substance/sources/svn/show/trunk/www.

To view the gallery of the different toned-down themes, you need to check out the source code and then navigate to the www/docs/skins/toneddown.html file from your browser.

Substance is not compatible with JDK >=9.

Since 5.2.4
There is evolution of “Substance” named “Radiance” (https://github.com/kirill-grouchnikov/radiance).

“Radiance” supports JDK >=9 but has class file format incompatible with JDK 8. IzPack use “Substance” themes if run on JDK <9, otherwise use Radiance themes. Radiance has same set of themes as Subsance so xml-configuration and variants are the same as for substance.
The installation jar includes only “Radiance” if the required minimum SDK version is >8 (<javaversion> in install.xml)

The installation jar includes only “Substance” if required JDK <9 and JDK is strict (<javaversion strict="true"> in install.xml))

Otherwise the istallation jar includes both.

The substance look and feel toned-down themes can be specified using the variant parameter (default: business) pointed in next table. Some variants available in Radiance only (on JDK >8).

If a Radiance-specific theme is used and the installer is running on JDK<9, the default "business" variant will be used as a fallback.

Variant

Substance

Radiance

autumn

+

+

business

+

+

business-black

+

+

business-blue

+

+

cerulean

-

+

creme

+

+

creme-coffee

+

+

dust

+

+

dust-coffee

+

+

field-of-wheat

-

+

gemini

+

+

graphite

+

+

graphite-aqua

-

+

graphite-chalk

-

+

graphite-electric

-

+

graphite-glass

-

+

graphite-gold

-

+

graphite-sienna

-

+

graphite-sunset

-

+

green-magic

-

+

harvest

-

+

magellan

-

+

magma

-

+

mariner

+

+

mist-aqua

+

+

mist-silver

+

+

moderate

+

+

nebula

+

+

nebula-amethyst

-

+

nebula-brick-wall

+

+

night-shade

-

+

officeblack

+

+

officeblue

+

+

officesilver

+

+

raven

-

+

sahara

+

+

sentinel

-

+

streetlights

-

+

twilight

-

+

Background Image

Since 5.2.2 it is possible to specify the background image (

Jira Legacy
serverSystem Jira
serverId4741b2e0-e7d5-3853-84a7-22db1abe3b3c
keyIZPACK-1356
). To do this a simple resource entry will be needed:

...