Name
cairo.PatternLinear -- create linear pattern
Synopsis
pat = cairo.PatternLinear(x0, y0, x1, y1)
Function
Create a new linear gradient Cairo pattern along the line defined by (x0, y0) and (x1, y1). Before using the gradient pattern, a number of color stops should be defined using cpattern:AddColorStopRGB() or cpattern: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 cpattern:SetMatrix().

This function returns the newly created Cairo pattern if successful, or an error pattern in case of no memory. The caller owns the returned object and should call cpattern:Free() when finished with it.

This function will always return a valid handle, but if an error occurred the pattern status will be set to an error. To inspect the status of a pattern use cpattern:Status().

Inputs
x0
x coordinate of the start point
y0
y coordinate of the start point
x1
x coordinate of the end point
y1
y coordinate of the end point
Results
pat
the newly created Cairo pattern

Show TOC