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 function cairo-pattern-destroy 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 function cairo-pattern-status.

Create a new cairo-pattern-t instance for the given surface.