QPdfPageRenderer#

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

Inheritance diagram of PySide6.QtPdf.QPdfPageRenderer

Synopsis#

Properties#

  • document - Instance this object renders the pages from

  • renderMode - Mode the renderer uses to render the pages

Functions#

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 PySide6.QtPdf.QPdfPageRenderer#

PySide6.QtPdf.QPdfPageRenderer(parent)

Parameters:

parentPySide6.QtCore.QObject

Constructs a page renderer object with parent object parent.

Note

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

property PᅟySide6.QtPdf.QPdfPageRenderer.document: PySide6.QtPdf.QPdfDocument#

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

By default, this property is nullptr.

Access functions:
property PᅟySide6.QtPdf.QPdfPageRenderer.renderMode: RenderMode#

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

By default, this property is RenderMode::SingleThreaded.

See also

setRenderMode() RenderMode

Access functions:
PySide6.QtPdf.QPdfPageRenderer.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).

PySide6.QtPdf.QPdfPageRenderer.document()#
Return type:

PySide6.QtPdf.QPdfDocument

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

Getter of property document .

PySide6.QtPdf.QPdfPageRenderer.documentChanged(document)#
Parameters:

documentPySide6.QtPdf.QPdfDocument

Notification signal of property document .

PySide6.QtPdf.QPdfPageRenderer.pageRendered(pageNumber, imageSize, image, options, requestId)#
Parameters:
PySide6.QtPdf.QPdfPageRenderer.renderMode()#
Return type:

RenderMode

Returns the mode of how the pages are rendered.

See also

setRenderMode() RenderMode

Getter of property renderMode .

PySide6.QtPdf.QPdfPageRenderer.renderModeChanged(renderMode)#
Parameters:

renderModeRenderMode

Notification signal of property renderMode .

PySide6.QtPdf.QPdfPageRenderer.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.

PySide6.QtPdf.QPdfPageRenderer.setDocument(document)#
Parameters:

documentPySide6.QtPdf.QPdfDocument

Sets the document this object renders the pages from.

Setter of property document .

PySide6.QtPdf.QPdfPageRenderer.setRenderMode(mode)#
Parameters:

modeRenderMode

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

See also

renderMode() RenderMode

Setter of property renderMode .