# init(colorsSpace:colors:locations:) Creates a gradient object from a color space and the provided color objects and locations. ``` init?(colorsSpace space: CGColorSpace?, colors: CFArray, locations: UnsafePointer?) ``` ## Parameters `space` The color space to use for the gradient. You cannot use a pattern or indexed color space. `colors` A non-empty array of [`CGColor`](/documentation/CoreGraphics/CGColor) objects that should be in the color space specified by `space`. If `space` is not `NULL`, each color will be converted (if necessary) to that color space and the gradient will drawn in that color space. Otherwise, each color will be converted to and drawn in the GenericRGB color space. `locations` The location for each color provided in `colors`; each location must be a value in the range of `0` to `1`, inclusive. If `0` and `1` are not in the `locations` array, Quartz uses the colors provided that are closest to `0` and `1` for those locations. If `locations` is `NULL` , the first color in `colors` is assigned to location `0` , the last color in `colors` is assigned to location `1` , and intervening colors are assigned locations that are at equal intervals in between. The `locations` array should contain the same number of items as the `colors` array. ## Return Value A [`CGGradient`](/documentation/CoreGraphics/CGGradient) object. ## See Also [`drawRadialGradient(_:startCenter:startRadius:endCenter:endRadius:options:)`](/documentation/CoreGraphics/CGContext/drawRadialGradient(_:startCenter:startRadius:endCenter:endRadius:options:)) Paints a gradient fill that varies along the area defined by the provided starting and ending circles. [`drawLinearGradient(_:start:end:options:)`](/documentation/CoreGraphics/CGContext/drawLinearGradient(_:start:end:options:)) Paints a gradient fill that varies along the line defined by the provided starting and ending points. --- 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)