36   , mEmbeddedInParent( false )
    47   return Qt::ItemIsEnabled;
    66   double itemHeight = std::max( static_cast< double >( settings.
symbolSize().height() ), textHeight );
    77   QIcon symbolIcon = 
data( Qt::DecorationRole ).value<QIcon>();
    78   if ( symbolIcon.isNull() )
    90   QSizeF labelSize( 0, 0 );
   100   labelSize.rheight() = lines.count() * textHeight + ( lines.count() - 1 ) * ( settings.
lineSpacing() + textDescent );
   102   double labelX = 0.0, labelY = 0.0;
   107     labelX = ctx->
point.x() + std::max( static_cast< double >( symbolSize.width() ), ctx->
labelXOffset );
   108     labelY = ctx->
point.y();
   111     if ( labelSize.height() < symbolSize.height() )
   112       labelY += symbolSize.height() / 2 - labelSize.height() / 2;  
   114     labelY += textHeight;
   117   for ( QStringList::ConstIterator itemPart = lines.constBegin(); itemPart != lines.constEnd(); ++itemPart )
   119     labelSize.rwidth() = std::max( settings.
textWidthMillimeters( symbolLabelFont, *itemPart ), double( labelSize.width() ) );
   123       settings.
drawText( ctx->
painter, labelX, labelY, *itemPart, symbolLabelFont );
   124       if ( itemPart != ( lines.end() - 1 ) )
   125         labelY += textDescent + settings.
lineSpacing() + textHeight;
   137   , mSymbolUsesMapUnits( false )
   140   mIconSize = QSize( iconSize, iconSize );
   144   connect( nodeLayer, &QObject::destroyed, 
this, [ = ]() { 
mLayerNode = 
nullptr; } );
   153     return Qt::ItemIsEnabled | Qt::ItemIsUserCheckable;
   155     return Qt::ItemIsEnabled;
   169   QSize minSz( iconSize, iconSize );
   187   if ( !mTextOnSymbolLabel.isEmpty() && context )
   191     int wInt = ceil( w ), hInt = ceil( h );
   192     if ( wInt > minSz.width() ) minSz.setWidth( wInt );
   193     if ( hInt > minSz.height() ) minSz.setHeight( hInt );
   197     minSz.setWidth( mItem.
level() * INDENT_SIZE + minSz.width() );
   212   std::unique_ptr< QgsSymbol > s( symbol ); 
   214   if ( !vlayer || !vlayer->
renderer() )
   239   if ( !vlayer || !vlayer->
renderer() )
   243   for ( 
const auto &item : symbolList )
   264   std::unique_ptr<QgsRenderContext> context = qgis::make_unique<QgsRenderContext>( );
   265   context->setScaleFactor( dpi / 25.4 );
   266   context->setRendererScale( scale );
   268   return context.release();
   271 void QgsSymbolLegendNode::checkAll( 
bool state )
   274   if ( !vlayer || !vlayer->
renderer() )
   278   for ( 
const auto &item : symbolList )
   289   if ( role == Qt::DisplayRole )
   293   else if ( role == Qt::EditRole )
   297   else if ( role == Qt::DecorationRole )
   299     if ( mPixmap.isNull() || mPixmap.size() != mIconSize )
   307         if ( !mTextOnSymbolLabel.isEmpty() && context )
   309           QPainter painter( &pix );
   310           painter.setRenderHint( QPainter::Antialiasing );
   311           context->setPainter( &painter );
   312           QFontMetricsF fm( mTextOnSymbolTextFormat.
scaledFont( *context ) );
   313           qreal yBaselineVCenter = ( mIconSize.height() + fm.ascent() - fm.descent() ) / 2;
   315                                      QStringList() << mTextOnSymbolLabel, *context, mTextOnSymbolTextFormat );
   320         pix = QPixmap( mIconSize );
   321         pix.fill( Qt::transparent );
   329         QPixmap pix2( pix.width() + mItem.
level() * INDENT_SIZE, pix.height() );
   330         pix2.fill( Qt::transparent );
   332         p.drawPixmap( mItem.
level() * INDENT_SIZE, 0, pix );
   339   else if ( role == Qt::CheckStateRole )
   345     if ( !vlayer || !vlayer->
renderer() )
   364   if ( role != Qt::CheckStateRole )
   371   if ( !vlayer || !vlayer->
renderer() )
   415   double height = settings.
