cairo-pattern-create-linear (x0 y0 x1 y1)

x0 -- a double float x coordinate of the start point
y0 -- a double float y coordinate of the start point
x1 -- a double float x coordinate of the end point
y1 -- a double float y coordinate of the end point

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

Create a new linear gradient cairo-pattern-t instance along the line defined by (x0, y0) and (x1, y1). 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. 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.