# 智绘图片 — 专业图像处理系统 v13.5

## 产品简介

智绘图片是一款纯前端运行的专业级图像处理系统，所有算法均在浏览器本地执行，**无需联网、不上传服务器、保护隐私**。支持 70+ 种图像处理功能，涵盖基础编辑、智能 AI 处理、艺术特效、人像美容、色彩调整等全方位需求。

**浏览器要求**: Chrome 80+ / Firefox 75+ / Edge 80+ / Safari 13+

---

## 功能区一览

### 基础工具
| 功能 | 说明 |
|------|------|
| 裁剪 | 自由裁剪 / 1:1 / 3:4 / 4:3 / 16:9 比例约束，支持 8 方向拖拽调整 |
| 画笔 | 圆形笔刷精确涂抹，区域完整覆盖无间隙 |
| 马赛克 | 块平均法，涂抹区域精确处理 |
| 橡皮擦 | Telea FMM / Bertalmio NS 方程智能消除 |
| 文字替换 | 智能消除背景后自动计算字号添加文字 |
| 添加文字 | 画布上添加/拖拽/旋转/编辑文字块，支持透明度/阴影/背景 |

### 智能编辑
| 功能 | 说明 |
|------|------|
| 智能消除 | 画笔涂抹 → Telea/Bertalmio 算法消除 |
| 文字替换 | 画笔涂抹消除区域 → 自动字号计算 → 添加文字 |
| 添加文字 | 多行文字编辑，支持拖拽位置、旋转、透明度 |
| 智能抠图 | GrabCut 图割算法（K-means GMM + 概率传播迭代） |
| 一键增强 | 自动优化亮度/对比度/饱和度 |
| 一键抠人 | 肤色检测 + 形态学优化 |
| 内容填充 | 方式一：指定颜色填充；方式二：PatchMatch + 引导线性插值 |
| 位图转矢量 | K-means++ 聚类 + 轮廓追踪 → SVG 导出 |
| 形状遮罩 | 圆形/椭圆/星形/心形/圆角，支持拖拽缩放 |

### 人像美容（画笔涂抹局部处理）
| 功能 | 说明 |
|------|------|
| 祛痘祛斑 | 涂抹区域 → 局部中值滤波修复 |
| 精细磨皮 | 涂抹区域 → 双边滤波磨皮 |
| 红眼消除 | 涂抹区域 → YCbCr 红眼检测修复 |
| 牙齿美白 | 涂抹区域 → LAB 空间亮度调整 |
| 智能染发 | 涂抹区域 → LAB 色相调整 |
| 人脸修复 | YCbCr 肤色检测 + 自适应锐化 |

### 滤镜效果
| 功能 | 说明 |
|------|------|
| 油画 | Kuwahara 滤波保留边缘的平滑效果 |
| 素描 | 高反差保留 + 铅笔线条风格 |
| 浮雕 | 3D 浮雕浮雕效果 |
| 像素化 | 马赛克像素化 |
| 半调 | 报纸印刷点阵风格 |
| 卡通/漫画 | 盒式模糊 + 颜色量化 + 边缘叠加 |
| 水彩 | 盒式模糊 + 颜色量化 + 湿边效果 |
| 霓虹 | 边缘检测 + 发光叠加 + 颜色混合 |
| 胶片 | 电影胶片色彩模拟 |
| 铅笔画 | 灰度 + 铅笔纹理 |
| 玻璃 | 随机折射扭曲效果 |
| 漩涡 | 极坐标漩涡扭曲 |
| 波浪 | 正弦波扭曲 |
| 镜像 | 水平/垂直/四角镜像 |
| 倾斜移轴 | 高斯模糊 + 透视变换 |

### 色彩调整
| 功能 | 说明 |
|------|------|
| 色彩平衡 | RGB 三通道独立调整 |
| 曲线调整 | RGBA 四通道曲线控制 |
| 色阶 / 直方图均衡 | 自动/手动色阶调整 |
| 高级白平衡 | 灰度世界 + 完美反射 |
| 亮度/对比度/饱和度 | 基础调整 |
| 色相/曝光/色温 | 高级色彩调整 |
| HDR 增强 | 局部自适应对比度增强 |
| 超分辨率 | Lanczos 插值放大 |
| 透视校正 | 四点透视变换 |