symbolSize().height();
   419   double widthOffset = 0;
   420   double heightOffset = 0;
   422   if ( 
QgsMarkerSymbol *markerSymbol = dynamic_cast<QgsMarkerSymbol *>( s ) )
   425     double size = markerSymbol->size( context ) / context.
scaleFactor();
   430       widthOffset = ( settings.
symbolSize().width() - width ) / 2.0;
   432     if ( height < settings.
symbolSize().height() )
   434       heightOffset = ( settings.
symbolSize().height() - height ) / 2.0;
   440     double currentXPosition = ctx->
point.x();
   441     double currentYCoord = ctx->
point.y() + ( itemHeight - settings.
symbolSize().height() ) / 2;
   449       opacity = ( 255 * vectorLayer->opacity() );
   452     p->setRenderHint( QPainter::Antialiasing );
   453     p->translate( currentXPosition + widthOffset, currentYCoord + heightOffset );
   454     p->scale( 1.0 / dotsPerMM, 1.0 / dotsPerMM );
   459       QSize tempImageSize( width * dotsPerMM, height * dotsPerMM );
   460       QImage tempImage = QImage( tempImageSize, QImage::Format_ARGB32 );
   461       tempImage.fill( Qt::transparent );
   462       QPainter imagePainter( &tempImage );
   467       imagePainter.setCompositionMode( QPainter::CompositionMode_DestinationIn );
   468       imagePainter.fillRect( tempImage.rect(), QColor( 0, 0, 0, opacity ) );
   471       p->drawImage( 0, 0, tempImage );
   475       s->
drawPreviewIcon( p, QSize( width * dotsPerMM, height * dotsPerMM ), &context );
   478     if ( !mTextOnSymbolLabel.isEmpty() )
   480       QFontMetricsF fm( mTextOnSymbolTextFormat.
scaledFont( context ) );
   481       qreal yBaselineVCenter = ( height * dotsPerMM + fm.ascent() - fm.descent() ) / 2;
   483                                  QStringList() << mTextOnSymbolLabel, context, mTextOnSymbolTextFormat );
   489   return QSizeF( std::max( width + 2 * widthOffset, static_cast< double >( settings.
symbolSize().width() ) ),
   490                  std::max( height + 2 * heightOffset, static_cast< double >( settings.
symbolSize().height() ) ) );
   503   if ( mSymbolUsesMapUnits )
   511 void QgsSymbolLegendNode::updateLabel()
   526     if ( showFeatureCount && vl && vl->
featureCount() >= 0 )
   527       mLabel += QStringLiteral( 
" [%1]" ).arg( vl->
featureCount() );
   532     if ( showFeatureCount && vl )
   535       mLabel += QStringLiteral( 
" [%1]" ).arg( count != -1 ? QLocale().toString( count ) : tr( 
"N/A" ) );
   557   if ( role == Qt::DisplayRole || role == Qt::EditRole )
   559   else if ( role == Qt::DecorationRole )
   578   if ( role == Qt::DecorationRole )
   580     return QPixmap::fromImage( mImage );
   582   else if ( role == Qt::SizeHintRole )
   584     return mImage.size();
   591   Q_UNUSED( itemHeight );
   596                              mImage, QRectF( 0, 0, mImage.width(), mImage.height() ) );
   612   if ( role == Qt::DecorationRole )
   615     QPixmap pix( iconSize, iconSize );
   619   else if ( role == Qt::DisplayRole || role == Qt::EditRole )
   630     QColor itemColor = mColor;
   634         itemColor.setAlpha( rasterRenderer->opacity() * 255.0 );
   636     ctx->
painter->setBrush( itemColor );
   643       pen.setJoinStyle( Qt::MiterJoin );
   648       ctx->
painter->setPen( Qt::NoPen );
   665 QImage QgsWmsLegendNode::getLegendGraphic()
 const   667   if ( ! mValid && ! mFetcher )
   682     Q_ASSERT( ! mFetcher );
   701   if ( role == Qt::DecorationRole )
   703     return QPixmap::fromImage( getLegendGraphic() );
   705   else if ( role == Qt::SizeHintRole )
   707     return getLegendGraphic().size();
   714   Q_UNUSED( itemHeight );
   720                              QRectF( QPointF( 0, 0 ), mImage.size() ) );
   726 QImage QgsWmsLegendNode::renderMessage( 
const QString &msg )
 const   728   const int fontHeight = 10;
   729   const int margin = fontHeight / 2;
   730   const int nlines = 1;
   732   const int w = 512, h = fontHeight * nlines + margin * ( nlines + 1 );
   733   QImage image( w, h, QImage::Format_ARGB32_Premultiplied );
   735   painter.begin( &image );
   736   painter.setPen( QColor( 255, 0, 0 ) );
   737   painter.setFont( QFont( QStringLiteral( 
"Chicago" ), fontHeight ) );
   738   painter.fillRect( 0, 0, w, h, QColor( 255, 255, 255 ) );
   739   painter.drawText( 0, margin + fontHeight, msg );
   746 void QgsWmsLegendNode::getLegendGraphicProgress( qint64 cur, qint64 tot )
   748   QString msg = QStringLiteral( 
"Downloading... %1/%2" ).arg( cur ).arg( tot );
   750   mImage = renderMessage( msg );
   754 void QgsWmsLegendNode::getLegendGraphicErrored( 
const QString &msg )
   756   if ( ! mFetcher ) 
return; 
   758   mImage = renderMessage( msg );
   770 void QgsWmsLegendNode::getLegendGraphicFinished( 
const QImage &image )
   772   if ( ! mFetcher ) 
return; 
   775   if ( ! image.isNull() )
   777     if ( image != mImage )
   811   if ( role == Qt::DecorationRole )
   814     return QPixmap::fromImage( mImage );
   816   else if ( role == Qt::SizeHintRole )
   819     return mImage.size();
   837     ctx->
painter->setRenderHint( QPainter::Antialiasing );
   860 void QgsDataDefinedSizeLegendNode::cacheImage()
 const   862   if ( mImage.isNull() )
   868       context->setScaleFactor( 96 / 25.4 );
 void setForceVectorOutput(bool force)
 
void drawText(QPainter *p, double x, double y, const QString &text, const QFont &font) const
Draws Text. 
 
virtual QgsLegendSymbolList legendSymbolItems() const
Returns a list of symbology items for the legend. 
 
QgsRenderContext * context
Render context, if available. 
 
QgsDataDefinedSizeLegendNode(QgsLayerTreeLayer *nodeLayer, const QgsDataDefinedSizeLegend &settings, QObject *parent=nullptr)
Construct the node using QgsDataDefinedSizeLegend as definition of the node's appearance. 
 
~QgsDataDefinedSizeLegendNode() override
 
virtual Qt::ItemFlags flags() const
Returns item flags associated with the item. Default implementation returns Qt::ItemIsEnabled. 
 
double mapScale() const
Returns the legend map scale. 
 
QgsRenderContext * createTemporaryRenderContext() const
Returns a temporary context or null if legendMapViewData are not valid. 
 
QList< QgsLegendSymbolItem > QgsLegendSymbolList
 
Text at point of origin draw mode. 
 
