cairo:script-surface-create-for-target (script target)

script -- a cairo:device-t instance
target -- a cairo:surface-t instance

The newly created cairo:surface-t instance.

Creates a proxy surface that will render to target and record the operations to script. The caller owns the surface and should call the cairo:surface-destroy function when done with it. This function always returns a valid pointer, but it will return a pointer to a "nil" surface if an error such as out of memory occurs. You can use the cairo:surface-status function to check for this.