OpenCV YAML 文件读写

这部分功能位于 pywayne.cv.tools 模块中，提供了读取和写入 OpenCV cv2.FileStorage 支持的 YAML 格式文件的函数。

主要功能:

• read_cv_yaml(file_path: str): 读取 OpenCV YAML 文件并返回一个字典。支持基本数据类型、NumPy 数组以及嵌套的字典和列表。

• write_cv_yaml(file_path: str, data: dict): 将字典写入 OpenCV YAML 文件。支持基本数据类型、NumPy 数组，以及嵌套的字典和列表。

示例:

>>> import numpy as np
>>> from pywayne.cv.tools import read_cv_yaml, write_cv_yaml
>>>
>>> # 准备要写入的数据
>>> data_to_write = {
...     "matrix": np.eye(3),
...     "integer_value": 10,
...     "float_value": 3.14,
...     "string_value": "hello_cv",
...     "list_value": [1, 2, 3, {"nested_in_list": "item_in_list_dict"}],
...     "nested_dictionary": {
...         "sub_item_A": "text_val",
...         "sub_item_B": 789,
...         "sub_list_in_dict": [True, False, 0.5]
...     }
... }
>>>
>>> # 写入 YAML 文件
>>> output_file = "cv_config.yaml"
>>> success = write_cv_yaml(output_file, data_to_write)
>>> if success:
...     print(f"成功写入到 {output_file}")
>>>
>>> # 从 YAML 文件读取
>>> read_data = read_cv_yaml(output_file)
>>> if read_data:
...     print(f"从 {output_file} 读取的数据:")
...     for k, v in read_data.items():
...         print(f"  {k}: {v}")

pywayne.cv.tools.read_cv_yaml(file_path: str) → Dict[str, Any] | None

读取 OpenCV YAML 文件，支持嵌套结构和基本类型。

Parameters:

file_path – YAML 文件路径。

Returns:

包含文件内容的字典，如果读取失败则返回 None。

pywayne.cv.tools.write_cv_yaml(file_path: str, data: Dict[str, Any]) → bool

将字典写入 OpenCV YAML 文件。

Parameters:

• file_path – 要写入的 YAML 文件路径。

• data – 要写入的字典数据。 支持类型: np.ndarray, int, float, str, list (基本类型), dict (基本类型).

Returns:

如果写入成功则返回 True，否则返回 False。