Class: QgsLayoutRenderContext¶

Stores information relating to the current rendering settings for a layout.

Class Hierarchy¶

Base classes¶

QObject

class qgis.core.QgsLayoutRenderContext[source]¶

Bases: QObject

__init__(layout: QgsLayout | None)

Constructor for QgsLayoutRenderContext.

Parameters:: layout (Optional[QgsLayout])

Flag¶: alias of LayoutRenderFlag

Flags¶: alias of LayoutRenderFlags

boundingBoxesVisible(self) → bool[source]¶

Returns True if the item bounding boxes should be drawn.

See also

setBoundingBoxesVisible()

Return type:: bool

currentExportLayer(self) → int[source]¶

Returns the current item layer to draw while exporting. QgsLayoutItem subclasses which support multi-layer SVG exports must check this and customize their rendering based on the layer.

If layer is -1, all item layers should be rendered.

See also

setCurrentExportLayer()

Deprecated since version 3.40: Items should now handle this themselves, via QgsLayoutItem.exportLayerBehavior() and returning QgsLayoutItem.nextExportPart().

Return type:: int

dpi(self) → float[source]¶

Returns the dpi for outputting the layout.

See also

setDpi()

Return type:: float

signal dpiChanged[source]¶

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

exportThemes(self) → List[str][source]¶

Returns a list of map themes to use during the export.

Items which handle layered exports (e.g. maps) may utilize this list to export different representations of the item as export layers, as they iterate through these included themes.

See also

setExportThemes()

Added in version 3.10.

Return type:: List[str]

featureFilterProvider(self) → QgsFeatureFilterProvider | None[source]¶

Returns the (possibly None) feature filter provider.

A feature filter provider for filtering visible features or attributes. It is currently used by QGIS Server Access Control Plugins.

Added in version 3.18.

Return type:: Optional[QgsFeatureFilterProvider]

flags(self) → Qgis.LayoutRenderFlags[source]¶

Returns the current combination of flags used for rendering the layout.

See also

setFlags()

See also

setFlag()

See also

testFlag()

Return type:: Qgis.LayoutRenderFlags

signal flagsChanged[source]¶

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

gridVisible(self) → bool[source]¶

Returns True if the page grid should be drawn.

See also

setGridVisible()

Return type:: bool

isPreviewRender(self) → bool[source]¶

Returns True if the render current being conducted is a preview render, i.e. it is being rendered inside a QGraphicsView widget as opposed to a destination device (such as an image).

Return type:: bool

maskSettings(self) → QgsMaskRenderSettings¶

Returns a reference to the mask render settings, which control how masks are drawn and behave during map renders.

See also

setMaskSettings()

Added in version 3.38.

Return type:: QgsMaskRenderSettings

measurementConverter(self) → QgsLayoutMeasurementConverter¶

Returns the layout measurement converter to be used in the layout. This converter is used for translating between other measurement units and the layout’s native unit.

Return type:: QgsLayoutMeasurementConverter

pagesVisible(self) → bool[source]¶

Returns whether the page items are be visible in the layout. This setting effects both display of the page boundaries in layout views and whether they will be rendered in layout exports.

See also

setPagesVisible()

Return type:: bool

predefinedScales(self) → List[float]¶

Returns the current list of predefined scales for use with the layout.

See also

setPredefinedScales()

Added in version 3.10.

Return type:: List[float]

signal predefinedScalesChanged[source]¶

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

rasterizedRenderingPolicy(self) → Qgis.RasterizedRenderingPolicy[source]¶

Returns the policy controlling when rasterization of content during renders is permitted.

See also

setRasterizedRenderingPolicy()

Added in version 3.44.

Return type:: Qgis.RasterizedRenderingPolicy

renderContextFlags(self) → Qgis.RenderContextFlags[source]¶

Returns the combination of render context flags matched to the layout context’s settings.

Return type:: Qgis.RenderContextFlags

selectionColor(self) → QColor[source]¶

Gets color that is used for drawing of selected vector features

See also

setSelectionColor()

Added in version 3.4.

Return type:: QColor

setBoundingBoxesVisible(self, visible: bool)[source]¶

Sets whether the item bounding boxes should be visible.

See also

boundingBoxesVisible()

