56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# 341 ImageCropper 图片裁剪
|
|
|
|
## 用途
|
|
|
|
在图片上拖出裁剪框，可锁定宽高比、按 90 度旋转，输出裁剪矩形。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
crop := mujica.ImageCrop{} // empty: starts fitted to the image
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
if mujica.ImageCropper(c, examplePhoto, &crop, mujica.ImageCropperOptions{Aspect: 1}).Changed() {
|
|
_ = crop.Rect // in pixels of the photo turned by crop.Rotation
|
|
}
|
|
}
|
|
ui.Render(view, 400, 300, 1)
|
|
```
|
|
|
|
## 参数
|
|
|
|
`func ImageCropper(c *ui.Context, src image.Image, crop *ImageCrop, opts ImageCropperOptions) ChoiceResult`
|
|
|
|
`src` 必填，是标准库 `image.Image`（组件要自己转动像素）。`ImageCrop.Rect` 是旋转 `Rotation` 度之后那张图上的像素矩形；`Rotation` 只能是 0、90、180、270。`Rect` 为空时自动设为最大的居中框。
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `Aspect` | `float64` | 0 | 锁定宽除以高；0 为自由比例。`Rect` 不符合比例时 panic。 |
|
|
| `Height` | `float32` | 0（即 320） | 舞台高度。 |
|
|
| `Disabled` | `bool` | false | 禁用拖动、按键与旋转。 |
|
|
| `Label` | `string` | "Crop area" | 舞台的无障碍名称。 |
|
|
|
|
## 状态
|
|
|
|
- 默认：框外区域压暗，框线与三分线为象牙色，四角有菱形手柄。
|
|
- 聚焦：舞台显示 2 DIP 焦点环；下方读数同时作为无障碍描述。
|
|
- 禁用：MyGo 统一调暗，不响应输入。
|
|
|
|
## 事件
|
|
|
|
`Changed()` 在框移动、缩放或旋转后为 true。
|
|
|
|
## 键盘操作
|
|
|
|
| 按键 | 作用 |
|
|
| --- | --- |
|
|
| 方向键 | 移动裁剪框，每次图片宽度的 1% |
|
|
| Shift+方向键 | 右、下放大，左、上缩小；锁定比例时保持比例 |
|
|
| R / Shift+R | 向右 / 向左旋转 90 度 |
|
|
|
|
## 限制
|
|
|
|
- MyGo 的 Painter 不能旋转位图（只有单色图标能转，ui/svg.go:98），所以组件在图片或角度变化时复制一份转好的像素；超大图片会在那一帧花时间。
|
|
- 锁定比例时旋转会重新取最大的居中框，原选区不保留。
|
|
- 拖动角点时，按下点距角 14 DIP 以内才算抓住手柄。
|