---
title: "cropped(to:)"
framework: accelerate
role: symbol
role_heading: Instance Method
path: "accelerate/vimage/pixelbuffer/cropped(to:)"
---

# cropped(to:)

Returns a new pixel buffer that contains a copy of the data specified as a subregion of an existing pixel buffer.

## Declaration

```swift
func cropped(to rect: CGRect) -> vImage.PixelBuffer<Format>
```

## Parameters

- `rect`: A rectangle that specifies the portion of the image to keep.

## Return Value

Return Value A pixel buffer that contains of a copy of the specified subregion.

## Discussion

Discussion For example, the following code populates a pixel buffer from the center 3 x 3 pixels of a 5 x 5 planar buffer: let src = vImage.PixelBuffer<vImage.Planar8> (     pixelValues: [ 10, 11, 12, 13, 14,                    20, 21, 22, 23, 24,                    30, 31, 32, 33, 34,                    40, 41, 42, 43, 44,                    50, 51, 52, 53, 54 ],     size: vImage.Size(width: 5,                       height: 5))

let roi = CGRect(x: 1, y: 1,                  width: 3, height: 3)

let dest = src.cropped(to: roi)

// Prints: //  [ 21, 22, 23, //    31, 32, 33, //    41, 42, 43 ] print(dest.array)

## See Also

### Cropping

- [crop(at:destination:)](accelerate/vimage/pixelbuffer/crop(at:destination:).md)