电视图文信号处理工具技术文档

1. 安装指南

1.1 环境准备

在使用CUDA解码功能之前，您需要安装Nvidia的专有驱动程序。为了安装可选依赖项，请运行以下命令：

pip3 install -e .[CUDA,spellcheck,viewer]

如果您的平台不支持CUDA或pyenchant，可以简单地从安装命令中省略它们。

1.2 OpenCL支持

要使用OpenCL，您需要安装pyopencl以及适用于您显卡的OpenCL运行时。然后，使用-O选项运行deconvolve命令。

1.3 字体与终端设置

为了正确渲染输出，您需要使用特定的字体和终端：

sudo apt-get install tv-fonts rxvt-unicode

然后，在X服务器中启用位图字体：

cd /etc/fonts/conf.d
sudo rm 70-no-bitmaps.conf
sudo ln -s ../conf.avail/70-yes-bitmaps.conf .

完成此操作后，您可能需要重新加载字体缓存：

xset fp rehash

最后，打开一个使用所需字体的终端：

urxvt -fg white -bg black -fn teletext -fb teletext -geometry 41x25 +sb &

2. 项目的使用说明

2.1 录制VBI信号

首先，从VHS录制VBI信号：

teletext record -d /dev/vbi0 > capture.vbi

2.2 解卷积录制文件

对录制的文件进行解卷积处理：

teletext deconvolve capture.vbi > stream.t42

2.3 查找磁带上的服务

检查头部信息以找到磁带上的服务：

teletext filter -r 0 stream.t42

2.4 分割捕获文件

将捕获文件按服务分割：

teletext filter --start <N> --stop <N> stream.t42 > stream-1.t42

2.5 显示流中的所有页面副本

显示流中某个页面的所有副本：

teletext filter stream.t42 -p 100

2.6 压缩重复子页面

压缩重复的子页面以减少错误：

teletext squash stream.t42 > output.t42

2.7 生成HTML页面

从流中生成HTML页面：

teletext html output/ stream.t42

2.8 交互式查看页面

交互式查看t42流中的页面：

teletext service stream.t42 | teletext interactive

在交互式查看器中，您可以输入页码，或输入.以保持当前页面。

3. 项目API使用文档

3.1 teletext record

录制VBI信号。

参数：

• -d：指定VBI设备路径。

示例：

teletext record -d /dev/vbi0 > capture.vbi

3.2 teletext deconvolve

对录制的VBI信号进行解卷积处理。

示例：

teletext deconvolve capture.vbi > stream.t42

3.3 teletext filter

过滤和解码t42流。

参数：

• -r：显示头部信息。
• --start：指定起始服务编号。
• --stop：指定结束服务编号。
• -p：显示指定页面的所有副本。

示例：

teletext filter -r 0 stream.t42
teletext filter --start 1 --stop 2 stream.t42 > stream-1.t42
teletext filter stream.t42 -p 100

3.4 teletext squash

压缩重复的子页面。

示例：

teletext squash stream.t42 > output.t42

3.5 teletext html

从t42流生成HTML页面。

示例：

teletext html output/ stream.t42

3.6 teletext interactive

交互式查看t42流中的页面。

示例：

teletext service stream.t42 | teletext interactive

4. 项目安装方式

4.1 使用pip安装

您可以使用pip安装该项目及其依赖项：

pip3 install -e .[CUDA,spellcheck,viewer]

4.2 手动安装

如果您希望手动安装，可以克隆项目仓库并安装依赖项：

git clone <项目仓库地址>
cd <项目目录>
pip3 install -r requirements.txt

4.3 安装可选依赖项

根据您的需求，您可以选择安装CUDA、拼写检查或查看器支持：

pip3 install -e .[CUDA,spellcheck,viewer]

4.4 配置字体与终端

确保按照“安装指南”中的步骤配置字体与终端，以确保输出正确渲染。

---

通过本文档，您应该能够顺利安装、配置并使用该电视图文信号处理工具。如有任何问题，请参考各命令的--help选项获取更多详细信息。