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 |
---|---|---|
| Indicates whether the window size can be changed or not. | no |
| Sets the initial window width in pixels. | 600 |
| 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 | ||
---|---|---|
| ||
<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 | ||
---|---|---|
| ||
<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 |
---|---|---|
| + | + |
| + | + |
| + | + |
| + | + |
| - | + |
| + | + |
| + | + |
| + | + |
| + | + |
| - | + |
| + | + |
| + | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| - | + |
| + | + |
| + | + |
| + | + |
| + | + |
| + | + |
| - | + |
| + | + |
| - | + |
| + | + |
| + | + |
| + | + |
| - | + |
| + | + |
| - | + |
| - | + |
| - | + |
Background Image
Since 5.2.2 it is possible to specify the background image (
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
...