patternCreateRadial

fncairo.pattern.Pattern patternCreateRadial(double cx0, double cy0, double radius0, double cx1, double cy1, double radius1)

Creates a new radial gradient #cairo_pattern_t between the two circles defined by (cx0, cy0, radius0) and (cx1, cy1, radius1). Before using the gradient pattern, a number of color stops should be defined using [cairo.pattern.Pattern.addColorStopRgb] or [cairo.pattern.Pattern.addColorStopRgba].

Note

The coordinates here are in pattern space. For a new pattern,

pattern space is identical to user space, but the relationship between the spaces can be changed with [cairo.pattern.Pattern.setMatrix].

Parameters

cx0x coordinate for the center of the start circle
cy0y coordinate for the center of the start circle
radius0radius of the start circle
cx1x coordinate for the center of the end circle
cy1y coordinate for the center of the end circle
radius1radius of the end circle

Returns

the newly created #cairo_pattern_t if successful, or

an error pattern in case of no memory. The caller owns the returned object and should call [cairo.pattern.Pattern.destroy] when finished with it.

This function will always return a valid pointer, but if an error occurred the pattern status will be set to an error. To inspect the status of a pattern use [cairo.pattern.Pattern.status].