📐 裁剪动作 - 功能介绍与使用说明

✨ 功能概述

这是一个批量图片裁剪工具，支持按照用户指定的上、下、左、右四个方向的裁剪比例，对选中的多张图片进行统一裁剪。

核心能力：

• 📂 支持批量处理多张图片

• 📊 使用比例值（0~1之间的小数）定义裁剪区域，直观易用

• 🔄 自动计算裁剪坐标，无需手动测量像素

• 💾 裁剪后自动保存，保留原始文件名并添加比例标识

🎯 适用场景

• 批量去除图片四周的白边或水印

• 统一多张图片的构图比例（如统一裁掉上下各10%、左右各5%）

• 为排版需求批量裁剪图片边缘

📖 使用步骤

1️⃣ 选中图片

在文件资源管理器中，选中需要裁剪的一张或多张图片，然后运行动作。

支持格式：JPG、PNG、BMP 等常见图片格式

2️⃣ 输入裁剪比例

动作会弹出一个多行输入框，按顺序输入四个方向的裁剪比例：

💡 提示：四个值相加必须 ≤ 1（左右相加≤1，上下相加≤1），否则裁剪区域会重叠或超出图片边界。

默认值已预填为四行 0.，方便您直接修改数字。

3️⃣ 自动处理

动作会自动：

1. 读取每张图片的原始宽高

2. 根据您输入的比例，计算实际裁剪的像素坐标

3. 执行裁剪并保存到原文件夹

4️⃣ 输出文件

裁剪后的图片保存在原文件夹中，文件名格式为：

{上比例}_{下比例}_{左比例}_{右比例}{原文件名}

示例：原图 photo.jpg，输入上0.1、下0.05、左0.08、右0.12
→ 输出文件：0.1_0.05_0.08_0.12photo.jpg

🧮 裁剪逻辑说明

动作内部使用 Ceiling（向上取整） 计算像素值，确保裁剪区域完整覆盖目标比例：

例如：图片 4608×2064，输入左0.3、右0.3、上0.1、下0.1
→ 裁剪区域：X从1382开始，宽度1843；Y从206开始，高度1651

⚠️ 注意事项

1. 比例值必须在 0~1 之间，否则会导致计算异常。

2. 左右比例之和 < 1，上下比例之和 < 1，否则裁剪区域无效。

3. 如果输入为空或格式不正确，动作会报错并停止。

4. 裁剪后的图片会覆盖同名文件吗？—— 不会，因为文件名添加了比例前缀，与原文件区分。

🐛 常见问题

Q：提示 The input string 'xxx' was not in a correct format

原因：某个比例值不是有效的数字（如包含空格、字母、中文括号等）。
解决：确保四行输入都是纯数字（如 0.1、0.05），不要带单位或文字。

Q：裁剪后的图片尺寸不对？

原因：可能输入的比例相加超过了1，导致裁剪区域重叠。
解决：检查四个值，确保 左+右 < 1 且 上+下 < 1。

Q：能否只裁剪一个方向？

可以。不需要裁剪的方向填 0 即可。例如只裁左右各10%：

0
0
0.1
0.1