Metadata-Version: 2.4
Name: ydl2
Version: 0.1.4
Summary: OpenCV 轻量扩展：Unicode 路径读写、HALCON 风格灰度缩放
Author-email: 无敌的杨 <ydl779762225@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/CiweiWenruo/ydl2
Keywords: opencv,cv2,image,halcon,scale_image
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.21
Requires-Dist: opencv-python>=4.6
Dynamic: license-file

# ydl2

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

## 安装

```bash
pip install ydl2
```

## 快速使用

```python
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>
