---
title: "init(roundedRect:cornerWidth:cornerHeight:transform:)"
framework: coregraphics
role: symbol
role_heading: Initializer
path: "coregraphics/cgpath/init(roundedrect:cornerwidth:cornerheight:transform:)"
---

# init(roundedRect:cornerWidth:cornerHeight:transform:)

Create an immutable path of a rounded rectangle.

## Declaration

```swift
init(roundedRect rect: CGRect, cornerWidth: CGFloat, cornerHeight: CGFloat, transform: UnsafePointer<CGAffineTransform>?)
```

## Parameters

- `rect`: The rectangle to add.
- `cornerWidth`: The width of the rounded corner sections.
- `cornerHeight`: The height of the rounded corner sections.
- `transform`: A pointer to an affine transformation matrix, or NULL if no transformation is needed. If specified, Core Graphics applies the transformation to the rectangle before it is added to the path.

## Return Value

Return Value A new, immutable path. You are responsible for releasing this object.

## Discussion

Discussion This is a convenience function that creates a path of an rounded rectangle. Using this convenience function is more efficient than creating a mutable path and adding an rectangle to it. Each corner of the rounded rectangle is one-quarter of an ellipse with axes equal to the cornerWidth and cornerHeight parameters. The rounded rectangle forms a complete subpath and is oriented in the clockwise direction.

## See Also

### Creating Graphics Paths

- [init(rect:transform:)](coregraphics/cgpath/init(rect:transform:).md)
- [init(ellipseIn:transform:)](coregraphics/cgpath/init(ellipsein:transform:).md)