QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
Public Member Functions | List of all members
QgsLayoutItemRenderContext Class Reference

Contains settings and helpers relating to a render of a QgsLayoutItem. More...

#include <qgslayoutitem.h>

Public Member Functions

 QgsLayoutItemRenderContext (const QgsLayoutItemRenderContext &other)=delete
 QgsLayoutItemRenderContext cannot be copied. More...
 
 QgsLayoutItemRenderContext (QgsRenderContext &context, double viewScaleFactor=1.0)
 Constructor for QgsLayoutItemRenderContext. More...
 
QgsLayoutItemRenderContextoperator= (const QgsLayoutItemRenderContext &other)=delete
 QgsLayoutItemRenderContext cannot be copied. More...
 
QgsRenderContextrenderContext ()
 Returns a reference to the context's render context. More...
 
const QgsRenderContextrenderContext () const
 Returns a reference to the context's render context. More...
 
double viewScaleFactor () const
 Returns the current view zoom (scale factor). More...
 

Detailed Description

Contains settings and helpers relating to a render of a QgsLayoutItem.

Since
QGIS 3.0

Definition at line 44 of file qgslayoutitem.h.

Constructor & Destructor Documentation

◆ QgsLayoutItemRenderContext() [1/2]

QgsLayoutItemRenderContext::QgsLayoutItemRenderContext ( QgsRenderContext context,
double  viewScaleFactor = 1.0 
)

Constructor for QgsLayoutItemRenderContext.

The renderContext parameter specifies a QgsRenderContext for use within the QgsLayoutItemRenderContext.

The viewScaleFactor gives the current view zoom (scale factor). It can be used to scale render graphics so that they always appear a constant size, regardless of the current view zoom.

Definition at line 39 of file qgslayoutitem.cpp.

◆ QgsLayoutItemRenderContext() [2/2]

QgsLayoutItemRenderContext::QgsLayoutItemRenderContext ( const QgsLayoutItemRenderContext other)
delete

QgsLayoutItemRenderContext cannot be copied.

Member Function Documentation

◆ operator=()

QgsLayoutItemRenderContext & QgsLayoutItemRenderContext::operator= ( const QgsLayoutItemRenderContext other)
delete

QgsLayoutItemRenderContext cannot be copied.

◆ renderContext() [1/2]

QgsRenderContext & QgsLayoutItemRenderContext::renderContext ( )
inline

Returns a reference to the context's render context.

Note that the context's painter has been scaled so that painter units are pixels. Use the QgsRenderContext methods to convert from millimeters or other units to the painter's units.

Definition at line 72 of file qgslayoutitem.h.

◆ renderContext() [2/2]

const QgsRenderContext & QgsLayoutItemRenderContext::renderContext ( ) const
inline

Returns a reference to the context's render context.

Note that the context's painter has been scaled so that painter units are pixels. Use the QgsRenderContext methods to convert from millimeters or other units to the painter's units.

Note
Not available in Python bindings.

Definition at line 82 of file qgslayoutitem.h.

◆ viewScaleFactor()

double QgsLayoutItemRenderContext::viewScaleFactor ( ) const
inline

Returns the current view zoom (scale factor).

It can be used to scale render graphics so that they always appear a constant size, regardless of the current view zoom.

E.g. a value of 0.5 indicates that the view is zoomed out to 50% size, so rendered items must be scaled by 200% in order to have a constant visible size. A value of 2.0 indicates that the view is zoomed in 200%, so rendered items must be scaled by 50% in order to have a constant visible size.

Definition at line 94 of file qgslayoutitem.h.


The documentation for this class was generated from the following files: