Package: cairo

Function cairo:pattern-create-radial

Lambda List

cairo:pattern-create-radial (x0 y0 r0 x1 y1 r1)

Arguments

x0 -- a number for the x coordinate for the center of the start circle
y0 -- a number for the y coordinate for the center of the start circle
r0 -- a number for the radius of the start circle
x1 -- a number for the x coordinate for the center of the end circle
y1 -- a number for the y coordinate for the center of the end circle
r1 -- a number for the 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.

Details

Creates a new radial gradient cairo:pattern-t instance between the two circles defined by x0,y0,r0) and (x1,y1,r1). This function will always return a valid pattern, 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.

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.

Notes

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-matrix function.

Lisp implementation

The arguments are coerced to double floats before being passed to the foreign C function.
 

See also

2025-1-19