cairo-surface: cairo_surface_t
Description
Base class for surfacesMethods 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()
.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