QgsSymbol * symbol() const
Returns associated symbol. May be null. 
 
Abstract base class for all rendered symbols. 
 
QString ruleKey() const
Returns unique identifier of the rule for identification of the item within renderer. 
 
bool useAdvancedEffects() const
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
virtual QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const
Draws symbol on the left side of the item. 
 
void setFont(const QFont &font)
Sets font used for rendering of labels - only valid for collapsed legend. 
 
QgsImageLegendNode(QgsLayerTreeLayer *nodeLayer, const QImage &img, QObject *parent=nullptr)
Constructor for QgsImageLegendNode. 
 
virtual bool setData(const QVariant &value, int role)
Sets some data associated with the item. Default implementation does nothing and returns false...
 
QStringList evaluateItemText(const QString &text, const QgsExpressionContext &context) const
Splits a string using the wrap char taking into account handling empty wrap char which means no wrapp...
 
This class provides qgis with the ability to render raster datasets onto the mapcanvas. 
 
QgsSymbolLegendNode(QgsLayerTreeLayer *nodeLayer, const QgsLegendSymbolItem &item, QObject *parent=nullptr)
Constructor for QgsSymbolLegendNode. 
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
bool testFlag(Flag f) const
Check whether a flag is enabled. 
 
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference) 
 
void emitStyleChanged()
Triggers an emission of the styleChanged() signal. 
 
void setRendererScale(double scale)
Sets the renderer map scale. 
 
QFont font() const
The font for this style. 
 
virtual QgsImageFetcher * getLegendGraphicFetcher(const QgsMapSettings *mapSettings)
Returns a new image downloader for the raster legend. 
 
void invalidateMapBasedData() override
Notification from model that information from associated map view has changed. 
 
void invalidateMapBasedData() override
Notification from model that information from associated map view has changed. 
 
QgsLayerTreeLayer * layerNode() const
Returns pointer to the parent layer node. 
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
bool drawRasterStroke() const
Returns whether a stroke will be drawn around raster symbol items. 
 
double textWidthMillimeters(const QFont &font, const QString &text) const
Returns the font width in millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE...
 
QgsLayerTreeModelLegendNode(QgsLayerTreeLayer *nodeL, QObject *parent=nullptr)
Construct the node with pointer to its parent layer node. 
 
QString label() const
Returns text label. 
 
QPainter * painter
Painter. 
 
QgsWmsLegendNode(QgsLayerTreeLayer *nodeLayer, QObject *parent=nullptr)
Constructor for QgsWmsLegendNode. 
 
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item. 
 
A marker symbol type, for rendering Point and MultiPoint geometries. 
 
QColor rasterStrokeColor() const
Returns the stroke color for the stroke drawn around raster symbol items. 
 
The QgsMapSettings class contains configuration for rendering of the map. 
 
QgsUnitTypes::RenderUnit outputUnit() const
Returns the units to use for sizes and widths within the symbol. 
 
void toggleAllItems()
Toggle all items belonging to the same layer as this node. 
 
QSize minimumIconSize() const
Calculates the minimum icon size to prevent cropping. 
 
Perform transforms between map coordinates and device coordinates. 
 
The QgsLayerTreeModel class is model implementation for Qt item views framework. 
 
QSizeF wmsLegendSize() const
 
Rule key of the parent legend node - for legends with tree hierarchy (QString). Added in 2...
 
QgsLegendStyle style(QgsLegendStyle::Style s) const
Returns style. 
 
QgsRasterDataProvider * dataProvider() override
Returns the layer's data provider, it may be null. 
 
QImage collapsedLegendImage(QgsRenderContext &context, const QColor &backgroundColor=Qt::transparent, double paddingMM=1) const
Returns output image that would be shown in the legend. Returns invalid image if legend is not config...
 
QString name() const override
Returns the layer's name. 
 
