Package: cairo

Function cairo-pattern-create-radial

Lambda List

cairo-pattern-create-radial (x0 y0 radius0 x1 y1 radius1)

Arguments

x0 -- a double float x coordinate for the center of the start circle
y0 -- a double float y coordinate for the center of the start circle
radius0 -- a double float with the radius of the start circle
x1 -- a double float x coordinate for the center of the end circle
y1 -- a double float y coordinate for the center of the end circle
radius1 -- a double float radius of the end circle

Return Value

The newly created cairo-pattern-t instance if successful, or an error pattern in case of no memory. The caller owns the returned object and should call the cairo-pattern-destroy function 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 the cairo-pattern-status function.

Details

Creates a new radial gradient cairo-pattern-t instance between the two circles defined by (x0, y0, radius0) and (x1, y1, radius1). Before using the gradient pattern, a number of color stops should be defined using the cairo-pattern-add-color-stop-rgb or cairo-pattern-add-color-stop-rgba functions.

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 the cairo-pattern-set-matrix function.
 

See also

*2021-12-17