NewAdvSplash plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
No edit summary
Line 2: Line 2:


== Links ==
== Links ==
 
Download:<br>
[http://forums.winamp.com/attachment.php?s=&postid=1712646 Download]
<attach>NewAdvSplash.zip</attach><br>
[http://forums.winamp.com/showthread.php?s=&threadid=197479 Forum thread]


== Description ==
== Description ==
Line 53: Line 54:
; /LOOP
; /LOOP
: loops sound.
: loops sound.
newadvsplash::hwnd
: Gets splash window handle (use Pop to take it from stack)


== Examples ==
== Examples ==

Revision as of 08:22, 30 August 2005

Author: Takhir (talk, contrib)


Links

Download:
NewAdvSplash.zip (35 KB)
Forum thread

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.
newadvsplash::hwnd
Gets splash window handle (use Pop to take it from stack)

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.