void setScaleFactor(double factor)
Sets the scaling factor for the render to convert painter units to physical sizes. 
 
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item. 
 
void triggerRepaint(bool deferredUpdate=false)
Will advise the map canvas (and any other interested party) that this layer requires to be repainted...
 
static int scaleIconSize(int standardSize)
Scales an layer tree model icon size to compensate for display pixel density, making the icon size hi...
 
Qt::ItemFlags flags() const override
Returns item flags associated with the item. Default implementation returns Qt::ItemIsEnabled. 
 
Rule key of the node (QString) 
 
void setSymbol(QgsSymbol *s)
Sets the symbol of the item. 
 
QgsRasterSymbolLegendNode(QgsLayerTreeLayer *nodeLayer, const QColor &color, const QString &label, QObject *parent=nullptr)
Constructor for QgsRasterSymbolLegendNode. 
 
long featureCount(const QString &legendKey) const
Number of features rendered with specified legend key. 
 
void checkAllItems()
Checks all items belonging to the same layer as this node. 
 
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
 
void error(const QString &msg)
Emitted when an error occurs. 
 
QgsLayerTreeLayer * mLayerNode
 
double rasterStrokeWidth() const
Returns the stroke width (in millimeters) for the stroke drawn around raster symbol items...
 
QgsLayerTreeModel * model() const
Returns pointer to model owning this legend node. 
 
The QgsLegendSettings class stores the appearance and layout settings for legend drawing with QgsLege...
 
QVariant customProperty(const QString &key, const QVariant &defaultValue=QVariant()) const
Read a custom property from layer. Properties are stored in a map and saved in project file...
 
ItemMetrics draw(const QgsLegendSettings &settings, ItemContext *ctx) override
Entry point called from QgsLegendRenderer to do the rendering. 
 
void drawPreviewIcon(QPainter *painter, QSize size, QgsRenderContext *customContext=nullptr)
Draws an icon of the symbol that occupies an area given by size using the specified painter...
 
void setPainter(QPainter *p)
Sets the destination QPainter for the render operation. 
 
virtual bool legendSymbolItemChecked(const QString &key)
items of symbology items in legend is checked 
 
QgsFeatureRenderer * renderer()
Returns renderer. 
 
static QList< QgsExpressionContextScope * > globalProjectLayerScopes(const QgsMapLayer *layer)
Creates a list of three scopes: global, layer's project and layer. 
 
void dataChanged()
Emitted on internal data change so the layer tree model can forward the signal to views...
 
void symbolFeatureCountMapChanged()
Emitted when the feature count for symbols on this layer has been recalculated. 
 
virtual void checkLegendSymbolItem(const QString &key, bool state=true)
item in symbology was checked 
 
virtual void setLegendSymbolItem(const QString &key, QgsSymbol *symbol)
Sets the symbol to be used for a legend symbol item. 
 
bool isCheckable() const
Returns whether the item is user-checkable - whether renderer supports enabling/disabling it...
 
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item. 
 
QSizeF symbolSize() const
 
static void drawText(const QRectF &rect, double rotation, HAlignment alignment, const QStringList &textLines, QgsRenderContext &context, const QgsTextFormat &format, bool drawAsOutlines=true)
Draws text within a rectangle using the specified settings. 
 
double fontHeightCharacterMM(const QFont &font, QChar c) const
Returns the font height of a character in millimeters. 
 
virtual ItemMetrics draw(const QgsLegendSettings &settings, ItemContext *ctx)
Entry point called from QgsLegendRenderer to do the rendering. 
 
QgsExpressionContext & expressionContext()
Gets the expression context. 
 
void setEmbeddedInParent(bool embedded) override
 
QgsMapLayer * layer() const
Returns the map layer associated with this node. 
 
void setSymbol(QgsSymbol *symbol)
Sets the symbol to be used by the legend node. 
 
const QgsSymbol * symbol() const
Returns the symbol used by the legend node. 
 
