Reference/AddBrandingImage: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
(Created page with "=AddBrandingImage= (left|right|top|bottom) (width|height) [padding] Adds a branding image on the top, bottom, left, or right of the installer. Its size will be set according t...")
 
(+U suffix)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
=AddBrandingImage=
=AddBrandingImage=


  (left|right|top|bottom) (width|height) [padding]
  (left|right|top|bottom) (width|height)[u] [padding[u]]


Adds a branding image on the top, bottom, left, or right of the installer. Its size will be set according to the width/height specified, the installer width/height and the installer font. The final size will not always be what you requested; have a look at the output of the command for the actual size. Because this depends on the installer font, you should use [[Reference/SetFont|SetFont]] before AddBrandingImage. The default padding value is 2.
Adds a branding image on the top, bottom, left, or right of the installer. Its size will be set according to the width/height specified, the installer width/height and the installer font. The final size will not always be what you requested; have a look at the output of the command for the actual size. Because this depends on the installer font, you should use [[Reference/SetFont|SetFont]] before AddBrandingImage. The default padding value is 2. The numbers can be suffixed with <code>u</code> to specify dialog units instead of pixels.


AddBrandingImage only adds a placeholder for an image. To set the image itself on runtime, use [[Reference/SetBrandingImage|SetBrandingImage]].
AddBrandingImage only adds a placeholder for an image. To set the image itself on runtime, use [[Reference/SetBrandingImage|SetBrandingImage]].
Line 12: Line 12:
AddBrandingImage bottom 35
AddBrandingImage bottom 35
AddBrandingImage left 100 5</highlight-nsis>
AddBrandingImage left 100 5</highlight-nsis>
''Command introduced with NSIS v2.0. <code>u</code> suffix added in v3.04''

Latest revision as of 23:43, 2 November 2018

AddBrandingImage

(left|right|top|bottom) (width|height)[u] [padding[u]]

Adds a branding image on the top, bottom, left, or right of the installer. Its size will be set according to the width/height specified, the installer width/height and the installer font. The final size will not always be what you requested; have a look at the output of the command for the actual size. Because this depends on the installer font, you should use SetFont before AddBrandingImage. The default padding value is 2. The numbers can be suffixed with u to specify dialog units instead of pixels.

AddBrandingImage only adds a placeholder for an image. To set the image itself on runtime, use SetBrandingImage.

AddBrandingImage left 100
AddBrandingImage right 50
AddBrandingImage top 20
AddBrandingImage bottom 35
AddBrandingImage left 100 5

Command introduced with NSIS v2.0. u suffix added in v3.04