RGtk2 (version 2.8.8)

cairoImageSurfaceCreate: cairoImageSurfaceCreate

Description

Creates an image surface of the specified format and dimensions. The initial contents of the surface is undefined; you must explicitely clear the buffer, using, for example, cairoRectangle and cairoFill if you want it cleared.

Usage

cairoImageSurfaceCreate(format, width, height)

Arguments

format

[CairoFormat] format of pixels in the surface to create

width

[integer] width of the surface, in pixels

height

[integer] height of the surface, in pixels

Value

• [CairoSurface] a pointer to the newly created surface. The caller owns the surface and should call cairo_surface_destroy 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 cairoSurfaceStatus to check for this.