341 ImageCropper 图片裁剪
用途
在图片上拖出裁剪框，可锁定宽高比、按 90 度旋转，输出裁剪矩形。
最小示例
crop := media.ImageCrop{} // empty: starts fitted to the image
view := func(c *ui.Context) {
core.Use(c, core.Settings{})
if media.ImageCropper(c, examplePhoto, &crop, media.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 以内才算抓住手柄。