NewAdvSplash plug-in

Author: Takhir (talk, contrib)

Links

Download

Description

NewAdvSplash.dll - startup image banner plug-in with fading effects (win2k/xp) and transparency. Allows background installer initialization. At the same time can play wav-mp3 sound file. On the base of AdvSplash NSIS plug-in. Compatibility: basic - Win95 and later, fadein/fadeout - win2k/winxp.

Entry points and parameters (NSIS script)

newadvsplash::show [/NOUNLOAD] Delay FadeIn FadeOut KeyColor [/BANNER] [/NOCANCEL] FileName

Delay

time (milliseconds) to show image

FadeIn

time to show the fadein scene

FadeOut

time to show the fadeout scene

KeyColor

color used for transparency, could be any RGB value (for ex. R=255 G=100 B=16 -> KeyColor=0xFF6410), use KeyColor=-1 if there is no transparent color at your image. If KeyColor=-2 and image type is gif, plug-in attempts to extract transparency color value from the file header. For gif images transparency on the static background works even if KeyColor=-1.

/BANNER

returns control to installer immediatelly after plug-in activation.

/NOCANCEL

disables 'exit on user click' default behaviour.

FileName

splash image filename (with extension!). Bmp, gif and jpg image types supported.

newadvsplash::wait

Waits for the end of performance :). If 'show' already finished - exits immediately

newadvsplash::stop

Terminates banner.

newadvsplash::play /NOUNLOAD [/LOOP] FileName

FileName

sound filename to play (with extension, wav, mp3 ...). Empty Filename string "" stops playing ('show' end does this as well).

/LOOP

loops sound.

Examples

'Modeless' logo with sound

     newadvsplash::play /NOUNLOAD /LOOP "$PLUGINSDIR\snd.mp3"
     newadvsplash::show /NOUNLOAD 2000 1000 500 -2 /BANNER "$PLUGINSDIR\logo.gif"
     ; add your initialization code here
     newadvsplash::wait

Simple logo

     newadvsplash::show 2000 1000 500 -1 "$PLUGINSDIR\logo.jpg"

No return value.