Module Functions and Constants
Module Functions
- cairo.cairo_version() int
- Returns:
- the encoded version 
 - Returns the version of the underlying C cairo library, encoded in a single integer. 
Module Constants
- cairo.CAIRO_VERSION: int = Ellipsis
- The version of cairo available at compile-time in the same format as returned by - cairo_version()- Added in version 1.18.0. 
- cairo.CAIRO_VERSION_STRING: str = Ellipsis
- A human-readable string literal containing the version of cairo available at compile-time, in the form of “X.Y.Z”. - Added in version 1.18.0. 
- cairo.CAIRO_VERSION_MAJOR: int = Ellipsis
- The major component of the version of cairo available at compile-time. - Added in version 1.18.0. 
- cairo.CAIRO_VERSION_MINOR: int = Ellipsis
- The minor component of the version of cairo available at compile-time. - Added in version 1.18.0. 
- cairo.CAIRO_VERSION_MICRO: int = Ellipsis
- The micro component of the version of cairo available at compile-time. - Added in version 1.18.0. 
cairo.HAS
1 if the feature is present in the underlying C cairo library, 0 otherwise.
cairo.TAG
- cairo.TAG_DEST: str = Ellipsis
- Create a destination for a hyperlink. Destination tag attributes are detailed at Destinations. - Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.TAG_LINK: str = Ellipsis
- Create hyperlink. Link tag attributes are detailed at Links. - Added in version 1.18.0: Only available with cairo 1.15.10+ 
cairo.MIME_TYPE
- cairo.MIME_TYPE_JP2: str = Ellipsis
- The Joint Photographic Experts Group (JPEG) 2000 image coding standard (ISO/IEC 15444-1). - Added in version 1.12.0. 
- cairo.MIME_TYPE_JPEG: str = Ellipsis
- The Joint Photographic Experts Group (JPEG) image coding standard (ISO/IEC 10918-1). - Added in version 1.12.0. 
- cairo.MIME_TYPE_PNG: str = Ellipsis
- The Portable Network Graphics image file format (ISO/IEC 15948). - Added in version 1.12.0. 
- cairo.MIME_TYPE_URI: str = Ellipsis
- URI for an image file (unofficial MIME type). - Added in version 1.12.0. 
- cairo.MIME_TYPE_UNIQUE_ID: str = Ellipsis
- Unique identifier for a surface (cairo specific MIME type). All surfaces with the same unique identifier will only be embedded once. - Added in version 1.12.0. 
- cairo.MIME_TYPE_CCITT_FAX: str = Ellipsis
- Group 3 or Group 4 CCITT facsimile encoding (International Telecommunication Union, Recommendations T.4 and T.6.) - Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.MIME_TYPE_CCITT_FAX_PARAMS: str = Ellipsis
- Decode parameters for Group 3 or Group 4 CCITT facsimile encoding. See CCITT Fax Images. - Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.MIME_TYPE_EPS: str = Ellipsis
- Encapsulated PostScript file. Encapsulated PostScript File Format Specification - Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.MIME_TYPE_EPS_PARAMS: str = Ellipsis
- Embedding parameters Encapsulated PostScript data. See Embedding EPS files. - Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.MIME_TYPE_JBIG2: str = Ellipsis
- Joint Bi-level Image Experts Group image coding standard (ISO/IEC 11544). - Added in version 1.18.0. 
Other Constants
- cairo.PDF_OUTLINE_ROOT: int = Ellipsis
- The root outline item in - PDFSurface.add_outline()- Added in version 1.18.0: Only available with cairo 1.15.10+ 
- cairo.COLOR_PALETTE_DEFAULT: int = Ellipsis
- The default color palette index. See - FontOptions.set_color_palette()- Added in version 1.25.0: Only available with cairo 1.17.8+ 
Other Classes and Functions
- 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. - Added in version 1.15.1: Older versions only supported a subset of - strpaths
- class cairo._FileLike
- This type only exists for documentation purposes. - This represents a file object opened in binary mode: - typing.BinaryIO
- class cairo._SomeSurface
- This type only exists for documentation purposes. - This represents a - Surfacesubclass.
- class cairo._WritableBuffer
- This type only exists for documentation purposes. - This represents a writable buffer object, like - memoryview,- bytearray,- array.array,- collections.abc.Buffer, or anything implementing the buffer protocol.