TFM v1.0.4 - 中文说明文档:
TFM v1.0.4 - 中文说明文档 (09/21/2008)
---- 翻译：微风细雨
内容索引：
A.) 一般信息
B.) 基本参数
C.) 高级参数
D.) 文件输入/输出 参数
E.) 调试/显示 参数
F.) Overrides 超范围/无效 信息
G.) 更新列表
H.) 待办列表
A.) 一般信息：
目前TFM只支持YV12和YUY2模式
TFM是一个从电视视频流中恢复原始连续帧的场匹配滤镜。它并不能删除由此产生的重复帧， 因此，如果想实现ivtc，你必须跟随TFM使用一个反交错滤镜，例如TDecimate()，这也包含在TIVTC的dll中。
语法=>
TFM(int order, int field, int mode, int PP. string ovr, string input, string output,
string outputC, bool debug, bool display, int slow, bool mChroma, int cNum,
int cthresh, int MI, bool chroma, int blockx, int blocky, int y0, int y1,
int mthresh, PClip clip2, string d2v, int ovrDefault, int flags, double scthresh,
int micout, int micmatching, string trimIn, int hint, int metric, bool batch,
bool ubsco, bool mmsco, int opt)
而TFM有不少参数，我曾尝试进行分类设置，以便他们更易于管理。其实大部分用户只要掌握三个参数如何使用即可。它们是“order”，“mode”，“PP”，详细解释可以在下面的“基本参数”中查阅。其他设置如下所述，它们很容易就能从名字中推测出不同的用法。
B.) 基本参数：
这些参数中，只有3个参数的设置是大多数用户所需要关注和了解的。它们掌握着滤镜的基本操作。
order -
设置剪辑的场序。为了正确完成场匹配必须设置准确的场序。可用参数如下：
-1 = 自动模式（使用avs自带的奇偶值）
0 = bottom 场优先(bff)
1 = top 场优先(tff)
默认参数: -1 (int)
mode -
设置匹配的模式或者策略加以应用。
选项0是简单的双向匹配，是所有选项中最安全的选择，因为其不会造成由于可能由重复帧造成的任何jerkiness。但是，如果是bad edits或者混合场，它将在有好匹配时结束输出交错的帧。
选项5是三向匹配，如果在前三次匹配中发现交错将尝试第四、第五次匹配。是最有风险的，因为最容易出现jerkiness。但如果有好的帧也是其最容易发现的。
其他设置（选项1，2，3，4和6）都是介于选项0和5以及造成jerkiness和重复帧之间。还有在bad edits中找到好匹配, 孤立场、混合场、其他…
Mode 7 不是普通的模式之一，它是用来给有混合场下的材料使用的特定模式。
Mode 7 要求能进行正确的线性编辑。 因为使用何种的匹配/场，取决于之前匹配的结果。
可用参数如下:
0 = 两次匹配(p/c)。
1 = 两次匹配(p/c)，如发现交错则进行第三次匹配(n)。
2 = 两次匹配(p/c)，如发现交错则进行第三次匹配(u)。
3 = 两次匹配（p/c），如发现交错则进行第三次匹配{ n }，如再交错则进行第四、第五次匹配 (u/b)。
4 = 三次匹配(p/c/n)。
5 = 三次匹配(p/c/n)，如发现交错则进行第四(u)、第五次匹配(b)。
6 = 两次匹配(p/c)，如发现交错则进行第三次匹配(u)，如再交错则进行第四次匹配(n)，还有交错则进行第五次匹配(b)。
7 = 两次匹配(p/c)，且参照前面的帧，需要线性编辑。
最后的()提示某个可能被使用的匹配，假设order = 1 field = 1
* 选项0速度最快，而选项5速度则最慢。
默认参数: 1 (int)
PP -
设置后期处理模式。
这是控制TFM如何处理（或者不处理）任何经过场匹配后遗留的交错帧。
可用参数如下：
0 - 什么都不做（甚至不寻找交错帧）
1 - 发现或者提示交错帧，但不做反交错
2 - 静态混合反交错
3 - 静态三次插值反交错
4 - 静态modified-ela反交错
5 - 运动适应混合反交错
6 - 运动适应静态三次插值反交错
7 - 运动适应modified-ela反交错
也可使用“clip2”参数来指定一个外部反交错剪辑，TFM会用帧来取代反交错。
更多信息见clip2参数说明，及PP设定如何与clip2一同操作。
也可手动控制、标记哪些帧是交错的，以及针对无效文件的PP选项（见参数说明）
默认参数: 6 (int)
C.) ADVANCED PARAMETERS: 高级参数
这些参数对匹配操作能进行更好的控制，发现交错帧，对交错帧进行反交错。正确处理这些值可以增加匹配准确度，也能把事情搞糟。
field -
设定匹配的场。推荐将其设为相同值，除非出现匹配失败。在某些情况下，改变匹配场可对匹配效果产生很大的影响。可用参数如下：
-1 = auto 自动(TFM将把场设为与order参数相同的值)
0 = bottom 场
1 = top 场
默认参数: -1 (int)
slow -
设定使用哪个场匹配。可用参数：
0 - 普通 （准确性不佳）
1 - 慢速
2 - 非常慢 （准确性最佳）
这个是针对质量与速度的选择（速度越慢越精确）。在TFM在v0.9.9.1之前，这是个布尔值，在旧版本中，当前值为1时对应为true，当前值为0时对应为false。
默认参数: 1 (int)
mChroma -
设定是否在匹配对比中包括chroma色度。
一般情况下推荐将其设为可以。除非显卡有严重色度问题，如重度色带或其他情况，你应将此设为false。将其设为false也可以牺牲一些准确度为代价来提高速度。
true = 包括色度
false = 不包括色度
默认参数: true (bool)
y0/y1 -
这个定义出一条排除带，将y0和y1之间的线排除在场匹配之外。
排除带可用来忽略标题，logo，或其他妨碍匹配的东西。y0设置起始扫描线，y1设置结束线，在y0和y1之间所有的线（包括y0和y1）都将被忽略。
将y0设置为和y1等值将设为不启用。
默认参数: y0 - 0 (int)
y1 - 0 (int)
scthresh -
设置画面改变的起点，作为在luma plane中最大改变的百分比。
较好的值为8.0 到 14.0之间。 画面改变侦测使用如下参数：ubsco, mmsco, and flags（仅当flags=5），scthresh的范围为[0.0, 100.0]。
默认参数: 12.0 (double)
ubsco -
允许u/b匹配只在场变换时使用。scthresh参数设置画面改变的起点，作为在luma plane中最大改变的百分比。使其无效（允许任何位置均可u/b匹配）将ubsco设为false。ubsco设置只对自动匹配起作用，即，u/b匹配通过超范围或输入文件也不会改变。唯一使用ubsco的匹配modes是 2, 3, 5,和 6（只有这些使用u/b匹配）。
默认参数: true (bool)
micmatching -
当micmatching大于0时，tfm将把匹配的mic值考虑在内。
当决定用哪项匹配作为最终匹配时，micmatching有5个可用的设定：
0 - 不可用
1 - mics只被用来判断5项可用匹配中是否有1个匹配的mic值比其他4个匹配都要显著地低很多。启用此项时，tfm可以使用任何匹配(p/c/n/b/u)而不用考虑匹配mode!
2 - 使用mics来帮助现有的匹配mode（唯一的可以用在现有匹配mode中使用的匹配）
3 - 同时做选项1和选项2
4 - 只做后场匹配检查（这个操作包含在micmatching modes 1,2,和3中,而且不针对mmsco参数）。故障排除输出将在micmatching导致匹配决定改变时给出指示。使用micmatching将使处理过程变慢，因其需计算一般不会被计算的匹配的mic值。mmsco参数可用来将micmatching限制在只画面改变时使用。将mmsco设为true来使用。然后，只有在一个画面每一边的帧可被micmatching影响。TFM的v0.9.10.0版本中，micmatching默认为1。就意味着5项中的任何1项都可以在不考虑匹配mode时使用。如果你不想用这个，就将micmatching设为0。TFM的v0.9.12.6版本中，所有的micmatching modes将在每次场匹配后进行一次检查，即当mic值很明显表示选择了错误的匹配。 这部分独立于mmsco参数起作用。
默认参数: 1 (int)
mmsco -
允许micmatching只为场面改变时。scthresh参数设置画面改变的起点，作为在luma plane中最大改变的百分比。
如设为true, micmatching 将被限制在画面改变。如设为false,则任何地方均允许micmatching 。
默认参数: true (bool)
hint -
可将线索信息写入帧中供tdecimate或tdeint读取。信息包括使用匹配，交错vs动态，及d2v rff信息。
true为可写，false 为不可写。
默认参数: true (bool)
opt -
控制使用的优化效果。可用设置：
0 – 使用c指令集
1 – 使用mmx指令集
2 – 使用isse指令集
3 – 使用sse2指令集
4 – 自动选择
默认参数: 4 (int)
下面的“高级参数”中，控制交错帧查找和反交错，只在mode设为1、2、4，或PP设为1或更大时使用！
cthresh -
这是区交错起点，用于交错帧检测。这与telecide()和场反交错的dthresh或dthreshold相似。
这实际上控制多“强”或“可见”的交错需被探查。较大值意味着交错必须更明显，较小值意味着交错可相对较弱或比较隐蔽。有效设定从-1（每个交错像素都被探查）至255（任何交错像素都不被探查），这实际上是个像素值。8-12之间是较好的范围。
默认参数: 9 (int)
chroma -
设定是否在交错帧决定中考虑色度。
一般设为不可用，除非片源有严重的色度问题（如彩虹条或其他情况），将此设为可用。实际上，使用chroma=false更为可靠，除了对于那些片源中只有色度交错的问题之外。
true = 包括色度
false = 不包括色度
默认参数: false (bool)
blockx -
设定在交错帧探查中窗口的x轴尺寸。
这个要与区域大小相关，区域内对MI像素数要求被探查为交错，以使某帧被判断为交错。
更多信息见MI参数说明。可能值为2的任何次方，以4为起点，至2048（如：4, 8, 16, 32, ... 2048）。
默认参数: 16 (int)
blocky -
设定在交错帧探查中窗口的y轴尺寸。
这个要与区域大小相关，区域内对MI像素数要求被探查为交错，以使某帧被判断为交错。
更多信息见MI参数说明。可能值为2的任何次方，以4为起点，至2048（如：4, 8, 16, 32, ... 2048）。
默认参数: 16 (int)
MI -
MI交错像素在任何blocky乘blockx区域内阻塞将帧探查为交错帧。当cthresh控制交错将必须为多“可见”时，此项设定控制在某一区域内帧上的交错必须为“多少”（一个由 blockx和 blocky设定的窗口）。最小设定 = 0，最大设定 = blocky x blockx（任何帧都不会被探查为交错的。）
默认参数: 80 (int)
metric -
设定使用哪个空间交错公制来探查交错像素。可用选项：
假设5个临近的像素(a,b,c,d,e) 竖直排列
a
b
c
d
e
0: d1 = c - b;
d2 = c - d;
if ((d1 > cthresh && d2 > cthresh) || (d1 < -cthresh && d2 < -cthresh))
{
if (abs(a+4*c+e-3*(b+d)) > cthresh*6) it's combed;
}
1: val = (b - c) * (d - c);
if (val > cthresh*cthresh) it's combed;
Metric 0是tfm之前在v0.9.12.0中用的。
Metric 1是在Donald Graft的场交错()/IsCombed()中使用的功能，在decomb.dll中。
默认参数: 0 (int)
mthresh -
当使用动态适应时，设定动态起点（不同像素）进行反交错(PP > 4)。如前文所说，这只是个帧之间不同像素起点如果在mthresh下，一个像素被认为时静态的，超过mthresh才被认为是动态的。
默认参数: 5 (int)
clip2 -
当PP>1时，这个参数可用来制定某clip将反交错帧取代TFM内建的反交错方式。
如PP<5，帧将从clip2中取得，如PP >= 5（即 使用动态适应）TFM将按常规建立mask，而且只有在动态区域内像素才被clip2的帧取代。不要指定任何东西，以便使用TFM内置的反交错。
使用clip2的例子请见clip2_sample_avs.avs
默认参数: NULL (PClip)
D.) FILE INPUT/OUTPUT PARAMETERS: 文件输入/输出参数
这些设定处理超范围文件的应该和输入/输出文件选择
d2v -
这个选择是当你用mpeg2source()和d2v时使用的。
它将名称和路径设定为d2v文件，以便于TFM分析看是否有不合法的场顺序，及用d2v文件的场顺序自主设定次序参数。如果d2v文件中发现不合法的场顺序转换，TFM将创建一个固定的d2v文件，带有“-fixed”字样在文件名末尾。新文件和源文件将在同一目录下。你可以使用fixed文件进行处理。如果场参数设为“-1”，TFM将从d2v文件探查场顺序，并将顺序参数配合设置。依据flags参数的值，TFM也将用d2v的信息来进行场匹配，并将信息从d2v传至tdecimate来帮助duplicate探查和hybrid探查。
注释：这个选项目前支持我所注意到的所有d2v格式，包括dvd2avi 1.76, 1.77.3及其变体，及所有dgindex版本。
范例 => TFM(d2v="myd2v.d2v")
默认参数: "" (String)
flags -
控制从d2v文件中得到的信息得到多少的应用，当"d2v"参数进行了设置。
0- 检查d2v文件的不合法转换，并在如没有手动进行设置时设置场参数。还有，将rffflag duplicate信息传至tdecimate。
1- 与0相同，加上在影片片段使用trf flags进行场匹配（在trf flags格式为012301...的片段）
2- 与1相同，但用trf flags在所有范围内进行场匹配（不用是0123格式）（非常不推荐）
3 - 与0相同，但是部将任何信息传入tdecimate（如，至设定次序和检查不合法转换）
4 - 与1相同，但是d2v匹配在交错时进行检查。如果某一d2v匹配被发现为交错，tfm将用内设匹配路径对此帧进行处理。
5 - 与4相同，但是d2v匹配只在画面变换时进行交错检查。
非常重要（必须阅读）：为了让选项0, 1, 2, 4,及5正确执行，要立刻在mpeg2source()指令后衔接tfm/tdecimate，这之间的任何滤镜都不可以用任何方式改变数据流中的顺序或场数。或用trimIn文件来告知TFM哪些帧已经被舍弃。
默认参数: 4 (int)
