MujicaUI/docs/components/341-image-cropper.md

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 以内才算抓住手柄。