.. _menu:

主菜单
======

主菜单包含以下部分：

- 文件
- 来源
- 设置
- 帮助

下面分别介绍各部分

.. _file:

文件
----

“文件”部分包含“另存为...”和“打开...”两条命令。前者用于将区域设置保存为扩展名为 mv 的文件，后者用于打开该文件。这两条命令也可以通过快捷键 ctrl+s 和 ctrl+o 分别访问。

来源
----

此部分用于选择程序处理帧/图像的来源。

摄像头
~~~~~~

显示程序启动时可用的所有网络摄像头和 IP 摄像头。IP 摄像头的链接可由用户填写在相对于 :ref:`catalog` 的文件 ``input/ip_cameras.txt`` 中（每行一个链接）。
摄像头列表不会自动更新；要刷新列表，可使用“更新”命令。

.. note::

   如果在程序运行过程中连接了新的网络摄像头，除非执行“更新”命令，否则它不会出现在菜单中。

   无论 IP 摄像头当前是否可用，列表都会显示。如果所选摄像头不可用，它将无法工作。请确保通过 **RTSP** 协议正确填写 IP 摄像头链接。具体链接格式由摄像头厂家决定。例如：

   ``rtsp://admin:12345@192.168.200.11:554/Streaming/Channels/101``

从手机推流
^^^^^^^^^^

可以将智能手机用作 IP 摄像头：在手机上安装可通过 RTSP（或在支持的情况下通过 HTTP）传输摄像头画面的应用，
把得到的链接写入 ``input/ip_cameras.txt``，然后在菜单 **来源 → 摄像头** 中选择该摄像头。

例如，可使用 **IP Webcam** (Android)。也可以使用其他类似应用 (Android 或 iOS)，
关键是能够通过网络稳定提供视频流，并由应用显示可用的流地址。

典型步骤：

1. 在手机上安装视频推流应用（例如 IP Webcam 或同类应用）。
2. 启动推流，并按需要在应用设置中配置用户名、密码和端口。
3. 确保手机与运行 MeterVision 的计算机处于同一网络（Wi‑Fi/LAN），或以其他方式使计算机能够访问手机的 IP 地址。
4. 从应用中复制 RTSP 链接（具体格式因应用而异），例如：

   ``rtsp://user:pass@172.16.0.10:8080/h264_ulaw.sdp``
5. 将链接写入 ``input/ip_cameras.txt``，在 MeterVision 摄像头菜单中执行“更新”，并选择相应的 IP 摄像头。

在手机应用中通常还可以控制画面（变焦、分辨率、闪光灯等），便于将手机对准仪表而无需专用 IP 摄像头。

.. _examples:

示例
~~~~

用于加载内置示例，以便快速演示程序功能。

选择照片
~~~~~~~~

用于选择并加载一张照片进行处理。

选择视频
~~~~~~~~

用于选择并加载一个视频进行处理。

.. _settings:

设置
----

.. _tesseract:

连接神经网络...
~~~~~~~~~~~~~~~~~

要使用“神经网络”方法进行识别，需要指定 Tesseract-OCR 可执行文件的路径。

- Windows: `tesseract.exe`
- Linux 和 macOS: `tesseract`

请先安装 Tesseract-OCR 程序。

.. note::

   Tesseract 是开源的光学字符识别（OCR）引擎，是最流行且高质量的 OCR 库之一。

   OCR 使用神经网络在图像中查找并识别文本。

语言
~~~~

你可以从提供的列表中选择任意程序界面语言。选择后需要重启程序。为此，请在选择语言后弹出的对话框中点击“是”。如果由于某些原因程序未自动重启，请手动重启。

程序启动时打开摄像头
~~~~~~~~~~~~~~~~~~~~~

该选项决定程序启动时是否自动开启摄像头并将其作为“来源”。无论选择如何，程序启动时都会检查所有可用摄像头。

摄像头分辨率
~~~~~~~~~~~~~

请选择所需的摄像头分辨率。

.. note::

   能否选择某一分辨率取决于摄像头本身而非程序。本程序并不能为所有摄像头设置任意分辨率。是否成功设置所需分辨率的消息，请查看 :ref:`log`。

.. _res:

识别结果
~~~~~~~~

“将结果叠加到图像上”用于开启/关闭在图像上叠加识别结果的模式。

“将结果写入文本文件中”用于开启/关闭持续将结果写入位于 :ref:`catalog` 中 output 文件夹的文本文件的模式。每个区域会生成一个以区域编号命名的文件，同时还会生成一个 results.txt 文件，记录所有识别结果。

“通过 socket 传输结果”用于开启/关闭 socket 服务器。开启后，程序会等待外部程序连接
（主机与端口在 :ref:`catalog` 的 ``input/socket_config.txt`` 中配置）。

通过 socket，外部程序可以请求当前识别结果，并向 MeterVision 发送控制命令。
协议说明、命令列表与代码示例见 :ref:`external`。

工作目录...
~~~~~~~~~~~

用于选择新的程序 :ref:`catalog`。默认位置为 Documents/MeterVision。

更改工作目录后，可以并行运行多个程序实例或版本：
每个实例拥有各自的目录（设置、日志、许可证以及 input/output 文件），因此互不干扰。

选择目录后：

1. 当前工作目录的内容会复制到所选目录（不包括 ``output`` 文件夹：新目录中仅创建空的 ``output/screenshots`` 和 ``output/figures``）。
2. 程序切换到新目录：结果、日志、设置、许可证文件以及 input 文件夹中的文件都将写入该目录。
3. 所选路径会保存到 ``Documents/MeterVision/settings/work_dir.txt``，并在后续启动时使用。

.. note::

   不能选择当前工作目录内的子目录，否则复制时会出错。
   “恢复默认设置”不会重置已选择的工作目录。
   即使程序在其他位置工作，工作目录路径文件也始终保存在默认目录中。

保存设置
~~~~~~~~

将主菜单中的当前设置保存，以便下次启动时使用。

恢复默认设置
~~~~~~~~~~~~

将主菜单中的设置恢复为默认值。

帮助
----

用于查看程序版本并打开文档。