VapourSynth中CopyFrameProps函数props参数失效问题分析

VapourSynth R66 RC版本中的std.CopyFrameProps()函数被发现存在一个功能性问题。该函数设计用于从一个视频帧复制指定的属性到另一个视频帧，但在实际使用中发现其props参数未能正确过滤需要复制的属性。

问题现象

当开发者尝试使用std.CopyFrameProps函数时，即使明确指定了props参数来限制只复制特定属性，函数仍然会将源帧的所有属性都复制到目标帧。例如：

black = core.std.BlankClip().std.RemoveFrameProps()
black = black.std.SetFrameProps(_Matrix=1, test=2)

white = core.std.BlankClip(color=[255,255,255])

# 预期只复制test属性，但实际上复制了所有属性
test = core.std.CopyFrameProps(clip=white, prop_src=black, props="test")

在上述代码中，开发者期望只复制"test"属性，但实际输出却包含了"_Matrix"和"test"两个属性。

技术背景

VapourSynth是一个视频处理框架，它允许通过Python脚本来处理视频数据。帧属性(FrameProps)是该框架中重要的元数据机制，可以附加各种信息到视频帧上，如色彩矩阵、自定义标记等。

std.CopyFrameProps函数的设计目的是为了有选择性地复制这些帧属性，其props参数理论上应该能够精确控制需要复制的属性列表。

问题影响

这个bug会影响以下场景：

1. 需要精确控制帧属性复制的自动化处理流程
2. 需要避免某些属性被意外覆盖的情况
3. 对帧属性有严格要求的后期处理链

解决方案

该问题已在最新版本中得到修复。修复后，std.CopyFrameProps函数将严格遵循props参数指定的属性列表进行复制，不再复制未指定的属性。

对于需要使用该功能的开发者，建议：

1. 升级到修复后的VapourSynth版本
2. 在升级前，可以通过手动检查并删除不需要的属性作为临时解决方案

最佳实践

在使用帧属性相关功能时，建议：

1. 明确命名自定义属性，避免与内置属性冲突
2. 在复制属性前先检查源帧包含哪些属性
3. 对于关键处理流程，添加属性验证步骤

这个问题的修复体现了VapourSynth项目对API一致性和功能可靠性的重视，确保了视频处理流程中元数据操作的精确性。