RGtk2 (version 2.20.31)

cairo-surface: cairo_surface_t

Description

Base class for surfaces

Arguments

Methods and Functions

cairoSurfaceCreateSimilar(other, content, width, height) cairoSurfaceDestroy(surface) cairoSurfaceStatus(surface) cairoSurfaceFinish(surface) cairoSurfaceFlush(surface) cairoSurfaceGetFontOptions(surface) cairoSurfaceGetContent(surface) cairoSurfaceMarkDirty(surface) cairoSurfaceMarkDirtyRectangle(surface, x, y, width, height) cairoSurfaceSetDeviceOffset(surface, x.offset, y.offset) cairoSurfaceGetDeviceOffset(surface) cairoSurfaceSetFallbackResolution(surface, x.pixels.per.inch, y.pixels.per.inch) cairoSurfaceGetFallbackResolution(surface) cairoSurfaceGetType(surface) cairoSurfaceSetUserData(surface, key, user.data) cairoSurfaceGetUserData(surface, key) cairoSurfaceCopyPage(surface) cairoSurfaceShowPage(surface) cairoSurfaceHasShowTextGlyphs(surface) cairoSurface(width, height, format, other, content, data, stride, filename, con)

Detailed Description

CairoSurface is the abstract type representing all different drawing targets that cairo can render to. The actual drawings are performed using a cairo context. A cairo surface is created by using backend-specific constructors, typically of the form cairo_backendsurfaceCreate().

Structures

Convenient Construction

cairoSurface is the result of collapsing the constructors of cairo_surface_t (cairoSurfaceCreateSimilar, cairoImageSurfaceCreate, cairoImageSurfaceCreateForData, cairoImageSurfaceCreateFromPng, cairoImageSurfaceCreateFromPngStream, cairoPdfSurfaceCreate, cairoPdfSurfaceCreateForStream, cairoPsSurfaceCreate, cairoPsSurfaceCreateForStream, cairoSvgSurfaceCreate, cairoSvgSurfaceCreateForStream) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.

Enums and Flags

CairoContent
CairoContent is used to describe the content that a surface will contain, whether color information, alpha information (translucence vs. opacity), or both. Note: The large values here are designed to keep CairoContent values distinct from CairoFormat values so that the implementation can detect the error if users confuse the two types.
color
The surface will hold color content only.
alpha
The surface will hold alpha content only.
color-alpha
The surface will hold color and alpha content.
CairoSurfaceType
CairoSurfaceType is used to describe the type of a given surface. The surface types are also known as "backends" or "surface backends" within cairo. The type of a surface is determined by the function used to create it, which will generally be of the form cairo_typesurfaceCreate(), (though see cairoSurfaceCreateSimilar as well). The surface type can be queried with cairoSurfaceGetType The various CairoSurface functions can be used with surfaces of any type, but some backends also provide type-specific functions that must only be called with a surface of the appropriate type. These functions have names that begin with cairo_type_surface such as cairoImageSurfaceGetWidth. The behavior of calling a type-specific function with a surface of the wrong type is undefined. New entries may be added in future versions. Since 1.2
image
The surface is of type image
pdf
The surface is of type pdf
ps
The surface is of type ps
xlib
The surface is of type xlib
xcb
The surface is of type xcb
glitz
The surface is of type glitz
quartz
The surface is of type quartz
win32
The surface is of type win32
beos
The surface is of type beos
directfb
The surface is of type directfb
svg
The surface is of type svg

References

http://www.cairographics.org/manual/cairo-surface.html