Default value: | (blank) |
Specifies the name(s) of the bitmap 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.
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 bitmap should have the same aspect ratio.
Any size of bitmap may be used; by default, bitmaps that are too small or too large to fit in the image area will be stretched or shrunk. Specifying a bitmap 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.
WizardImageFile=myimage.bmp,myimage2.bmp
See also:
WizardSmallImageFile
WizardImageAlphaFormat
WizardImageStretch