Contents

draw(in:angle:)

Fills the specified rectangle with a linear gradient.

Declaration

func draw(in rect: NSRect, angle: CGFloat)

Parameters

  • rect:

    The rectangle to fill.

  • angle:

    The angle of the linear gradient, specified in degrees. Positive values indicate rotation in the counter-clockwise direction relative to the horizontal axis.

Discussion

This convenience method draws a linear gradient inside the specified rectangle. The gradient is drawn so that the start and end colors are guaranteed to be visible in opposite corners of the rectangle. The angle of rotation determines which corner contains the start color; see the table below.

Rotation angle

Start corner

0-89 degrees

Lower-left

90-179 degrees

Lower-right

180-269 degrees

Upper-right

270-359 degrees

Upper-left

The gradient’s color transitions occur along the line formed by the angle of rotation. For example, a rotation of 0 degrees results in colors changing from left-to-right across the rectangle, while a rotation of 90 degrees results in colors changing from bottom to top.

The gradient drawn by this method is clipped to rect.

See Also

Drawing a Linear Gradient