EBanner plug-in

From NSIS Wiki
Jump to navigationJump to search
Author: Takhir (talk, contrib)


Links

Download:
EBanner.zip (32 KB)

Forum thread

Description

EBanner.dll is NSIS plug-in, displaying banner on the installer page. Not stops installer execution when banner is displayed. Banner is not

clickable and it's is place limited with page bottom. BMP, JPEG, GIF, PNG (with transparency) are supported. Also can play music at the same time.

Command line (NSIS script)

Plug-in DLL functions (entry points): show, play, stop

show DLL Function

ebanner::show /NOUNLOAD [/HALIGN=LEFT|RIGHT|CENTER] [/VALIGN=TOP|BOTTOM|CENTER] [/HWND=xxx] [/FIT=WIDTH|HEIGHT|BOTH] FileName
/HALIGN
image horizontal alignment, default (no parameter) is center.
/VALIGN
image vertical alignment, default (no parameter) is bottom.
/FIT
image stretch direction, default (no parameter) is original size.
/HWND
target window, default (no parameter) is "#32770" child of $HWNDPARENT .
FileName
Image file name. Empty Filename string "" clears image but not stops sound playing.

play DLL Function

ebanner::play /NOUNLOAD [/LOOP] FileName
/LOOP
Sets 'repeat' flag for hidden MCI player.
FileName
Sound filename to play (with extension, wav, mp3 ...). Empty Filename string "" stops sound.

stop DLL Function

ebanner::stop
Destroys image, clears window, stops sound (if any). Optional, on the page close auto-stop should work (I guess).


Examples

Package includes nsi script sample.

SetOutPath '$PLUGINSDIR'
File snd.mp3
File catch.gif
ebanner::play /NOUNLOAD /LOOP '$PLUGINSDIR\snd.mp3'
ebanner::show /NOUNLOAD /HALIGN=LEFT '$PLUGINSDIR\catch.gif'
; Add your page code here
ebanner::stop
Delete '$PLUGINSDIR\snd.mp3'
Delete '$PLUGINSDIR\catch.gif'