Surface.createSimilarImage

Create a new image surface that is as compatible as possible for uploading to and the use in conjunction with an existing surface. However, this surface can still be used like any normal image surface. Initially the surface contents are all 0 (transparent if contents have transparency, black otherwise.) Use Surface.createSimilar if you don't need an image surface. Since 1.12

class Surface

Surface

createSimilarImage

(

cairo_format_t format

int width

int height

)

Parameters

format cairo_format_t: the format for the new surface
width int: width of the new surface, (in device-space units)
height int: height of the new surface (in device-space units)

Return Value

Type: Surface

a pointer to the newly allocated image surface. The caller owns the surface and should call Surface.destroy when done with it. This function always returns a valid pointer, but it will return a pointer to a "nil" surface if other is already in an error state or any other error occurs.