# copy(dashingWithPhase:lengths:transform:) Returns a new path equivalent to the results of drawing the path with a dashed stroke. ``` func copy(dashingWithPhase phase: CGFloat, lengths: [CGFloat], transform: CGAffineTransform = .identity) -> CGPath ``` ## Parameters `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`](/documentation/CoreGraphics/CGAffineTransformIdentity) transform if not specified. ## Return Value A new path. ## Discussion 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. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)