### 艺术特效
| 功能 | 说明 |
|------|------|
| LOMO | 色彩偏移 + 柔和暗角 + 中心提亮 |
| 复古 / 宝丽来 / 交叉处理 | 经典胶片色彩模拟 |
| 分离色调 | 高光/阴影分别着色 |
| 照片滤镜 | 模拟彩色滤镜效果 |
| 清晰度 | 局部对比度增强 |
| 降噪 | 非局部均值降噪 |
| 智能对比度 | 自适应 S 曲线 |
| 颗粒 / 柔光 / Orton | 胶片质感效果 |
| 水彩色 | 水彩效果变体 |
| 反相 / 位深压缩 / 渐变叠加 | 创意效果 |
| 柔角处理 | 圆角矩形 + 背景填充 |

### 实用工具
| 功能 | 说明 |
|------|------|
| 拼图 | 2-9 张图片拼图，支持边框色/背景色/间距 |
| 证件照 | 自动抠人 + 标准尺寸裁剪（1寸/2寸/护照/美签） |
| 压缩 | 质量/尺寸压缩导出 |
| 水印 | 文字/图片水印，支持位置/透明度/平铺 |
| 形状遮罩 | SVG 精确绘制遮罩，支持 8 方向缩放 |
| 背景替换 | 颜色/图片背景替换 |
| 替换颜色 | 源色 → 目标色替换 |
| 渐变叠加 | 线性/径向/遮罩/对角线 四种叠加方式 |
| 倒影 | 垂直翻转 + 渐变透明 |

---

## 核心算法说明

### 画笔涂抹系统
- **DDA 直线算法**：步进间距 ≤1 像素，彻底消除间隙
- **统一 brushRadius**：`Math.max(1, Math.floor(size/2))`，mask 记录与应用完全一致
- **Uint8Array 掩码**：固定大小替代 Set，防止 maximum size exceeded 错误
- **宽松边界**：边缘可完整涂抹，不提前终止

### 智能消除
- **Telea FMM**：快速行进法，从边界向内部扩散填充
- **Bertalmio NS**：基于 Navier-Stokes 方程的结构保持修复
- **精确区域**：直接使用 maskArr 像素，零额外膨胀

### 智能抠图
- **GrabCut**：K-means GMM 建模 + 概率传播迭代 + 边缘羽化
- **前景确定**：maskArr 像素 = trimap=2，不膨胀

### 老照片修复 (v2.0)
- **六步智能修复流程**
  1. 轻度降噪预处理（3x3中值滤波）
  2. 划痕检测（多方向梯度线检测）+ 方向性中值填充修复
  3. 暗斑污渍检测（7x7局部亮度偏差 + 闭运算）+ 加权平均去除
  4. 边缘保护自适应降噪（拉普拉斯噪声估计，边缘小窗口/平坦大窗口）
  5. 自动色阶（裁切0.3%~0.7%极值）+ 自适应伽马暗部提亮
  6. USM最终锐化
- **五模式选择**
  - 智能综合：全流程修复
  - 深度划痕：仅划痕检测+修复
  - 褪色增强：仅色阶+伽马对比度恢复
  - 降噪清晰：仅降噪处理
  - PatchMatch：大面积缺失纹理合成（inpaintWebRestore）

### 内容填充
- **方式一**：指定颜色直接填充涂抹区域
- **方式二**：PatchMatch + 引导线性插值
  - 计算边界颜色 + 距离比例 t
  - 基础颜色 = `(1-t) × left + t × right`
  - PatchMatch 搜索相似纹理
  - 蚂蚁搬家式逐步填充

### 位图转矢量
- **K-means++**：基于距离概率的智能初始化
- **L2 距离**：欧氏距离聚类更准确
- **自动合并**：相似中心合并去重
- **轮廓追踪**：BFS + RDP 简化 + SVG path 生成

