cairo:mesh-pattern-begin-patch (pattern)

pattern -- a cairo:pattern-t instance

Begin a patch in a mesh pattern. After calling this function, the patch shape should be defined with the cairo:mesh-pattern-move-to, cairo:mesh-pattern-line-to and cairo:mesh-pattern-curve-to functions.

After defining the patch, the cairo:mesh-pattern-end-patch function must be called before using the pattern as a source or mask. If the pattern argument is not a mesh pattern then pattern will be put into an error status with a :pattern-type-mismatch value. If pattern already has a current patch, it will be put into an error status with a :invalid-mesh-contstruction value.