Foobar2000插件Repeat<复读机>说明文档
插件文件名: foo_Repeat.dll(为英界面文) /foo_Repeat_ch.dll(为中文界面)
插件名：复读机插件 for Foobar2000 ( Repeat for Foobar2000 )
插件版本 : v0.1.7.3
支持Foobar2000 版本: 0.8x
运行操作系统：win2000/xp(98下未作测试)
大小: about 107K
作者: Hero.Hua (
major@sjtu.edu.cn )
编译日期: 2004.3.2 (ANSI version,支持中文)
foo_repeat is distributed in the hope that it will be useful,
BUT WITHOUT ANY WARRANTY;
（请耐心看完此说明文档）
一、声明：
本插件完全免费，可任意传播，但不得篡改，若有问题请与我联系
二、功能及操作说明：
总体说明：本插件开发的最初目的是为了在Foobar上开发一个类似复读机（带变速功能）的东东，方便既对音质有要求又要学外语的朋友（当然也可以学唱歌，:)）。
特别声明：插件中变速功能的实现的源码大部分来自Kode54(
kode54@earthlink.net)，我已将使用他源码的事写信告诉过他，而且他也同意我在些插件中使用这些源码。SoundTouch库来源于
http://sky.prohosting.com/oparviai/soundtouch/，按SoundTouch的要求，遵守LGPL协议。
用户主界面：
...用户可以任意指定要重复播放的段。用于选取播放段的两个按钮分别为：[Select Left Point]用于选取段的开始，[Select Right Point]用于选取段的结尾。用户选取了后，进度条下面黑色的选择段会显示用户选择的大概位置(不是太精确)。
...用户选择了播放文件的某一段后，可以点[Add]按钮加入到右边的[Selections List]列表框中去，并显示为所选择的时间段，用户添加后，会自动按时间顺序升序排序。要听选取过的某一段，只要双击"Selections List"列表框中的某一条即可。
...[Beginning -> Left Point]用于指定当前播放段的前面所有部分，“Right Point -> End”用于指定当前播放段的后面的所有部分。
...[Cancel]按钮用于取消刚才所做的选择。
...“<”，“>”分别用于时间的微调,步长step为0.1秒/1秒/2秒/5秒，用户可以自选。左边的为微调所选段的起始位置，右边的为微调所选段的结束位置。“<”和“>”之间的时间为你选择的时间段
.“|<”播放前一音频文件,“[#]”停止播放 ，“|>”播放， “||”暂停， “>|”播放下一音频文件。你用主程序中播放按钮或菜单等，都是一样的。另外，主程序中的关于播放的动作和选项都有效。比如重复播放所有/重复某个文件/按光标顺序播放等等。
...[Open defined]：按配置对话框的配置，打开源文件。
...[Open...]：用于打开自己指定的文件，会弹出对话框供用户选择
以上两项OPEN中，若配置为用外部程序打开，会自动用外部程序打开，若配置为用自带的EDITBOX打开，则会自动显示在EDITBOX中。
...几个[Save to Tag]和[Save to File]按钮。用于保存文本（也许是你练听力时敲入的单词/句子，也可以是听歌时的歌词）和用户的选择段，文件名可自己指定（在配置对话框中）。其中，文本文件可以用文本编辑工具自己编辑，播放时会自动加载并显示。关于存放这些文件的位置，和lyricshow的方式差不多，给定一个搜索路径是个不错的办法。另外，可以将选择段和听力的源文件存入媒体文件的tag中。
注意：若读取源文本（或选择段）不是从某文件中读取（而是从TAG中），当按[save to file]时，会自动弹出打开文件对话框，让用户进行选择。
...按最右上角的[config]，可以打开配置对话框进行一些配置。
------------------------------------------------------------------------------------------
变速功能：
声明：此部分功能代码主要来自Kode54的一个DSP插件foo_dsp_soundtouch中的源代码，我只是稍做了些修改，并与我的复读机插件进行了整合，当然，变速、变调、改节拍功能也可单独使用。
注意：SoundTouch 的激活要通过DSP manager page来加入Active DSPs列表实现
操作：
...主界面对话框上有两个CHECK BOX（核选框）和一个MINI SEEK BAR(小拖动条)，[real-time]/[实时调整] ，[Rate adjust]/[调整速度]，[Tempo adjust]/[调整节拍]在MINI SEEK BAR上可以鼠标拖动或用键盘“＋/-”“PageUp/PageDown”进行微调
...在preference-->playback-->DSP manager 中，你会发现有 SoundTouch_forRepeat或SoundTouch_forRepeat(Ch version)，你可以进行其它的调整，比如声调、节拍、速度等，其速度调整与复读机界面上的速度调整是同步的
此变速功能对练听力尤其有益
--------------------------------------------------------------------------------------------
配置对话框：
.[Always on Top]: 窗口是否总是在最前面；
.[Remember Window Position]/[记住窗口的位置]: 记住上次窗口的位置与大小；
.[Auto save before a new media]核选框，若用户选中，则用户在播放另一音频文件时，自动保存刚才所做的一些修改（文本、选择段的修改）。若用户没有选中，不保存刚才所做的改动（尤其是练外语听力的朋友，最好选中这项功能）。
.[Load source ]：此两值修改即生效 （注：TAG名须在两个“%”之间）
[From Tag]：表示从tag中读取文本，后面的文本框为tag的名称，此TAG用于存源文本，缺省值为“%SOURCE%”；
[From external file]：表示从外部文件中读取文本
[User defined source file Name]：自已定义外部文件名
[Tag name]：其TAG值存在用存外部歌词文件的路径名，缺省值为“%SRCFILE%”
.[Load selection ]：此两值修改即生效 （注：TAG名须在两个“%”之间）
[From Tag]：表示从tag中读取文本，后面的文本框为tag的名称，此TAG用于存选择段文本，缺省值为“%SELECTION%”；
[From external file]：表示从外部文件中读取文本
[User defined source file Name]：自已定义外部文件名
[Tag name]：其TAG值存在用存外部选择文件的路径名，缺省值为“%SELFILE%”
.[Extension]：文件的缺省后缀名，一个是源文本的后缀名，另一个为选择段文件的后缀名
.[Display source file]：可以指定外部程序打开听力的源文本文件。在这个框中，你可以选择打开源文件的方式，也可以选择外部程序。注意：用外部程序只能打开某个存有源文本的文件，如果是你将源文本存在TAG中，是无法打开的。
.[String setting]，这两项须按[apply]才生效
[Search path]：用于源文件和选择段文件的搜索路径，缺省的搜索路径包插媒体文件自身的目录，不必将媒体文件本身的路径加上。
[Window title format]：用于修改主界面的标题，可以看有关的帮助
三、安装：（假定已安装好了FOOBAR2000 ver0.8x）
1、将Repeat.dll拷至FOOBAR200的运行目录下的components目录（在此目录下你可以看到很多.dll文件，注意要关闭FOOBAR才能拷贝成功）；
2、启动FOOBAR2000，在菜单项Components下可看到Repeat的菜单，点击即可出现运行界面；
3、若你想将这个插件的运行加为Foobar的快捷键方式，请先运行菜单Foobar2000->Preference，点中左边中的Keyboard Shortcuts，然后右边会出现指定快捷键的界面，在下面的那个Actions窗口中的找到Repeat（可能在最下面）,选中这一项，然后将光标移到“Key”这个小编辑框，在键盘上指定你的快捷键（比如你要指定Ctrl+1，就按下Ctrl+1，Key窗口中将会出现Ctrl+1字样），然后点“Add”按钮，就表示为RepeatSelections这个插件指定了快捷键方式，将来你再运行这个插件时，直接用Ctrl+1即可，方便快捷。
四、一点补充
1、如果此插件对你的计算机造成破坏，本人概不负责，但本人绝对保证自己发行的版本无任何不良代码，别人的恶意修改我无法保证。
2、复读机我不知道用英语怎么拼写，所以就起了个很土的名字Repeat，比前一版的叫法要好一点，:)，那位有好的建议，请告知，邮件地址见上。
Enjoy it!
Hero. Hua
2004.2
[后记]
2004.3.2 ver 0.1.7.3
修正自动保存selection file的BUG
修正[<=del]一直灰的BUG
增加若干错误与报警信息
2004.3.1 ver 0.1.7.2
在SoundTouch中支持32位采样，让变速的效果更好
同时将版本号改为0.1.7.2，以后均按这种方法增加版本号，
修改BUG后，最后一位（第四位）加1，有较大改进后，第三位加1，
有重大改进第二位加1
2004.2.29 ver 0.17b
调用SoundTouch 库，利用Kode54的源码，增加变速功能
2004.2.26 ver 0.16
做重大修改，几乎全部重写，文件定位搜索、保存方便
支持多线程操作
提供外部程序打开源文件
2004以前 ver 0.15
基本的重复播放功能