Parameters:: visible (bool)

setCurrentExportLayer(self, layer: int = -1)[source]¶

Sets the current item layer to draw while exporting. QgsLayoutItem subclasses which support multi-layer SVG exports must check the currentExportLayer() and customize their rendering based on the layer.

If layer is -1, all item layers will be rendered.

See also

currentExportLayer()

Deprecated since version 3.40: Items should now handle this themselves, via QgsLayoutItem.exportLayerBehavior() and returning QgsLayoutItem.nextExportPart().

Parameters:: layer (int = -1)

setDpi(self, dpi: float)[source]¶

Sets the dpi for outputting the layout. This also sets the corresponding DPI for the context’s measurementConverter().

See also

dpi()

Parameters:: dpi (float)

setExportThemes(self, themes: Iterable[str | None])[source]¶

Sets a list of map themes to use during the export.

Items which handle layered exports (e.g. maps) may utilize this list to export different representations of the item as export layers, as they iterate through these included themes.

See also

exportThemes()

Added in version 3.10.

Parameters:: themes (Iterable[Optional[str]])

setFeatureFilterProvider(self, featureFilterProvider: QgsFeatureFilterProvider | None)[source]¶

Sets feature filter provider to featureFilterProvider.

A feature filter provider for filtering visible features or attributes. It is currently used by QGIS Server Access Control Plugins.

Added in version 3.18.

Parameters:: featureFilterProvider (Optional[QgsFeatureFilterProvider])

setFlag(self, flag: Qgis.LayoutRenderFlag, on: bool = True)[source]¶

Enables or disables a particular rendering flag for the layout. Other existing flags are not affected.

See also

setFlags()

See also

flags()

See also

testFlag()

Parameters:

flag (Qgis.LayoutRenderFlag)
on (bool = True)

setFlags(self, flags: Qgis.LayoutRenderFlags | Qgis.LayoutRenderFlag)[source]¶

Sets the combination of flags that will be used for rendering the layout.

See also

setFlag()

See also

flags()

See also

testFlag()

Parameters:: flags (Union[Qgis.LayoutRenderFlags, Qgis.LayoutRenderFlag])

setGridVisible(self, visible: bool)[source]¶

Sets whether the page grid should be visible.

See also

gridVisible()

Parameters:: visible (bool)

setMaskSettings(self, settings: QgsMaskRenderSettings)[source]¶

Sets the mask render settings, which control how masks are drawn and behave during map renders.

See also

maskSettings()

Added in version 3.38.

Parameters:: settings (QgsMaskRenderSettings)

setPagesVisible(self, visible: bool)[source]¶

Sets whether the page items should be visible in the layout. Removing them will prevent both display of the page boundaries in layout views and will also prevent them from being rendered in layout exports.

See also

pagesVisible()

Parameters:: visible (bool)

setPredefinedScales(self, scales: Iterable[float])[source]¶

Sets the list of predefined scales to use with the layout. This is used for maps which are set to the predefined atlas scaling mode.

See also

predefinedScales()

Added in version 3.10.

Parameters:: scales (Iterable[float])

setRasterizedRenderingPolicy(self, policy: Qgis.RasterizedRenderingPolicy)[source]¶

Sets the policy controlling when rasterization of content during renders is permitted.

See also

rasterizedRenderingPolicy()

Added in version 3.44.

Parameters:: policy (Qgis.RasterizedRenderingPolicy)

setSelectionColor(self, color: QColor | Qt.GlobalColor)[source]¶

Sets color that is used for drawing of selected vector features

See also

selectionColor()

Added in version 3.4.

Parameters:: color (Union[QColor, Qt.GlobalColor])

setSimplifyMethod(self, method: QgsVectorSimplifyMethod)[source]¶

Sets the simplification setting to use when rendering vector layers.

If the simplify method is enabled, it apply to all vector layers rendered inside map items.

This can be used to specify global simplification methods to apply during map exports, e.g. to allow vector layers to be simplified to an appropriate maximum level of detail during PDF exports (avoiding excessive PDF size due to huge numbers of vertices).

The default is to use no simplification.

Note

This simplification method is only used during non-preview renders.

See also

simplifyMethod()

Added in version 3.10.