# 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 `str`/`unicode` under Python 2 and `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