copy(dashingWithPhase:lengths:transform:)

Returns a new path equivalent to the results of drawing the path with a dashed stroke.

Declaration

func copy(dashingWithPhase phase: CGFloat, lengths: [CGFloat], transform: CGAffineTransform = .identity) -> CGPath

phase:
A value that specifies how far into the dash pattern the line starts, in units of the user space. For example, a value of 0 draws a line starting with the beginning of a dash pattern, and a value of 3 means the line is drawn with the dash pattern starting at three units from its beginning.
lengths:
An array of values that specify the lengths, in user space coordinates, of the painted and unpainted segments of the dash pattern.
For example, the array [2,3] sets a dash pattern that alternates between a 2-unit-long painted segment and a 3-unit-long unpainted segment. The array [1,3,4,2] sets the pattern to a 1-unit painted segment, a 3-unit unpainted segment, a 4-unit painted segment, and a 2-unit unpainted segment.Pass an empty array to clear the dash pattern so that all stroke drawing in the context uses solid lines.
transform:
An affine transform to apply to the path before dashing. Defaults to the Cgaffinetransformidentity transform if not specified.

A new path.

The new path is created so that filling the new path draws the same pixels as stroking the original path with the specified dash parameters.