Device

The different format handlers (pdf, xps, etc.) interpret pages to a “device”. Devices are the basis for everything that can be done with a page: rendering, text extraction and searching. The device type is determined by the selected construction method.

Class API

class Device
__init__(self, object, clip)

Constructor for either a pixel map or a display list device.

Parameters
  • object (Pixmap or DisplayList) – either a Pixmap or a DisplayList.

  • clip (IRect) – An optional IRect for Pixmap devices to restrict rendering to a certain area of the page. If the complete page is required, specify None. For display list devices, this parameter must be omitted.

__init__(self, textpage, flags=0)

Constructor for a text page device.

Parameters
  • textpage (TextPage) – TextPage object

  • flags (int) – control the way how text is parsed into the text page. Currently 3 options can be coded into this parameter, see Text Extraction Flags. To set these options use something like flags=0 | TEXT_PRESERVE_LIGATURES | ….