75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
|
# @go/vision
|
|||
|
|
|
|||
|
|
极致精简、工业级的高性能图像处理与全能媒体工具集。
|
|||
|
|
|
|||
|
|
## 🎯 设计哲学
|
|||
|
|
|
|||
|
|
`go/vision` 致力于消除 Go 语言在媒体处理领域的摩擦。通过纯 Go 的核心算法与标准化的外部工具编排，提供一套语义一致、零摩擦、高性能的 API 体系。
|
|||
|
|
|
|||
|
|
* **零摩擦**: 自动探测/引导环境准备（如 FFmpeg），一键式识别与转换。
|
|||
|
|
* **工业级**: 错误驱动架构（No internal logging），完备的单元测试覆盖。
|
|||
|
|
* **全能型**: 涵盖静态图、动图、视频、扫码、色彩分析与几何变换。
|
|||
|
|
|
|||
|
|
## 🚀 核心能力
|
|||
|
|
|
|||
|
|
### 1. 基础绘图与画布 (Canvas)
|
|||
|
|
* **流式 API**: 支持矩形、圆角、路径、点/线、阴影、暗角等绘制。
|
|||
|
|
* **现代文本**: 内置 `CompositeFace`，完美支持多字体回退 (Fallback) 与中英文混排。
|
|||
|
|
|
|||
|
|
### 2. 图像处理与变换
|
|||
|
|
* **几何变换**: 缩放 (Resize/Fit/Fill)、旋转、镜像、**4 点透视变换 (WarpPerspective)**。
|
|||
|
|
* **高级滤镜**: 模糊、锐化、灰度、亮度/对比度、怀旧 (Sepia)、像素化。
|
|||
|
|
* **色彩分析**: 调色板提取 (`ExtractPalette`)、平均色计算。
|
|||
|
|
|
|||
|
|
### 3. 智能视觉 (Intelligence)
|
|||
|
|
* **码码识别**: 集成 QR Code、条形码 (Code128, UPC/EAN) 的生成与自动解码识别。
|
|||
|
|
* **感知哈希 (PHash)**: 基于图像特征的指纹计算，用于海量图片相似度查重。
|
|||
|
|
* **验证码引擎**: 高强度抗 OCR 图形验证码生成。
|
|||
|
|
|
|||
|
|
### 4. 动态媒体 (Animation & Video)
|
|||
|
|
* **GIF 引擎**: 高质量 GIF 序列生成，内置 `Plan9` 调色板与 `Floyd-Steinberg` 抖动。
|
|||
|
|
* **视频编排**: 基于 FFmpeg 的视频帧提取与合成，支持多平台二进制自动引导。
|
|||
|
|
|
|||
|
|
## 📦 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
go get apigo.cc/go/vision
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 💡 快速开始
|
|||
|
|
|
|||
|
|
### 扫码识别
|
|||
|
|
```go
|
|||
|
|
c, _ := vision.Load("code.jpg")
|
|||
|
|
content, err := c.DecodeAll() // 自动尝试 QR 和条码
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 视频帧处理
|
|||
|
|
```go
|
|||
|
|
v, _ := vision.NewVideo()
|
|||
|
|
frame, _ := v.ExtractFrame("video.mp4", 5.0)
|
|||
|
|
frame.Grayscale()
|
|||
|
|
vision.Save(frame, "snapshot.png")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 提取主色调
|
|||
|
|
```go
|
|||
|
|
palette := canvas.ExtractPalette(5)
|
|||
|
|
for _, c := range palette {
|
|||
|
|
fmt.Println("发现主色:", c.Hex)
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🛠 API 概览
|
|||
|
|
|
|||
|
|
| 模块 | 主要 API |
|
|||
|
|
| :--- | :--- |
|
|||
|
|
| **Canvas** | `New`, `Load`, `Save`, `Clear`, `Sub`, `Clone`, `Put` |
|
|||
|
|
| **Draw** | `Rect`, `RoundedRect`, `Circle`, `Line`, `Path`, `RandBG` |
|
|||
|
|
| **Effect** | `Resize`, `Rotate`, `Blur`, `Sharpen`, `AdjustBrightness`, `Grayscale` |
|
|||
|
|
| **Recognition** | `DecodeQRCode`, `DecodeBarcode`, `DecodeAll`, `PHash`, `Distance` |
|
|||
|
|
| **Media** | `NewAnimation`, `NewVideo`, `ConvertAll`, `Optimize` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
本项目由 AI 驱动开发与维护，遵循极致的代码质量与性能标准。
|