class QPdfPageRenderer

The QPdfPageRenderer class encapsulates the rendering of pages of a PDF document. More

Inheritance diagram of PySide6.QtPdf.QPdfPageRenderer

Synopsis

Properties

Methods

Signals

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

The QPdfPageRenderer contains a queue that collects all render requests that are invoked through requestPage() . Depending on the configured RenderMode the QPdfPageRenderer processes this queue in the main UI thread on next event loop invocation (RenderMode::SingleThreaded) or in a separate worker thread (RenderMode::MultiThreaded) and emits the result through the pageRendered() signal for each request once the rendering is done.

See also

QPdfDocument

class RenderMode

This enum describes how the pages are rendered.

Constant

Description

QPdfPageRenderer.RenderMode.MultiThreaded

All pages are rendered in a separate worker thread.

QPdfPageRenderer.RenderMode.SingleThreaded

All pages are rendered in the main UI thread (default).

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property documentᅟ: QPdfDocument

This property holds The document instance this object renders the pages from..

By default, this property is nullptr.

Access functions:
property renderModeᅟ: QPdfPageRenderer.RenderMode

This property holds The mode the renderer uses to render the pages..

By default, this property is RenderMode::SingleThreaded.

Access functions:
__init__()
__init__(parent)
Parameters:

parentQObject

Constructs a page renderer object with parent object parent.

document()
Return type:

QPdfDocument

Returns the document this objects renders the pages from, or a nullptr if none has been set before.

Getter of property documentᅟ .

documentChanged(document)
Parameters:

documentQPdfDocument

Notification signal of property documentᅟ .

pageRendered(pageNumber, imageSize, image, options, requestId)
Parameters:
renderMode()
Return type:

RenderMode

Returns the mode of how the pages are rendered.

Getter of property renderModeᅟ .

renderModeChanged(renderMode)
Parameters:

renderModeRenderMode

Notification signal of property renderModeᅟ .

requestPage(pageNumber, imageSize[, options=QPdfDocumentRenderOptions()])
Parameters:
Return type:

int

Requests the renderer to render the page pageNumber into a QImage of size imageSize according to the provided options.

Once the rendering is done the pageRendered() signal is emitted with the result as parameters.

The return value is an ID that uniquely identifies the render request. If a request with the same parameters is still in the queue, the ID of that queued request is returned.

setDocument(document)
Parameters:

documentQPdfDocument

Sets the document this object renders the pages from.

Setter of property documentᅟ .

setRenderMode(mode)
Parameters:

modeRenderMode

Sets the mode of how the pages are rendered to mode.

Setter of property renderModeᅟ .