捕获可视来源

支持的来源

视频和现成的媒体文件用作查看和选择帧的来源； Capture 不会将它们重新录制为新的视频文件。

录制模式

• 定时：按所选频率添加帧。
• 围绕操作： 帧在键盘或鼠标操作之前、期间和之后保存。
• 单帧：将当前素材传给 Selector，无需长时间录制。

频繁录制和大型源会增加处理器、内存和磁盘的负载。在进行长时间会话之前，请检查所选的频率和存储目录。

时间轴

时间轴显示帧的顺序及其与来源的关系。可跳转到指定帧、更改范围、删除不需要的帧，并选择用于标注的素材。

从当前序列中删除帧可能影响关联操作和标注。批量编辑前，请保存录制的副本。

操作录制和 Action CV

动作录制将键盘和鼠标事件与帧关联。实验性的 Action CV 可以使用 LLM 进行规划，并通过本地计算机视觉操作进行处理，以建议动作的视觉目标。

建议目标需要用户检查，并与原始录制数据一同保存。分析结果不会替换原始动作和帧。

网络流和访问凭据

选择网络流时，Screph 会直接连接指定地址。尽量避免在 URL 中保存长期密码和令牌。如果地址包含访问凭据，应将本地设置作为敏感数据保管。

导出帧

选定帧以 PNG 格式导出，并附带来源和时间信息。导出会创建独立文件，不能替代保存项目。取消后，已写入的文件可能保留在文件夹中；最终清单用于确认整个导出已完成。

标注前

1. 检查来源、缩放和所需的时间范围。
2. 删除明显不需要的帧，并保留录制的备份。
3. 选择帧并传给 Selector。

来源、录制与停止

1. 在“捕获”选项卡中选择数据源及其参数：窗口或显示器、屏幕区域、摄像头、流地址或文件。检查数据源图像。
2. 设置录制频率、存储方式和帧模式。开始录制后，数据源会显示在时间轴上。暂停播放不会停止录制。
3. 停止录制后，选择帧、范围和采样步长。将单帧传给 Selector，或将所选范围用于导出、数据集或帧序列处理。若需长期使用内存中的素材，请将其保存为文件。

发送到 Selector 的帧属于来源的某个具体状态。切换摄像头、文件或时间线不会将旧结果移到新帧。继续标注、训练或序列处理时，需要重新选择所需帧或范围。

摄像头标定

1. 选择镜头模型和标定板。棋盘格需输入内角点数量，ChArUco 需输入方格数量。测量方格的实际尺寸。“创建标定板…”会保存可打印的标定板；打印时不要缩放以适应纸张。
2. 确认使用同一摄像头，分辨率、焦距和变焦保持不变，且未预先进行镜头校正。添加文件、“时间轴帧…”或运行中数据源的帧。“自动采集”会获取新的稳定帧；采集时请改变标定板的位置和倾斜角度。
3. 在表格中检查检测到的标定板和每帧的用途：计算、验证或跳过。“计算”至少需要八个计算帧和三个留出的验证帧。重复帧、未检测到标定板的帧以及尺寸不兼容的帧不能用于计算。
4. 计算后，分别检查拟合误差和验证误差、图像覆盖范围以及警告。停止采集或取消计算后，已接受的数据集会保留到应用关闭。恢复 ZIP 后，实时采集需要新建数据集；程序不会自动假定重新连接的是同一摄像头。

在 General、Industrial 和 UAV 模式下，可从“捕获”选项卡的“来源”组打开“摄像头标定…”，支持摄像头、流和文件来源。屏幕捕获和 GUI Automation 模式不提供此路径。窗口为非模态窗口；“详细控制”显示同一标定数据集的参数和报告。

JSON 配置保存计算出的参数，ZIP 数据集用于稍后继续处理这些帧，“加入项目库”将一个版本保存到项目中。保存 Selector 不能替代保存标定 ZIP。“校正图像…”处理来自同一摄像头、尺寸相同的图像；结果可另存为 PNG。

比较镜头模型后，需要新的独立验证帧。“用新帧验证”检查已保存参数，不重新拟合。仅完成标定不能证明设备上的测量精度，也不能确定单目轨迹的米制尺度。