Function

CGContextSetLineDash

Sets the pattern for dashed lines in a graphics context.

Declaration

void CGContextSetLineDash(CGContextRef c, CGFloat phase, const CGFloat *lengths, size_t count);

Parameters

c

The graphics context to modify.

phase

A value that specifies how far into the dash pattern the line starts, in units of the user space. For example, passing a value of 3 means the line is drawn with the dash pattern starting at three units from its beginning. Passing a value of 0 draws a line starting with the beginning of a dash pattern.

lengths

An array of values that specify the lengths of the painted segments and unpainted segments, respectively, of the dash pattern—or NULL for no dash pattern.

For example, passing an array with the values [2,3] sets a dash pattern that alternates between a 2-user-space-unit-long painted segment and a 3-user-space-unit-long unpainted segment. Passing the values [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.

count

If the lengths parameter specifies an array, pass the number of elements in the array. Otherwise, pass 0.

See Also

Getting and Setting Graphics State Parameters

CGContextGetInterpolationQuality

Returns the current level of interpolation quality for a graphics context.

CGContextSetFlatness

Sets the accuracy of curved paths in a graphics context.

CGContextSetInterpolationQuality

Sets the level of interpolation quality for a graphics context.

CGContextSetLineCap

Sets the style for the endpoints of lines drawn in a graphics context.

CGContextSetLineJoin

Sets the style for the joins of connected lines in a graphics context.

CGContextSetLineWidth

Sets the line width for a graphics context.

CGContextSetMiterLimit

Sets the miter limit for the joins of connected lines in a graphics context.

CGContextSetPatternPhase

Sets the pattern phase of a context.

CGContextSetFillPattern

Sets the fill pattern in the specified graphics context.

CGContextSetRenderingIntent

Sets the rendering intent in the current graphics state.

CGContextSetShouldAntialias

Sets antialiasing on or off for a graphics context.

CGContextSetStrokePattern

Sets the stroke pattern in the specified graphics context.

CGContextSetBlendMode

Sets how sample values are composited by a graphics context.

CGContextSetAllowsAntialiasing

Sets whether or not to allow antialiasing for a graphics context.

CGContextSetAllowsFontSmoothing

Sets whether or not to allow font smoothing for a graphics context.

CGContextSetShouldSmoothFonts

Enables or disables font smoothing in a graphics context.

CGContextSetAllowsFontSubpixelPositioning

Sets whether or not to allow subpixel positioning for a graphics context.

CGContextSetShouldSubpixelPositionFonts

Enables or disables subpixel positioning in a graphics context.

CGContextSetAllowsFontSubpixelQuantization

Sets whether or not to allow subpixel quantization for a graphics context.

CGContextSetShouldSubpixelQuantizeFonts

Enables or disables subpixel quantization in a graphics context.