[Setup]: WizardImageFile

Default value:

(blank)
Description:

Specifies the name(s) of the image file(s) to display on the left side of the Welcome and Setup Completed wizard pages. Wildcards are supported and the files(s) must be located in your installation's source directory when running the compiler, unless a fully qualified pathname is specified or the pathname is prefixed by "compiler:", in which case it looks for the file in the compiler directory.

Supports .bmp and .png images, including those with transparency. Use WizardImageBackColor to customize the background color. Even transparent .bmp files are supported, see WizardImageAlphaFormat for more information.

The size of the area in which the image is displayed depends on the system's DPI setting and whether the default font settings are being used. At standard DPI with the default font settings, the size of the area is 164x314 pixels. At 200% DPI, the width and height will be roughly double that. In all cases, an aspect ratio of 164:314 is maintained. The specified image should have the same aspect ratio.

Any size of image may be used; by default, images that are too small or too large to fit in the image area will be stretched or shrunk. Specifying an image larger than 164x314 is recommended to avoid the image looking blurry on higher-DPI systems. The size of the default built-in image is 240x459.

If a single larger-sized image does not produce a satisfactory result across different DPI settings, multiple files may be specified, separated by commas. In that case, Setup will automatically select the one that best matches the size of the image area. Assuming the default font settings are being used, the size of the image area at various DPI settings is:

100%164x314
125%202x386
150%240x459
175%290x556
200%315x604
225%366x700
250%416x797

(You may notice that the size at 200% is not exactly double the 100% size. This is because the scaling factor is based on the dimensions of the font that a DPI setting uses, not the DPI itself.)

If this directive is not specified or is blank, a single built-in 240x459 wizard image will be used, by default stretched or shrunk if the image is larger or smaller than required.

To use the old default wizard images set this directive to compiler:WizClassicImage.bmp.

Example:
WizardImageFile=myimage.bmp,myimage2.bmp

See also:
WizardSmallImageFile
WizardImageAlphaFormat
WizardImageBackColor
WizardImageStretch