🖼️ 图片处理
PixWit 内置的图片查看器用来浏览本地图片，并能在同一个窗口里完成裁剪、旋转、透视矫正、调整尺寸、标注、格式转换与打印，不需要再打开外部编辑器。
注意：旋转图片、格式转换、打印等操作都在图片查看器里；截图编辑窗口没有这些操作（截图编辑窗口只负责标注、保存、复制与贴图）。
打开图片
| 入口 | 操作 |
|---|---|
| 主界面 | 点主界面的 打开图片 按钮（提示为「打开图片/视频」） |
| 拖拽 | 把图片 / 视频文件拖到主界面上 |
| 历史截图 | 在「历史截图浏览」窗口里双击卡片，或点卡片上的「预览」 |
| 命令行 / 文件关联 | 从命令行或文件关联打开；程序已在运行时会在现有窗口里打开 |
支持格式：PNG、JPEG、BMP、GIF、WebP、SVG、ICO。
- GIF / APNG / WebP 动画会自动播放。
- 打开后窗口最大化，图片按 100% 显示。
📷 插图占位（图 1）
图片查看器主界面与工具栏 — 展示最大化窗口、顶部工具栏（裁剪 / 旋转图片 / 透视矫正 / 调整图片 / 标注工具 / 序号标注 / 撤销 / OCR识别 / 打印 / 保存）以及画布左上角的常驻缩放操作提示 补图：图片放到 docs/public/images/image-viewer.webp，然后删除本提示块并打开下一行注释
查看操作
| 操作 | 效果 |
|---|---|
| 滚轮 | 以鼠标位置为中心缩放（每格 1.1 / 0.9，范围 10% ~ 1000%）；接近 100% 时磁吸并提示 ✓ 100% |
| Ctrl + 滚轮 | 任何模式下都强制缩放图片 |
| Space + 滚轮 | 缩放 |
| 中键单击 | 跳到 100% 原始尺寸（提示 ✓ 100% 原始尺寸） |
| Space + 左键拖动 | 平移画布（任何模式可用） |
| 左键拖动（查看模式） | 平移画布 |
| 双击 | 在适应窗口与 100% 原始尺寸之间切换 |
| 0 / 1 | 适应窗口 / 原始尺寸 |
| F | 切换全屏 |
| + / = / - | 放大 / 缩小 |
| ← / → | 上一张 / 下一张（查看、标注模式；Ctrl+←/→ 任何模式都可用） |
| PageUp / PageDown | 上一张 / 下一张（任何模式） |
| Delete / Backspace | 删除选中的标注对象（不会删图片） |
| Ctrl+Z | 撤销（最多 20 步） |
| Ctrl+S / Ctrl+P | 保存 / 打印 |
| Esc | 逐级退出：退出标注模式 → 取消裁剪 → 取消矫正 → 关闭窗口 |
界面细节
画布左上角常驻一行操作提示，原文为：
缩放: N% | 滚轮/Ctrl+滚轮:缩放 | 左键拖拽/Space:平移 | 双击:适应/原始 | ESC:退出工具栏是「动则现、停则藏」：移动鼠标、滚轮、点击或按键会唤出，静止 3 秒后自动隐藏。
切换图片时若当前有未保存的编辑，会先确认：保存并切换 / 不保存 / 取消 / 不再提示（选「不再提示」后直接切换，不再询问）。
工具栏按钮
工具栏从左到右（纯图标按钮，鼠标悬停可看到名称）：
| 按钮 | 说明 |
|---|---|
| 裁剪 | 进入裁剪模式 |
| 旋转图片 | 直接逆时针旋转 90° |
| 透视矫正 | 四点矫正 |
| 调整图片尺寸和质量 | 打开「调整图片」侧栏 |
| 画笔 / 直线 / 箭头 / 圆形 / 矩形 / 马赛克 / 输入文字 | 标注工具 |
| 序号标注 | 提示为 序号标注 [下一个: N] (再次点击重置)；再次点击会把序号重置为 1 并提示 序号已重置为 1 |
| 撤销 | 等同于 Ctrl+Z |
| OCR识别 | 对当前图片做文字识别 |
| 打印 / 保存 | 等同于 Ctrl+P / Ctrl+S |
裁剪
点「裁剪」进入裁剪模式，窗口顶部会出现一条裁剪工具栏。裁剪框可拖动移动、拖控制点缩放，框旁显示形如 800 x 600 的尺寸数字，最小 10px，且不会超出图片范围；没画框就点「应用裁剪」会提示「请先绘制裁剪区域」。
| 控件 | 选项 / 说明 |
|---|---|
| 形状 | 矩形 / 椭圆切换；椭圆裁剪的结果是透明背景 |
| 动作 | 「应用裁剪」「取消」 |
| 比例 | 下拉：不限比例、1:1 (正方形/头像)，以及证件照分组（1寸照、2寸照、小1寸、身份证照、护照照） |
| 固定尺寸 | 下拉：不限尺寸、1寸照 295×413、2寸照 413×626、小1寸 260×378、身份证照 358×441、护照照 390×567 |
| 旋转 | 逆时针旋转90° / 顺时针旋转90° |
- 固定尺寸与限定比例互斥；固定尺寸模式下裁剪框只能整体移动。
📷 插图占位（图 2）
裁剪工具栏（证件照比例） — 展示矩形/椭圆切换、比例与固定尺寸下拉里的证件照分组、旋转按钮，以及裁剪框旁的尺寸数字 补图：图片放到 docs/public/images/image-crop-toolbar.webp，然后删除本提示块并打开下一行注释
透视矫正
点工具栏「透视矫正」后，按提示依次点击图片的四个角点（任意顺序，程序会自动识别位置），侧栏显示 进度: N/4。
- 点满四点后，可以拖动圆点微调角点位置。
- 点「应用矫正」完成，成功提示「图片矫正完成」。
- 点「取消」退出矫正模式。
选不满 4 个点就点「应用矫正」会提示「需要选择4个角点」。
📷 插图占位（图 3）
透视矫正四点 — 展示侧栏 进度: N/4、图片四角的可拖动圆点与「应用矫正 / 取消」按钮 补图：图片放到 docs/public/images/image-perspective-correct.webp，然后删除本提示块并打开下一行注释
调整图片
点工具栏「调整图片尺寸和质量」打开「调整图片」侧栏，用于改尺寸与压缩：
| 设置项 | 说明 |
|---|---|
| 保持宽高比 | 默认勾选 |
| 宽度 / 高度 | 1 ~ 10000 px |
| 缩放 | 0.01 ~ 10 倍 |
| 质量压缩 JPEG | 1 ~ 100，默认 85（越低文件越小） |
侧栏下方会实时预览 新尺寸: 宽 × 高 / 预估大小。底部三个按钮：
| 按钮 | 作用 |
|---|---|
| 💾 压缩保存 | 按当前设置压缩并保存为 JPEG |
| 应用 | 只改当前图片，不写盘 |
| 取消 | 放弃本次调整 |
📷 插图占位（图 4）
调整图片侧栏 — 展示保持宽高比、宽/高、缩放、质量压缩 JPEG 四项设置，新尺寸: 宽 × 高 / 预估大小 预览与三个按钮 补图：图片放到 docs/public/images/image-resize-panel.webp，然后删除本提示块并打开下一行注释
标注
标注工具与截图编辑窗口一致：画笔、直线、箭头、圆形、矩形、马赛克、文字、序号。
- 矩形 / 圆形在这里是固定描边（没有填充入口）。
- 矩形的圆角取 设置中心 → 标注设置 → 默认圆角半径。
- 松开鼠标即生成可选中对象，之后随时可以用滚轮调整它的粗细——没有「绘制后 3 秒内」的时间限制。
样式弹窗
| 控件 | 说明 |
|---|---|
| 颜色 | 8 个预设色 + 自定义颜色... |
| 粗细 | 滚轮调整 |
| 透明度 | Shift + 滚轮，范围 10 ~ 100，步进 5 |
| 箭头样式 | 经典箭头 / 锥形箭头 |
| 马赛克形状 | 画笔形状 / 矩形形状 / 启用文本抹除 |
| 序号样式 | 空心圆 / 无圆 / 实心圆（与截图编辑窗口一致） |
调整时会即时提示 粗细: N px、大小: N（序号）、透明度: N%，1 秒后自动消失。
保存、格式转换与打印
保存与格式转换
- 保存对话框标题为
保存图片 (支持格式转换)。 - 可选格式：PNG / JPEG / BMP / GIF / WebP / PDF / ICO。
- ⚠️ 不支持导出 SVG。
- JPEG / WebP 使用「保存设置」里的图片质量（默认 90）。
- 保存时改变了格式，会提示
图片已保存！格式转换: 原格式 → 新格式（例如图片已保存！格式转换: PNG → JPEG）。 - 默认文件名按 保存设置 里的格式、前缀、分隔符与日期格式生成。
打印
Ctrl+P 或工具栏打印按钮：程序会按图片比例自动选择横向 / 纵向，成功后提示「打印任务已发送到打印机」。
OCR 识别
点工具栏「OCR识别」，识别过程中按钮变为「识别中...」。
结果窗口是否弹出取决于 设置中心 → AI 服务配置 → OCR 设置：
- 勾选了「不显示窗口，自动复制到剪贴板」：识别结果静默复制到剪贴板，并用托盘气泡提示
OCR 识别完成，不弹结果窗口；不想要这个右下角通知，可再勾选「不显示「OCR 识别完成」托盘提示」。 - 未勾选：弹出 OCR 结果窗口。