### 渐变叠加（四种模式）
| 模式 | 算法 |
|------|------|
| 线性 | `t = (x/W - start) / (end-start)` + easeInOutQuad |
| 径向 | `t = distance / radius` + 反转支持 |
| 遮罩 | 灰度图读取 + 盒式模糊羽化 |
| 对角线 | `t = (x/W + y/H) / 2` + 幂函数控制 |

---

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl + Z` | 撤销 |
| `Ctrl + Y` | 重做 |
| `Ctrl + +` | 放大 |
| `Ctrl + -` | 缩小 |
| `Ctrl + 0` | 重置缩放 |
| `[` / `]` | 减小/增大笔刷 |
| `Shift + [` / `Shift + ]` | 减小/增大羽化 |
| `1-9` | 快速设置笔刷大小 |

---

## 颜色吸取功能

所有包含颜色选择器的功能都支持颜色吸取：
1. 点击吸取按钮，鼠标变为吸管光标
2. 点击图片任意位置吸取颜色
3. 吸取的颜色**实时显示**在颜色值区域
4. 同时更新对应功能的处理颜色

**支持吸取的功能**：画笔、添加文字、水印、背景替换、替换颜色、边框、证件照、形状遮罩、霓虹灯、颜色抠图、圆角、拼图、照片滤镜、分离色调、智能染发、内容填充 —— 共 18 个

---

## 撤销与重做

- 每次操作后自动保存状态（状态未变化时不重复保存）
- 支持最多 50 步历史记录
- 撤销/重做时显示当前索引（如 `3/12`）
- 恢复时同步更新画布位置和缩放显示

---

## 移动端适配

- 汉堡菜单折叠工具栏
- 触摸滑动切换属性面板
- 双指捏合缩放画布
- 触摸事件与鼠标事件双轨系统
- 480px 以下属性面板优化布局

---

## 技术架构

- **纯前端 JavaScript**，零外部依赖
- **Canvas 2D API** 图像处理
- **Uint8Array / Float32Array** 高性能像素操作
- **支持离线使用**，无需服务器
- **本地文件系统直接读写**，不上传云端

---

## 更新日志

### v13.5 (当前版本)
- **颜色吸取显示修复**：吸取后颜色值实时更新到对应显示区域
  - BrushTool：添加 `id="brcv"`，input 事件同步更新
  - IdphotoTool：添加 `id="idbgv"`，input 事件 + 预设按钮同步更新
- **漫画/卡通效果彻底修复（v3）**
  - 从 Canvas filter API → 纯 JS 盒式模糊（Box Blur），零浏览器依赖
  - 滑动窗口 O(n) 复杂度，任何尺寸图片都不会卡死
  - 水彩效果同步修复为盒式模糊
- **新增 `boxBlur()` 函数**：纯像素操作的水平+垂直分离模糊
- **使用帮助文档全面重写**：更新为 v13.5 完整功能列表和算法说明

### v13.4
- Lomo 效果大面积黑色修复（暗角从 pow→sqrt 曲线）
- 艺术特效亮度补偿（油画/水彩/漫画）
- 渐变叠加四种模式重构（线性/径向/遮罩/对角线）
- 全部 4 个 JS 文件通过 Node.js 语法验证

### v13.3
- 界面调整：删除重复按钮，智能编辑分组重组
- 漫画功能卡死修复（bilateralFilter→Canvas filter）
- 形状遮罩 SVG 精确绘制

### v13.2
- 撤销/重做加强（重复检测、状态指示器）
- 位图转矢量图重写（K-means++ / L2 距离）
- 新增内容填充功能（颜色填充 + PatchMatch 智能填充）

### v13.1
- 涂抹区域精确性：删除所有算法内部 mask 膨胀
- 零膨胀 = 处理区域 100% 等于涂抹区域

### v13.0
- 画笔系统全面重写（统一 radius + DDA 无间隙采样）
- 裁剪比例约束重写（8 方向等比例缩放）
- 5 个美容工具改为画笔涂抹局部处理
- 18 个颜色吸取功能全覆盖