cairo:pattern-create-for-surface (surface)

surface -- a cairo:surface-t instance

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.

Create a new cairo:pattern-t instance for the given surface. 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.