QgsSimpleLegendNode(QgsLayerTreeLayer *nodeLayer, const QString &label, const QIcon &icon=QIcon(), QObject *parent=nullptr, const QString &key=QString())
Constructor for QgsSimpleLegendNode. 
 
virtual void setEmbeddedInParent(bool embedded)
 
QFont scaledFont(const QgsRenderContext &context) const
Returns a font with the size scaled to match the format's size settings (including units and map unit...
 
The class stores information about one class/rule of a vector layer renderer in a unified way that ca...
 
Contains information about the context of a rendering operation. 
 
SymbolType type() const
Returns the symbol's type. 
 
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item. 
 
QPointF point
Top-left corner of the legend item. 
 
bool setData(const QVariant &value, int role) override
Sets some data associated with the item. Default implementation does nothing and returns false...
 
void setMapToPixel(const QgsMapToPixel &mtp)
 
virtual QVariant data(int role) const =0
Returns data associated with the item. Must be implemented in derived class. 
 
void legendMapViewData(double *mapUnitsPerPixel, int *dpi, double *scale) const
Gets hints about map view - to be used in legend nodes. 
 
static QRect nonTransparentImageRect(const QImage &image, QSize minSize=QSize(), bool center=false)
Calculates the non-transparent region of an image. 
 
The QgsLegendRendererItem class is abstract interface for legend items returned from QgsMapLayerLegen...
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
void uncheckAllItems()
Unchecks all items belonging to the same layer as this node. 
 
void appendScopes(const QList< QgsExpressionContextScope *> &scopes)
Appends a list of scopes to the end of the context. 
 
void setTextColor(const QColor &color)
Sets text color for rendering of labels - only valid for collapsed legend. 
 
virtual QSizeF drawSymbolText(const QgsLegendSettings &settings, ItemContext *ctx, QSizeF symbolSize) const
Draws label on the right side of the item. 
 
QString parentRuleKey() const
Key of the parent legend node. 
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
void drawCollapsedLegend(QgsRenderContext &context, QSize *outputSize SIP_OUT=nullptr, int *labelXOffset SIP_OUT=nullptr) const
Draw the legend if using LegendOneNodeForAll and optionally output size of the legend and x offset of...
 
double lineSpacing() const
 
For legends that support it, will show them in a tree instead of a list (needs also ShowLegend)...
 
static double textWidth(const QgsRenderContext &context, const QgsTextFormat &format, const QStringList &textLines, QFontMetricsF *fontMetrics=nullptr)
Returns the width of a text based on a given format. 
 
double scaleFactor() const
Returns the scaling factor for the render to convert painter units to physical sizes. 
 
Represents a vector layer which manages a vector based data sets. 
 
double labelXOffset
offset from the left side where label should start 
 
void finish(const QImage &legend)
Emitted when the download completes. 
 
Object that keeps configuration of appearance of marker symbol's data-defined size in legend...
 
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class. 
 
int level() const
Indentation level that tells how deep the item is in a hierarchy of items. For flat lists level is 0...
 
double fontDescentMillimeters(const QFont &font) const
Returns the font descent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCA...
 
double mmPerMapUnit() const
 
Raster renderer pipe that applies colors to a raster. 
 
void progress(qint64 received, qint64 total)
Emitted to report progress. 
 
void setExpressionContext(const QgsExpressionContext &context)
Sets the expression context. 
 
Layer tree node points to a map layer. 
 
Base class for raster data providers. 
 
static double textHeight(const QgsRenderContext &context, const QgsTextFormat &format, const QStringList &textLines, DrawMode mode, QFontMetricsF *fontMetrics=nullptr)
Returns the height of a text based on a given format. 
 
static QPixmap symbolPreviewPixmap(const QgsSymbol *symbol, QSize size, int padding=0, QgsRenderContext *customContext=nullptr)
Returns a pixmap preview for a color ramp.