Instance Method

# convert(_:to:)

Converts the rectangle from the receiver’s coordinate system to the specified layer’s coordinate system.

## Parameters

`r`

A point specifying a location in the coordinate system of `l`.

`l`

The layer into whose coordinate system `r` is to be converted. The receiver and `l` and must share a common parent layer. This parameter may be `nil`.

## Return Value

The rectangle converted to the coordinate system of `l`.

## Discussion

If you specify `nil` for the `l` parameter, this method returns the original rect with an origin added to the layer's frame's origin.

Listing 1 shows code that creates two layers, `redLayer` and `yellowLayer`. `yellowLayer` is scaled so that it is half of its original size.

Figure 1 shows the two layers and an overlaid rectangle with a frame of `(50, 50, 200, 200)` in the red layer's coordinate system.

Listing 2 show how you can find the coordinates of that rectangle in the yellow layer's coordinate system.

### Mapping Between Coordinate and Time Spaces

`func convert(CGPoint, from: CALayer?) -> CGPoint`

Converts the point from the specified layer’s coordinate system to the receiver’s coordinate system.

`func convert(CGPoint, to: CALayer?) -> CGPoint`

Converts the point from the receiver’s coordinate system to the specified layer’s coordinate system.

`func convert(CGRect, from: CALayer?) -> CGRect`

Converts the rectangle from the specified layer’s coordinate system to the receiver’s coordinate system.

`func convertTime(CFTimeInterval, from: CALayer?) -> CFTimeInterval`

Converts the time interval from the specified layer’s time space to the receiver’s time space.

`func convertTime(CFTimeInterval, to: CALayer?) -> CFTimeInterval`

Converts the time interval from the receiver’s time space to the specified layer’s time space

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.