ydl2 0.1.5

OpenCV 轻量扩展：Unicode 路径读写、HALCON 风格灰度缩放

ydl2

ydl2 是对 OpenCV 的轻量补充：解决 Windows 中文路径 读写问题，并提供与 HALCON 语义一致的灰度缩放算子。

安装

pip install ydl2

快速使用

import ydl2
import numpy as np

# Unicode 路径读写（Windows 中文路径）
img = ydl2.imread(r"D:\图片\测试.png")
ydl2.imwrite(r"D:\图片\输出.png", img)

# HALCON 等价算子
stretched = ydl2.scale_image_max(img)          # scale_image_max
inverted = ydl2.scale_image(img, -1.0, 255.0)  # scale_image（byte 反转）
mapped = ydl2.scale_image_range(img, 100, 200)   # scale_image_range
# 扩展区间： [100,200] -> [50,250]
mapped2 = ydl2.scale_image_range(img, (100, 50), (200, 250))

API

函数	说明
imread / imwrite / imshow	支持中文路径的读写与显示
scale_image_max	每通道 min/max 拉伸到 0–255（byte）
scale_image	g' = g * Mult + Add，输出类型与输入一致
scale_image_range	区间线性映射，区间外裁到目标端点（byte）

依赖

• Python >= 3.8
• numpy >= 1.21
• opencv-python >= 4.6

链接

• 仓库：https://github.com/CiweiWenruo/ydl2