# 自定义裁剪

> 使用 rect 参数按坐标从原图中提取任意矩形区域。

以下示例的原图均为：<https://demo.bitiful.com/girl.jpeg>

## 参数说明

| 参数     | 含义       | 格式                   |
| :----- | -------- | -------------------- |
| `rect` | **裁剪区域** | `x,y,w,h`，四个值用半角逗号分隔 |

| 分量      | 含义       | 取值                         |
| :------ | -------- | -------------------------- |
| `x`、`y` | 区域左上角的坐标 | 像素或百分比；**负数**表示从右边缘、下边缘往回量 |
| `w`、`h` | 区域的宽、高   | 像素或百分比，必须大于 0              |

- 百分比以原图宽高为基准，URL 中 `%` 需写作 `%25`，如 `rect=10%25,10%25,80%25,80%25`。
- 负数坐标让你无需知道原图尺寸就能取到右侧或底部的区域：`rect=-900,-900,900,900` 即右下角 900 × 900。
- 区域超出图片边界的部分会被截掉，输出相应变小。
- `rect` 先于 `w`、`h` 执行：先裁剪，再缩放。
- HDR 图片裁剪后仍是 HDR。

> **Note**
>
> `rect` 用于按坐标精确裁剪。如需按目标宽高自动裁切并保留人脸或主体，请使用 [图片缩放](/coreix/features/resize) 中的 `pos=smart`。

## 使用示例

<details>
<summary>演示：从左上角截取 500 宽、500 高的区域</summary>

![裁剪逻辑示意](https://demo.bitiful.com/static/docs/rect-demo-1.png?w=200\&fmt=webp\&q=90)

URL：[https://demo.bitiful.com/girl.jpeg? **`rect=0,0,500,500`**](https://demo.bitiful.com/girl.jpeg?rect=0,0,500,500)

![裁剪结果](https://demo.bitiful.com/girl.jpeg?rect=0,0,500,500)

</details>

<details>
<summary>演示：从左上角截取 1000 × 1000 的区域，再缩放到 500 宽</summary>

`rect` 的优先级高于 `w` 和 `h`，处理分两步：

1. 按 `rect=0,0,1000,1000` 截取原图左上角 1000 × 1000 的区域；
2. 按 `w=500` 把截取结果等比缩放到 500 宽。

URL：[https://demo.bitiful.com/girl.jpeg? **`rect=0,0,1000,1000 & w=500`**](https://demo.bitiful.com/girl.jpeg?rect=0,0,1000,1000\&w=500)

![裁剪后缩放](https://demo.bitiful.com/girl.jpeg?rect=0,0,1000,1000\&w=500)

</details>
