Retrieves the line-stroking pattern for the path.
- iOS 3.2+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
On input, a C-style array of floating point values, or
nilif you do not want the pattern values. On output, this array contains the lengths (measured in points) of the line segments and gaps in the pattern. The values in the array alternate, starting with the first line segment length, followed by the first gap length, followed by the second line segment length, and so on.
On input, a pointer to an integer or
nilif you do not want the number of pattern entries. On output, the number of entries written to
On input, a pointer to a floating point value or
nilif you do not want the phase. On output, this value contains the offset at which to start drawing the pattern, measured in points along the dashed-line pattern. For example, a phase of 6 in the pattern 5-2-3-2 would cause drawing to begin in the middle of the first gap.
The array in the
pattern parameter must be large enough to hold all of the returned values in the pattern. If you are not sure how many values there might be, you can call this method twice. The first time you call it, do not pass a value for
pattern but use the returned value in the
count parameter to allocate an array of floating-point numbers that you can then pass in the second time.