Module Functions and Constants¶
Module Functions¶
-
cairo.
cairo_version
()¶ - Returns
the encoded version
- Return type
int
Returns the version of the underlying C cairo library, encoded in a single integer.
-
cairo.
cairo_version_string
()¶ - Returns
the encoded version
- Return type
str
Returns the version of the underlying C cairo library as a human-readable string of the form “X.Y.Z”.
-
cairo.
get_include
()¶ - Returns
a path to the directory containing the C header files
- Return type
str
Gives the include path which should be passed to the compiler.
New in version 1.16.0.
Module Constants¶
-
cairo.
version
¶ the pycairo version, as a string
-
cairo.
version_info
¶ the pycairo version, as a tuple
cairo.HAS¶
1 if the feature is present in the underlying C cairo library, 0 otherwise.
-
cairo.
HAS_ATSUI_FONT
¶ -
cairo.
HAS_FT_FONT
¶ -
cairo.
HAS_GLITZ_SURFACE
¶ -
cairo.
HAS_IMAGE_SURFACE
¶ -
cairo.
HAS_PDF_SURFACE
¶ -
cairo.
HAS_PNG_FUNCTIONS
¶ -
cairo.
HAS_PS_SURFACE
¶ -
cairo.
HAS_RECORDING_SURFACE
¶ -
cairo.
HAS_SVG_SURFACE
¶ -
cairo.
HAS_USER_FONT
¶ -
cairo.
HAS_QUARTZ_SURFACE
¶ -
cairo.
HAS_WIN32_FONT
¶ -
cairo.
HAS_WIN32_SURFACE
¶ -
cairo.
HAS_XCB_SURFACE
¶ -
cairo.
HAS_XLIB_SURFACE
¶
-
cairo.
HAS_MIME_SURFACE
¶ New in version 1.12.0.
-
cairo.
HAS_SCRIPT_SURFACE
¶ New in version 1.12.0.
-
cairo.
HAS_TEE_SURFACE
¶ New in version 1.15.3.
cairo.MIME_TYPE¶
-
cairo.
MIME_TYPE_JP2
= "image/jp2"¶ The Joint Photographic Experts Group (JPEG) 2000 image coding standard (ISO/IEC 15444-1).
New in version 1.12.0.
-
cairo.
MIME_TYPE_JPEG
= "image/jpeg"¶ The Joint Photographic Experts Group (JPEG) image coding standard (ISO/IEC 10918-1).
New in version 1.12.0.
-
cairo.
MIME_TYPE_PNG
= "image/png"¶ The Portable Network Graphics image file format (ISO/IEC 15948).
New in version 1.12.0.
-
cairo.
MIME_TYPE_URI
= "text/x-uri"¶ URI for an image file (unofficial MIME type).
New in version 1.12.0.
-
cairo.
MIME_TYPE_UNIQUE_ID
= "application/x-cairo.uuid"¶ Unique identifier for a surface (cairo specific MIME type). All surfaces with the same unique identifier will only be embedded once.
New in version 1.12.0.
Other Classes and Functions¶
-
class
cairo.
text
¶ This type only exists for documentation purposes. It represents
python:str
/python:unicode
under Python 2 andpython3:str
under Python 3.
-
class
cairo.
pathlike
¶ This type only exists for documentation purposes.
On Unix it is equal to what Python allows as a filesystem path. On Windows with cairo <=1.15.8 only ANSI paths are supported. With cairo >=1.15.10 all paths are supported as long as they don’t contain surrogates.
Many functions taking a path also allow passing in an already open Python file object. This can be used to support all Python filesystem paths independent of the underlying platform or cairo version.
New in version 1.15.1: Older versions only supported a subset of
str
paths