home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 March / CMCD0304.ISO / Software / Freeware / Programare / nullsoft / nsis20.exe / Contrib / Splash / splash.txt < prev   
Encoding:
Text File  |  2002-11-08  |  1.2 KB  |  42 lines
  1. Splash.dll - small (4k), simple plugin that lets you throw 
  2. up a splash screen in NSIS installers.
  3.  
  4. --- UPDATED in 2.0b0 - will break old scripts ---
  5.  
  6. To use:
  7.  
  8. Create a .BMP file of your splash screen.
  9. (optional) Create a .WAV file to play while your splash screen shows.
  10.  
  11. Add the following lines to your .NSI file:
  12.  
  13. Function .onInit
  14.   SetOutPath $TEMP
  15.   File /oname=spltmp.bmp "my_splash.bmp"
  16.  
  17. ; optional
  18. ; File /oname=spltmp.wav "my_splashshit.wav"
  19.  
  20.   splash::show 1000 $TEMP\spltmp
  21.  
  22.   Pop $0 ; $0 has '1' if the user closed the splash screen early,
  23.      ; '0' if everything closed normal, and '-1' if some error occured.
  24.  
  25.   Delete $TEMP\spltmp.bmp
  26. ;  Delete $TEMP\spltmp.wav
  27. FunctionEnd
  28.  
  29. Note that the first parameter to splash.exe is the length to show the
  30. screen for (in milliseconds), and the second is the splash bitmap filename (without
  31. the .bmp). The BMP file used will be this parameter.bmp, and the wave file used
  32. (if present) will be this parameter.wav.
  33.  
  34. (If you already have an .onInit function, put that in it)
  35.  
  36. Note: the return value of splash is 1 if the user closed the splash 
  37. screen early (pop it from the stack)
  38.  
  39. -Justin
  40.  
  41. Converted to a plugin DLL by Amir Szekely (kichik)
  42.