nsisSlideshow

nsisSlideshow 是一个用于显示渐变效果标志图/幻灯片的小型 NSIS 插件
网址：http://wiz0u.free.fr/prog/nsisSlideshow
你可以用它在安装过程中显示广告或提示。标志图的显示可以是手动 (同步的)，也可以是自动的。

说明

  • 此插件已在 Windows XP 和 Vista 下测试，但可能兼容 Windows 2000、XP、Vista 以及最新系统。
  • 实际例子查看样例脚本。

用法

  • nsisSlideshow::show /NOUNLOAD [选项] <图片文件名> (手动模式)
  • nsisSlideshow::show /NOUNLOAD [选项] /auto=<控制文件> (自动模式)

可用的选项

/HWND=<句柄值>
使用指定窗口的边界矩形来绘制标志图 (默认使用显示详情的列表视图区域)
/FIT=HEIGHT|WIDTH|BOTH|STRETCH
缩放图片以适合该矩形框的限定 (默认：BOTH)
/HALIGN=LEFT|CENTER|RIGHT
矩形框内的水平位置 (默认：CENTER)
/VALIGN=TOP|CENTER|BOTTOM
矩形框内的垂直平位置 (默认：CENTER)
/CCOLOR=0xBBGGRR
用于可选的字幕文字颜色的 BGR 十六进制值 (默认：白色)
(确保图片底色让字幕易于阅读)

手动模式选项

/DURATION=<延迟毫秒数>
矩显示图片的淡入时间 (默认：1000 毫秒)
"/CAPTION=<字符串>"
矩在图片底部添加指定的字幕字符串 (如果有空格请使用引号)
图片格式可以是 JPEG、PNG、GIF、BMP、WMF
自动控制文件是一个定义了根据当前语言显示在幻灯片中的图片的文本文件。

定义分组格式

[语言 ID] ; 十进制区域语言 ID 值，查看 http://msdn.microsoft.com/en-us/library/0h88fahh.aspx
=<图片文件名>,<淡入时间>,<停留时间>[,<字幕>]
=<图片文件名>,<淡入时间>,<停留时间>[,<字幕>]
=<图片文件名>,<淡入时间>,<停留时间>[,<字幕>]
......
图片最好应该与控制文件放在同一文件夹，通常将幻灯片文件夹释放到 $PLUGINSDIR。
延迟单位为毫秒。停留时间是指在切换到下一张图片之前的等待时间。
字幕必须用适当的语言代码页来编码，就像 NSIS 中的语言字符串那样。
如果组以仅包含一个句号 (.) 的行结束，幻灯片将会在最后张图片处停止。
否则，幻灯片将会循环回到第一张图片。
你可以将多个语言组放在控制文件里，并根据语言修改图片、字幕等等。
如果没有找到当前语言，将使用默认的 [1033] 组 (英文)，如果还没找到将使用 [0] 组。
  • nsisSlideshow::stop
当安装过程结束时，调用此行以中止或终止标志图的显示。
这也将会释放插件使用的内存并卸载 DLL。

历史

  • 2006-06-21 v1.0: 最初 EBanner 插件由 Takhir Bedertdinov 编写
  • 2009-01-08 v1.1: 大量重写，不再闪烁
  • 2009-02-17 v1.2: 后台自动交叉淡入淡出
  • 2009-06-16 v1.3: 使用 Slides 文件夹添加自定幻灯片模式
  • 2009-08-19 v1.4: 将插件更名为 nsisSlideshow 并归档
  • 2009-09-07 v1.5: 移植到 Unicode NSIS
  • 2010-04-27 v1.6: 修正自动模式的两处 BUG
  • 2011-05-07 v1.7: 兼容 IE9

协议

Copyright (c) 2009-2011 Olivier Marcoux

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this library for any purpose, including commercial applications, and to redistribute it freely, subject to the following restriction:

The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

此文档由贾可 (jiake@vip.qq.com) 根据该插件官方网站翻译制作