NewAdvSplash plug-in: Difference between revisions
From NSIS Wiki
Jump to navigationJump to search
m (AdvSplash with gif and jpeg moved to NewAdvSplash plug-in) |
No edit summary |
||
| Line 13: | Line 13: | ||
== Entry points and parameters (NSIS script) == | == Entry points and parameters (NSIS script) == | ||
newadvsplash::show [/NOUNLOAD] Delay FadeIn FadeOut KeyColor [/BANNER] [/NOCANCEL] FileName | newadvsplash::show [/NOUNLOAD] Delay FadeIn FadeOut KeyColor [/BANNER] [/PASSIVE] [/NOCANCEL] FileName | ||
; Delay | ; Delay | ||
| Line 32: | Line 32: | ||
; /NOCANCEL | ; /NOCANCEL | ||
: disables 'exit on user click' default behaviour. | : disables 'exit on user click' default behaviour. | ||
; /PASSIVE | |||
; not forces spalsh window to foreground | |||
; FileName | ; FileName | ||
Revision as of 11:16, 4 March 2006
| 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] [/PASSIVE] [/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.
- /PASSIVE
- not forces spalsh window to foreground
- 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.
