Animate plug-in

Author: Takhir (talk, contrib)

Links

Download:
Animate.zip (38 KB)

Description

animate.dll - notifications and startup image banner plug-in with slide/roll/fading effects (win2k/Win98). Supports gif, jpeg and some other OleLoadPicture() formats. Can return splash HWND to work with other plug-ins (Marquee, AnimGif). Compatibility: Win98+, Win2K+. Patch for WinNT 4.0 (no animation, but window visible).

Installing

Unzip and place the .dll file into the Plugins directory.

Entry points and parameters (NSIS script)

animate::show /NOUNLOAD [/ATIME=xx] [/FLAGS=XX] [/X=xx] [/Y=xx] [/SFG] [/NOCANCEL] \
 [/COLOR=0xRRGGBB] [/BORDER] FileName

ATIME

animation time (milliseconds)

FLAGS

animate mode, default blend, see *.nsi samples for possible values

X

gap from desktop workarea borders. From right border if <0, from left border otherwise. Default - workarea center.

Y

the same as X for vertical placement

SFG

tries to set parent window foreground on exit

NOCANCEL

not allow user to close window with left mouse button click

BORDER

create window border

COLOR

window background color for transparent gif's

FileName

image filename (with extension)

Exit strings: OK, error (could not load image)

animate::wait TIME_MS

TIME_MS

time to show/wait for user click

Exit strings: clicked, closed, error (thread not exists), terminated Is safe even if "show" returned "error"

animate::hwnd

Gets splash window handle (use Pop to take it from stack)

After animation finished and "show" returned control to installer user can close window with left mouse button click (depends on /NOCANCEL option). The same with "wait" - window may be closed if /NOCANCEL not set. Any case it will be closed after "wait" time expired.

Examples

Desktop center 1 sec fade in (blend) and close

     animate::show /NOUNLOAD animate.gif
     Pop $0
     animate::wait 0
     Pop $1

Bottom right corner rising slide 2 sec and show 1 sec (user can close with left click during last second)

     IntOp $R0 ${AW_VER_NEGATIVE} | ${AW_SLIDE}
     animate::show /NOUNLOAD /ATIME=2000 /FLAGS=$R0 /X=-10 /Y=-10 animate.gif
     Pop $0
     animate::wait 1000
     Pop $1