1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
.. _Device:
================
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
.. method:: __init__(self, object, clip)
Constructor for either a pixel map or a display list device.
:arg object: either a *Pixmap* or a *DisplayList*.
:type object: :ref:`Pixmap` or :ref:`DisplayList`
:arg clip: 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.
:type clip: :ref:`IRect`
.. method:: __init__(self, textpage, flags=0)
Constructor for a text page device.
:arg textpage: *TextPage* object
:type textpage: :ref:`TextPage`
:arg int flags: control the way how text is parsed into the text page. Currently 3 options can be coded into this parameter, see :ref:`TextPreserve`. To set these options use something like *flags=0 | TEXT_PRESERVE_LIGATURES | ...*.
.. note:: In higher level code (:meth:`Page.getText`, :meth:`Document.getPageText`), the following decisions for creating text devices have been implemented: (1) *TEXT_PRESERVE_LIGATURES* and *TEXT_PRESERVE_WHITESPACES* are always set, (2) *TEXT_PRESERVE_IMAGES* is set for JSON and HTML, otherwise off.
|
