---
title: crop
description: "crop函数用于从图像中裁剪出指定区域。用户可以通过指定裁剪区域的左上角坐标和裁剪区域的宽度和高度来精确控制裁剪的范围。该函数不涉及图像的缩放，仅用于提取图像的特定部分。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_kpcv_06_0045.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_kpcv_06_0045.html
indexId: a54bb7df3780cd3fd2acf29ac3e8fafdae03741f7239a6ef4eb5e9ed5043839b77
---
# crop

#### 函数功能

crop函数用于从图像中裁剪出指定区域。用户可以通过指定裁剪区域的左上角坐标和裁剪区域的宽度和高度来精确控制裁剪的范围。该函数不涉及图像的缩放，仅用于提取图像的特定部分。


#### 函数接口

```
torchvision.transforms.crop(img, top, left, height, width)
```


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| img | 输入图像。 | torch.Tensor | 输入 |
| top | 裁剪区域的上边界坐标。 | [0, 图像高度) | 输入 |
| left | 裁剪区域的左边界坐标。 | [0, 图像宽度) | 输入 |
| height | 裁剪区域的高度。 | (0, 图像高度 \- top] | 输入 |
| width | 裁剪区域的宽度。 | (0, 图像宽度 \- left] | 输入 |


#### 返回值

- 裁剪后图像。


#### 示例

```
from torchvision import transforms
from PIL import Image

# 打开图像
img = Image.open('example.jpg')

# 定义裁剪参数
top = 50
left = 50
height = 100
width = 100

# 裁剪图像
cropped_img = transforms.functional.crop(img, top, left, height, width)

# 保存裁剪后的图像
cropped_img.save('cropped_example.jpg')
```