48#include "moc_qgslayertreemodellegendnode.cpp"
58 return qobject_cast<QgsLayerTreeModel *>( parent() );
63 return Qt::ItemIsEnabled;
99 std::optional< QgsScopedRenderContextScaleToPixels > scaleToPx( *ctx.
context );
122 const double itemHeight = std::max(
static_cast< double >( ctx.
patchSize.height() > 0 ? ctx.
patchSize.height() : settings.
symbolSize().height() ), textHeight );
136 const QString text =
data( Qt::DisplayRole ).toString();
137 json[ QStringLiteral(
"title" ) ] = text;
143 const QIcon symbolIcon =
data( Qt::DecorationRole ).value<QIcon>();
144 if ( symbolIcon.isNull() )
151 size.setWidth( ctx->
patchSize.width( ) );
153 size.setHeight( ctx->
patchSize.height( ) );
160 const int width =
static_cast<int>( size.width() * scaleFactor );
161 const int height =
static_cast<int>( size.height() * scaleFactor );
162 const int y =
static_cast<int>( ( ctx->
top + ( itemHeight - size.height() ) / 2 ) * scaleFactor );
169 x =
static_cast<int>( ctx->
columnLeft * scaleFactor );
172 x =
static_cast<int>( ( ctx->
columnRight - size.width() ) * scaleFactor );
175 symbolIcon.paint( ctx->
painter, x, y, width, height );
182 const QIcon icon =
data( Qt::DecorationRole ).value<QIcon>();
184 return QJsonObject();
186 const QImage image( icon.pixmap( settings.
symbolSize().width(), settings.
symbolSize().height() ).toImage() );
187 QByteArray byteArray;
188 QBuffer buffer( &byteArray );
189 image.save( &buffer,
"PNG" );
190 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
193 json[ QStringLiteral(
"icon" ) ] = base64;
200 std::unique_ptr< QgsRenderContext > tempContext;
205 context = tempContext.get();
211 std::optional< QgsTextDocument > tempDocument;
217 document = &tempDocument.value();
220 std::optional< QgsTextDocumentMetrics > tempMetrics;
225 metrics = &tempMetrics.value();
232 const QSizeF labelSizeMM( documentSize / dotsPerMM );
234 double labelXMin = 0.0;
235 double labelXMax = 0.0;
236 double labelYMM = 0.0;
237 if ( ctx && context->
painter() )
263 if ( labelSizeMM.height() < symbolSizeMM.height() )
264 labelYMM += ( symbolSizeMM.height() - labelSizeMM.height() ) / 2;
274 ( labelXMax - labelXMin )* dotsPerMM,
275 std::max( symbolSizeMM.height(), labelSizeMM.height() ) * dotsPerMM ),
297 if ( !vlayer->renderer() )
301 for (
const auto &item : symbolList )
303 vlayer->renderer()->checkLegendSymbolItem( item.ruleKey(), ! vlayer->renderer()->legendSymbolItemChecked( item.ruleKey() ) );
307 vlayer->emitStyleChanged();
308 vlayer->triggerRepaint();
312 if ( !pclayer->renderer() )
315 const QStringList ruleKeys = pclayer->renderer()->legendRuleKeys();
316 for (
const QString &rule : ruleKeys )
318 pclayer->renderer()->checkLegendItem( rule, !pclayer->renderer()->legendItemChecked( rule ) );
322 pclayer->emitStyleChanged();
323 pclayer->triggerRepaint();
344 MINIMUM_SIZE = settings.
value(
"/qgis/legendsymbolMinimumSize", 0.5 ).toDouble();
345 MAXIMUM_SIZE = settings.
value(
"/qgis/legendsymbolMaximumSize", 20.0 ).toDouble();
352 connect( nodeLayer, &QObject::destroyed,
this, [
this]() {
mLayerNode =
nullptr; } );
356 mSymbolUsesMapUnits =
symbol->usesMapUnits();
364 if ( mItem.isCheckable() )
365 return Qt::ItemIsEnabled | Qt::ItemIsUserCheckable | Qt::ItemIsSelectable;
367 return Qt::ItemIsEnabled | Qt::ItemIsSelectable;
385 int maxSize = largeIconSize;
393 if ( !ok && context )
408 context,
false,
nullptr,
nullptr, targetScreen ).toImage(),
413 if ( !mTextOnSymbolLabel.isEmpty() && context )
417 int wInt = ceil( w ), hInt = ceil( h );
418 if ( wInt > minSz.width() ) minSz.setWidth( wInt );
419 if ( hInt > minSz.height() ) minSz.setHeight( hInt );
427 return mItem.symbol();
435 const QVariant legendlabel =
mLayerNode->customProperty( QStringLiteral(
"legend/title-label" ) );
463 return mCustomSymbol.get();
468 mCustomSymbol.reset(
symbol );
476 std::unique_ptr< QgsSymbol > s(
symbol );
478 if ( !vlayer || !vlayer->
renderer() )
481 mItem.setSymbol( s.get() );
495 if (
auto *lModel =
model() )
496 lModel->legendMapViewData( &mupp, &dpi, &scale );
502 auto context = std::make_unique<QgsRenderContext>( );
503 context->setScaleFactor( dpi / 25.4 );
504 context->setRendererScale( scale );
510 if (
model() && !
model()->targetScreenProperties().isEmpty() )
517 context->setExpressionContext( expContext );
519 return context.release();
522void QgsLayerTreeModelLegendNode::checkAll(
bool state )
526 if ( !vlayer->renderer() )
530 for (
const auto &item : symbolList )
532 vlayer->renderer()->checkLegendSymbolItem( item.ruleKey(), state );
536 vlayer->emitStyleChanged();
537 vlayer->triggerRepaint();
539 else if ( QgsPointCloudLayer *pclayer = qobject_cast<QgsPointCloudLayer *>(
mLayerNode->layer() ) )
541 if ( !pclayer->renderer() )
544 const QStringList ruleKeys = pclayer->renderer()->legendRuleKeys();
545 for (
const QString &rule : ruleKeys )
547 pclayer->renderer()->checkLegendItem( rule, state );
551 pclayer->emitStyleChanged();
552 pclayer->triggerRepaint();
558 if ( role == Qt::DisplayRole )
562 else if ( role == Qt::EditRole )
566 else if ( role == Qt::DecorationRole )
568 if ( mPixmap.isNull() )
573 if ( mItem.symbol() )
583 if ( !mTextOnSymbolLabel.isEmpty() && context )
585 QPainter painter( &mPixmap );
586 painter.setRenderHint( QPainter::Antialiasing );
587 context->setPainter( &painter );
588 bool isNullSize =
false;
589 const QFontMetricsF fm( mTextOnSymbolTextFormat.scaledFont( *context, 1.0, &isNullSize ) );
592 const qreal yBaselineVCenter = ( mIconSize.height() + fm.ascent() - fm.descent() ) / 2;
594 QStringList() << mTextOnSymbolLabel, *context, mTextOnSymbolTextFormat );
601 mPixmap.fill( Qt::transparent );
606 else if ( role == Qt::CheckStateRole )
608 if ( !mItem.isCheckable() )
613 if ( !vlayer->renderer() )
616 return vlayer->renderer()->legendSymbolItemChecked( mItem.ruleKey() ) ? Qt::Checked : Qt::Unchecked;
621 return mItem.ruleKey();
625 return mItem.parentRuleKey();
637 if ( role != Qt::CheckStateRole )
640 if ( !mItem.isCheckable() )
644 if ( !vlayer || !vlayer->
renderer() )
650 project->setDirty(
true );
662 QgsSymbol *s = mCustomSymbol ? mCustomSymbol.get() : mItem.symbol();
670 std::unique_ptr< QgsRenderContext > tempRenderContext;
676 tempRenderContext = std::make_unique< QgsRenderContext >();
679 tempRenderContext->setScaleFactor( settings.
dpi() / 25.4 );
680 tempRenderContext->setRendererScale( settings.
mapScale() );
685 tempRenderContext->setPainter( ctx ? ctx->
painter :
nullptr );
690 tempRenderContext->setExpressionContext( expContext );
691 context = tempRenderContext.get();
695 const bool hasFixedWidth = ctx && ctx->
patchSize.width() > 0;
696 const bool hasFixedHeight = ctx && ctx->
patchSize.height() > 0;
697 const double desiredHeight = hasFixedHeight ? ctx->
patchSize.height() : settings.
symbolSize().height();
698 const double desiredWidth = hasFixedWidth ? ctx->
patchSize.width() : settings.
symbolSize().width();
699 double height = desiredHeight;
700 double width = desiredWidth;
703 double widthOffset = 0;
704 double heightOffset = 0;
711 const double size = markerSymbol->size( *context ) / context->
scaleFactor();
714 if ( !hasFixedHeight )
716 if ( !hasFixedWidth )
721 bool restrictedSizeSymbolOK;
722 double restrictedSymbolWidth = width;
723 double restrictedSymbolHeight = height;
724 const std::unique_ptr<QgsSymbol> minMaxSizeSymbol(
QgsSymbolLayerUtils::restrictedSizeSymbol( s, minSymbolSize, maxSymbolSize, context, restrictedSymbolWidth, restrictedSymbolHeight, &restrictedSizeSymbolOK ) );
725 if ( minMaxSizeSymbol )
727 s = minMaxSizeSymbol.get();
728 if ( !hasFixedHeight )
729 height = restrictedSymbolHeight;
730 if ( !hasFixedWidth )
731 width = restrictedSymbolWidth;
736 if ( width < desiredWidth )
738 widthOffset = ( desiredWidth - width ) / 2.0;
740 if ( height < desiredHeight )
742 heightOffset = ( desiredHeight - height ) / 2.0;
747 const double currentYCoord = ctx->
top + ( itemHeight - desiredHeight ) / 2;
755 opacity =
static_cast<int >( std::round( 255 * layer->opacity() ) );
764 p->translate( ctx->
columnLeft + widthOffset, currentYCoord + heightOffset );
767 p->translate( ctx->
columnRight - widthOffset - width, currentYCoord + heightOffset );
771 p->scale( 1.0 / dotsPerMM, 1.0 / dotsPerMM );
777 if ( opacity != 255 && !forceVector )
784 const QSize symbolSize(
static_cast< int >( std::round( width * dotsPerMM ) ),
static_cast<int >( std::round( height * dotsPerMM ) ) );
785 const QSize tempImageSize( symbolSize.width() + maxBleed * 2, symbolSize.height() + maxBleed * 2 );
786 QImage tempImage = QImage( tempImageSize, QImage::Format_ARGB32 );
787 tempImage.fill( Qt::transparent );
788 QPainter imagePainter( &tempImage );
792 imagePainter.translate( maxBleed, maxBleed );
794 imagePainter.translate( -maxBleed, -maxBleed );
797 imagePainter.setCompositionMode( QPainter::CompositionMode_DestinationIn );
798 imagePainter.fillRect( tempImage.rect(), QColor( 0, 0, 0, opacity ) );
801 p->drawImage( -maxBleed, -maxBleed, tempImage );
803 else if ( !restrictedSizeSymbolOK )
808 const QSize symbolSize(
static_cast< int >( std::round( width * dotsPerMM ) ),
static_cast<int >( std::round( height * dotsPerMM ) ) );
809 const QSize maxSize( symbolSize.width() + maxBleed * 2, symbolSize.height() + maxBleed * 2 );
811 p->setClipRect( -maxBleed, -maxBleed, maxSize.width(), maxSize.height(), Qt::IntersectClip );
817 s->
drawPreviewIcon( p, QSize(
static_cast< int >( std::round( width * dotsPerMM ) ),
static_cast< int >( std::round( height * dotsPerMM ) ) ), context,
false,
nullptr, &
patchShape, ctx->
screenProperties );
820 if ( !mTextOnSymbolLabel.isEmpty() )
822 bool isNullSize =
false;
823 const QFontMetricsF fm( mTextOnSymbolTextFormat.scaledFont( *context, 1.0, &isNullSize ) );
826 const qreal yBaselineVCenter = ( height * dotsPerMM + fm.ascent() - fm.descent() ) / 2;
828 QStringList() << mTextOnSymbolLabel, *context, mTextOnSymbolTextFormat );
833 return QSizeF( std::max( width + 2 * widthOffset,
static_cast< double >( desiredWidth ) ),
834 std::max( height + 2 * heightOffset,
static_cast< double >( desiredHeight ) ) );
840 if ( mItem.scaleMaxDenom() > 0 )
842 json[ QStringLiteral(
"scaleMaxDenom" ) ] = mItem.scaleMaxDenom();
844 if ( mItem.scaleMinDenom() > 0 )
846 json[ QStringLiteral(
"scaleMinDenom" ) ] = mItem.scaleMinDenom();
849 const QgsSymbol *s = mCustomSymbol ? mCustomSymbol.get() : mItem.symbol();
874 QImage img( pix.toImage().convertToFormat( QImage::Format_ARGB32_Premultiplied ) );
878 opacity = ( 255 * layer->opacity() );
880 if ( opacity != 255 )
883 painter.begin( &img );
884 painter.setCompositionMode( QPainter::CompositionMode_DestinationIn );
885 painter.fillRect( pix.rect(), QColor( 0, 0, 0, opacity ) );
889 QByteArray byteArray;
890 QBuffer buffer( &byteArray );
891 img.save( &buffer,
"PNG" );
892 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
894 json[ QStringLiteral(
"icon" ) ] = base64;
907 if ( mSymbolUsesMapUnits )
916 if ( mIconSize == sz )
924void QgsSymbolLegendNode::updateLabel()
936 if ( showFeatureCount && vl )
942 mLabel += QStringLiteral(
" [%1%2]" ).arg(
943 estimatedCount ? QStringLiteral(
"≈" ) : QString(),
944 count != -1 ? QLocale().toString( count ) : tr(
"N/A" ) );
964 if ( label.isEmpty() )
967 if ( !
mLayerNode->labelExpression().isEmpty() )
969 else if ( symLabel.contains(
"[%" ) )
976 if ( !
mLayerNode->labelExpression().isEmpty() )
978 else if ( label.contains(
"[%" ) )
1013 if ( role == Qt::DisplayRole || role == Qt::EditRole )
1015 else if ( role == Qt::DecorationRole )
1036 if ( role == Qt::DecorationRole )
1038 return QPixmap::fromImage( mImage );
1040 else if ( role == Qt::SizeHintRole )
1042 return mImage.size();
1053 Q_UNUSED( itemHeight )
1059 const double imgWidth = settings.
wmsLegendSize().width() * scaleFactor;
1060 const double imgHeight = settings.
wmsLegendSize().height() * scaleFactor;
1062 const QImage scaledImg = mImage.scaled( QSizeF( imgWidth, imgHeight ).toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation );
1067 ctx->
painter->drawImage( QPointF( ctx->
columnLeft * scaleFactor, ctx->
top * scaleFactor ), scaledImg );
1070 case Qt::AlignRight:
1071 ctx->
painter->drawImage( QPointF( ctx->
columnRight * scaleFactor - imgWidth, ctx->
top * scaleFactor ), scaledImg );
1080 QByteArray byteArray;
1081 QBuffer buffer( &byteArray );
1082 mImage.save( &buffer,
"PNG" );
1083 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
1086 json[ QStringLiteral(
"icon" ) ] = base64;
1098 , mParentRuleKey( parentRuleKey )
1105 return Qt::ItemIsEnabled | Qt::ItemIsUserCheckable | Qt::ItemIsSelectable;
1107 return Qt::ItemIsEnabled | Qt::ItemIsSelectable;
1114 case Qt::DecorationRole:
1117 QPixmap pix( iconSize, iconSize );
1119 return QIcon( pix );
1122 case Qt::DisplayRole:
1133 return mParentRuleKey;
1135 case Qt::CheckStateRole:
1142 if ( !pclayer->renderer() )
1145 return pclayer->renderer()->legendItemChecked( mRuleKey ) ? Qt::Checked : Qt::Unchecked;
1158 if ( role != Qt::CheckStateRole )
1166 if ( !pclayer->renderer() )
1169 pclayer->renderer()->checkLegendItem( mRuleKey, value == Qt::Checked );
1172 pclayer->emitStyleChanged();
1174 pclayer->triggerRepaint();
1175 if ( pclayer->sync3DRendererTo2DRenderer() )
1176 pclayer->convertRenderer3DFromRenderer2D();
1195 if ( ctx->
patchSize.width() < size.width() )
1196 offsetX = ( size.width() - ctx->
patchSize.width() ) / 2.0;
1197 size.setWidth( ctx->
patchSize.width() );
1201 size.setHeight( ctx->
patchSize.height() );
1207 QColor itemColor = mColor;
1211 itemColor.setAlpha( rasterRenderer->opacity() * 255.0 );
1213 ctx->
painter->setBrush( itemColor );
1220 pen.setJoinStyle( Qt::MiterJoin );
1225 ctx->
painter->setPen( Qt::NoPen );
1232 ctx->
painter->drawRect( QRectF( ctx->
columnLeft + offsetX, ctx->
top + ( itemHeight - size.height() ) / 2,
1233 size.width(), size.height() ) );
1236 case Qt::AlignRight:
1237 ctx->
painter->drawRect( QRectF( ctx->
columnRight - size.width() - offsetX, ctx->
top + ( itemHeight - size.height() ) / 2,
1238 size.width(), size.height() ) );
1247 QImage img = QImage( settings.
symbolSize().toSize(), QImage::Format_ARGB32 );
1248 img.fill( Qt::transparent );
1250 QPainter painter( &img );
1251 painter.setRenderHint( QPainter::Antialiasing );
1253 QColor itemColor = mColor;
1257 itemColor.setAlpha( rasterRenderer->opacity() * 255.0 );
1259 painter.setBrush( itemColor );
1266 pen.setJoinStyle( Qt::MiterJoin );
1267 painter.setPen( pen );
1271 painter.setPen( Qt::NoPen );
1274 painter.drawRect( QRectF( 0, 0, settings.
symbolSize().width(), settings.
symbolSize().height() ) );
1276 QByteArray byteArray;
1277 QBuffer buffer( &byteArray );
1278 img.save( &buffer,
"PNG" );
1279 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
1282 json[ QStringLiteral(
"icon" ) ] = base64;
1295QImage QgsWmsLegendNode::getLegendGraphic(
bool synchronous )
const
1297 if ( ! mValid && ! mFetcher )
1304 if ( layer && layer->
isValid() )
1315 Q_ASSERT( ! mFetcher );
1327 connect( mFetcher.get(), &QObject::destroyed, &loop, &QEventLoop::quit );
1334 QgsDebugError( QStringLiteral(
"Failed to download legend graphics: layer is not valid." ) );
1343 if ( role == Qt::DecorationRole )
1345 return QPixmap::fromImage( getLegendGraphic() );
1347 else if ( role == Qt::SizeHintRole )
1349 return getLegendGraphic().size();
1360 Q_UNUSED( itemHeight )
1364 double px2mm = 1000. / image.dotsPerMeterX();
1365 double mmWidth = image.width() * px2mm;
1366 double mmHeight = image.height() * px2mm;
1368 QSize targetSize = QSize( mmWidth, mmHeight );
1371 double targetHeight = mmHeight * settings.
wmsLegendSize().width() / mmWidth;
1372 targetSize = QSize( settings.
wmsLegendSize().width(), targetHeight );
1376 double targetWidth = mmWidth * settings.
wmsLegendSize().height() / mmHeight;
1377 targetSize = QSize( targetWidth, settings.
wmsLegendSize().height() );
1382 QImage smoothImage = image.scaled( targetSize / px2mm, Qt::KeepAspectRatio, Qt::SmoothTransformation );
1391 targetSize.height() ),
1393 QRectF( QPointF( 0, 0 ), smoothImage.size() ) );
1396 case Qt::AlignRight:
1400 targetSize.height() ),
1402 QRectF( QPointF( 0, 0 ), smoothImage.size() ) );
1411 QByteArray byteArray;
1412 QBuffer buffer( &byteArray );
1413 mImage.save( &buffer,
"PNG" );
1414 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
1417 json[ QStringLiteral(
"icon" ) ] = base64;
1421QImage QgsWmsLegendNode::renderMessage(
const QString &msg )
const
1423 const int fontHeight = 10;
1424 const int margin = fontHeight / 2;
1425 const int nlines = 1;
1427 const int w = 512, h = fontHeight * nlines + margin * ( nlines + 1 );
1428 QImage image( w, h, QImage::Format_ARGB32_Premultiplied );
1430 painter.begin( &image );
1431 painter.setPen( QColor( 255, 0, 0 ) );
1432 painter.setFont( QFont( QStringLiteral(
"Chicago" ), fontHeight ) );
1433 painter.fillRect( 0, 0, w, h, QColor( 255, 255, 255 ) );
1434 painter.drawText( 0, margin + fontHeight, msg );
1441void QgsWmsLegendNode::getLegendGraphicProgress( qint64 cur, qint64 tot )
1443 const QString msg = tot > 0 ? tr(
"Downloading: %1% (%2)" ).arg(
static_cast< int >( std::round( 100 * cur / tot ) ) ).arg(
QgsFileUtils::representFileSize( tot ) )
1445 mImage = renderMessage( msg );
1449void QgsWmsLegendNode::getLegendGraphicErrored(
const QString & )
1462void QgsWmsLegendNode::getLegendGraphicFinished(
const QImage &image )
1467 if ( ! image.isNull() )
1469 if ( image != mImage )
1489 return getLegendGraphic(
true );
1507 if ( role == Qt::DecorationRole )
1510 return QPixmap::fromImage( mImage );
1512 else if ( role == Qt::SizeHintRole )
1515 return mImage.size();
1528 std::unique_ptr< QgsRenderContext > tempRenderContext;
1533 tempRenderContext = std::make_unique< QgsRenderContext >();
1536 tempRenderContext->setScaleFactor( settings.
dpi() / 25.4 );
1537 tempRenderContext->setRendererScale( settings.
mapScale() );
1539 tempRenderContext->setMapToPixel(
QgsMapToPixel( 1 / ( settings.
mmPerMapUnit() * tempRenderContext->scaleFactor() ) ) );
1540 tempRenderContext->setForceVectorOutput(
true );
1541 tempRenderContext->setPainter( ctx.
painter );
1548 tempRenderContext->setExpressionContext( expContext );
1549 context = tempRenderContext.get();
1566 double labelXOffset;
1570 context->
painter()->restore();
1579void QgsDataDefinedSizeLegendNode::cacheImage()
const
1581 if ( mImage.isNull() )
1586 context = std::make_unique<QgsRenderContext>( );
1587 Q_ASSERT( context );
1588 context->setScaleFactor( 96 / 25.4 );
1590 mImage = mSettings->collapsedLegendImage( *context );
1604 if ( role == Qt::DisplayRole )
1608 if ( role == Qt::DecorationRole )
1618 Q_UNUSED( itemHeight );
1621 return QSizeF( 0, 0 );
1625 if ( renderContext )
1630 return QSizeF( 0, 0 );
1635 const QStringList textLines( mLabelSettings.
legendString() );
1638 double textWidth, textHeight;
1639 textWidthHeight( textWidth, textHeight, ctx, textFormat, textLines );
1642 const QPointF textPos( renderContext.
scaleFactor() * ( xOffset + settings.
symbolSize().width() / 2.0 - textWidth / 2.0 ), renderContext.
scaleFactor() * ( yOffset + settings.
symbolSize().height() / 2.0 + textHeight / 2.0 ) );
1647 const double symbolWidth = std::max( textWidth, settings.
symbolSize().width() );
1648 const double symbolHeight = std::max( textHeight, settings.
symbolSize().height() );
1649 return QSizeF( symbolWidth, symbolHeight );
1654 Q_UNUSED( settings );
1656 const double mmToPixel = 96.0 / 25.4;
1658 const QStringList textLines( mLabelSettings.legendString() );
1663 double textWidth, textHeight;
1664 textWidthHeight( textWidth, textHeight, ctx, textFormat, textLines );
1667 QByteArray byteArray;
1668 QBuffer buffer( &byteArray );
1669 previewPixmap.save( &buffer,
"PNG" );
1670 const QString base64 = QString::fromLatin1( byteArray.toBase64().data() );
1673 json[ QStringLiteral(
"icon" ) ] = base64;
1677void QgsVectorLabelLegendNode::textWidthHeight(
double &width,
double &height,
QgsRenderContext &ctx,
const QgsTextFormat &textFormat,
const QStringList &textLines )
const
@ PreferVector
Prefer vector-based rendering, when the result will still be visually near-identical to a raster-base...
@ ForceVector
Always force vector-based rendering, even when the result will be visually different to a raster-base...
@ Symbol
Symbol icon (excluding label).
@ SymbolLabel
Symbol label (excluding icon).
@ Point
Text at point of origin layout mode.
@ RectangleCapHeightBased
Similar to Rectangle mode, but uses cap height only when calculating font heights for the first line ...
@ Horizontal
Horizontally oriented text.
@ Millimeters
Millimeters.
@ RenderSymbolPreview
The render is for a symbol preview only and map based properties may not be available,...
@ RenderLayerTree
The render is for a layer tree display where map based properties are not available and where avoidan...
@ LosslessImageRendering
Render images losslessly whenever possible, instead of the default lossy jpeg rendering used for some...
@ Antialiasing
Use antialiasing while drawing.
TextHorizontalAlignment
Text horizontal alignment.
@ WrapLines
Automatically wrap long lines of text.
QgsDataDefinedSizeLegendNode(QgsLayerTreeLayer *nodeLayer, const QgsDataDefinedSizeLegend &settings, QObject *parent=nullptr)
Construct the node using QgsDataDefinedSizeLegend as definition of the node's appearance.
ItemMetrics draw(const QgsLegendSettings &settings, ItemContext &ctx) override
Entry point called from QgsLegendRenderer to do the rendering.
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
~QgsDataDefinedSizeLegendNode() override
Object that keeps configuration of appearance of marker symbol's data-defined size in legend.
void setFont(const QFont &font)
Sets font used for rendering of labels - only valid for collapsed legend.
void setTextColor(const QColor &color)
Sets text color for rendering of labels - only valid for collapsed legend.
void drawCollapsedLegend(QgsRenderContext &context, QSizeF *outputSize SIP_OUT=nullptr, double *labelXOffset SIP_OUT=nullptr) const
Draw the legend if using LegendOneNodeForAll and optionally output size of the legend and x offset of...
virtual QString dataSourceUri(bool expandAuthConfig=false) const
Gets the data source specification.
Stores the component parts of a data source URI (e.g.
bool useEstimatedMetadata() const
Returns true if estimated metadata should be used for the connection.
Single scope for storing variables and functions for use within a QgsExpressionContext.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
static QList< QgsExpressionContextScope * > globalProjectLayerScopes(const QgsMapLayer *layer)
Creates a list of three scopes: global, layer's project and layer.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
void appendScope(QgsExpressionContextScope *scope)
Appends a scope to the end of the context.
void appendScopes(const QList< QgsExpressionContextScope * > &scopes)
Appends a list of scopes to the end of the context.
static QString replaceExpressionText(const QString &action, const QgsExpressionContext *context, const QgsDistanceArea *distanceArea=nullptr)
This function replaces each expression between [% and %] in the string with the result of its evaluat...
virtual void setLegendSymbolItem(const QString &key, QgsSymbol *symbol)
Sets the symbol to be used for a legend symbol item.
virtual void checkLegendSymbolItem(const QString &key, bool state=true)
Sets whether the legend symbology item with the specified ley should be checked.
static QString representFileSize(qint64 bytes)
Returns the human size from bytes.
void progress(qint64 received, qint64 total)
Emitted to report progress.
void error(const QString &msg)
Emitted when an error occurs.
void finish(const QImage &legend)
Emitted when the download completes.
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
QgsImageLegendNode(QgsLayerTreeLayer *nodeLayer, const QImage &img, QObject *parent=nullptr)
Constructor for QgsImageLegendNode.
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item.
QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const override
Adds a symbol in base64 string within a JSON object with the key "icon".
static QRect nonTransparentImageRect(const QImage &image, QSize minSize=QSize(), bool center=false)
Calculates the non-transparent region of an image.
Layer tree node points to a map layer.
QString labelExpression() const
Returns the expression member of the LayerTreeNode.
QgsMapLayer * layer() const
Returns the map layer associated with this node.
virtual QVariant data(int role) const =0
Returns data associated with the item. Must be implemented in derived class.
QJsonObject exportToJson(const QgsLegendSettings &settings, const QgsRenderContext &context)
Entry point called from QgsLegendRenderer to do the rendering in a JSON object.
@ SimpleLegend
Simple label with icon legend node type.
@ RasterSymbolLegend
Raster symbol legend node type.
@ ImageLegend
Raster image legend node type.
@ DataDefinedSizeLegend
Marker symbol legend node type.
@ WmsLegend
WMS legend node type.
@ SymbolLegend
Vector symbol legend node type.
void checkAllItems()
Checks all checkable items belonging to the same layer as this node.
@ ParentRuleKey
Rule key of the parent legend node - for legends with tree hierarchy (QString). Added in 2....
@ NodeType
Type of node. Added in 3.16.
@ RuleKey
Rule key of the node (QString).
void uncheckAllItems()
Unchecks all checkable items belonging to the same layer as this node.
QgsLayerTreeLayer * mLayerNode
QgsLayerTreeModelLegendNode(QgsLayerTreeLayer *nodeL, QObject *parent=nullptr)
Construct the node with pointer to its parent layer node.
virtual void setUserPatchSize(QSizeF size)
Sets the user (overridden) size for the legend node.
void sizeChanged()
Emitted when the size of this node changes.
virtual ItemMetrics draw(const QgsLegendSettings &settings, ItemContext &ctx)
Entry point called from QgsLegendRenderer to do the rendering.
void dataChanged()
Emitted on internal data change so the layer tree model can forward the signal to views.
QgsRenderContext * createTemporaryRenderContext() const
Returns a temporary context or nullptr if legendMapViewData are not valid.
virtual QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const
Adds a symbol in base64 string within a JSON object with the key "icon".
QgsLayerTreeModel * model() const
Returns pointer to model owning this legend node.
void toggleAllItems()
Toggle all checkable items belonging to the same layer as this node.
QgsLegendPatchShape mPatchShape
virtual QSizeF userPatchSize() const
Returns the user (overridden) size for the legend node.
virtual Qt::ItemFlags flags() const
Returns item flags associated with the item. Default implementation returns Qt::ItemIsEnabled.
QgsLayerTreeLayer * layerNode() const
Returns pointer to the parent layer node.
virtual QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const
Draws symbol on the left side of the item.
virtual void setEmbeddedInParent(bool embedded)
virtual bool setData(const QVariant &value, int role)
Sets some data associated with the item. Default implementation does nothing and returns false.
virtual QSizeF drawSymbolText(const QgsLegendSettings &settings, ItemContext *ctx, QSizeF symbolSize) const
Draws label on the right side of the item.
A model representing the layer tree, including layers and groups of layers.
QSet< QgsScreenProperties > targetScreenProperties() const
Returns the target screen properties to use when generating icons.
static int scaleIconSize(int standardSize)
Scales an layer tree model icon size to compensate for display pixel density, making the icon size hi...
const QgsMapSettings * legendFilterMapSettings() const
Returns the current map settings used for the current legend filter (or nullptr if none is enabled).
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.
Represents a patch shape for use in map legends.
Stores the appearance and layout settings for legend drawing with QgsLegendRenderer.
bool drawRasterStroke() const
Returns whether a stroke will be drawn around raster symbol items.
QSizeF wmsLegendSize() const
Returns the size (in millimeters) of WMS legend graphics shown in the legend.
double minimumSymbolSize() const
Returns the minimum symbol size (in mm).
double autoWrapLinesAfter() const
Returns the maximum line length (in millimeters) allowed before lines of text in the legend will be a...
double rasterStrokeWidth() const
Returns the stroke width (in millimeters) for the stroke drawn around raster symbol items.
QSizeF symbolSize() const
Returns the default symbol size (in millimeters) used for legend items.
double maximumSymbolSize() const
Returns the maximum symbol size (in mm).
QColor rasterStrokeColor() const
Returns the stroke color for the stroke drawn around raster symbol items.
Q_DECL_DEPRECATED bool useAdvancedEffects() const
QgsLegendStyle style(Qgis::LegendComponent s) const
Returns the style for a legend component.
Q_DECL_DEPRECATED int dpi() const
bool synchronousLegendRequests() const
Returns whether to request legend graphics synchronously.
Q_DECL_DEPRECATED double mmPerMapUnit() const
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...
Qt::AlignmentFlag symbolAlignment() const
Returns the alignment for placement of legend symbols.
Q_DECL_DEPRECATED double mapScale() const
Returns the legend map scale.
Qt::Alignment alignment() const
Returns the alignment for the legend component.
QgsTextFormat & textFormat()
Returns the text format used for rendering this legend component.
double margin(Side side) const
Returns the margin (in mm) for the specified side of the component.
Stores information about one class/rule of a vector layer renderer in a unified way that can be used ...
QString ruleKey() const
Returns unique identifier of the rule for identification of the item within renderer.
Base class for all map layer types.
void triggerRepaint(bool deferredUpdate=false)
Will advise the map canvas (and any other interested party) that this layer requires to be repainted.
void emitStyleChanged()
Triggers an emission of the styleChanged() signal.
QgsProject * project() const
Returns the parent project if this map layer is added to a project.
Contains configuration for rendering maps.
Perform transforms between map coordinates and device coordinates.
A marker symbol type, for rendering Point and MultiPoint geometries.
Contains settings for how a map layer will be labeled.
QString legendString() const
legendString
static QPixmap labelSettingsPreviewPixmap(const QgsPalLayerSettings &settings, QSize size, const QString &previewText=QString(), int padding=0, const QgsScreenProperties &screen=QgsScreenProperties())
Returns a pixmap preview for label settings.
const QgsTextFormat & format() const
Returns the label text formatting settings, e.g., font settings, buffer settings, etc.
Represents a map layer supporting display of point clouds.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Base class for raster data providers.
virtual QgsImageFetcher * getLegendGraphicFetcher(const QgsMapSettings *mapSettings)
Returns a new image downloader for the raster legend.
Represents a raster layer.
QgsRasterDataProvider * dataProvider() override
Returns the source data provider.
Raster renderer pipe that applies colors to a raster.
Qt::ItemFlags flags() const override
Returns item flags associated with the item. Default implementation returns Qt::ItemIsEnabled.
bool setData(const QVariant &value, int role) override
Sets some data associated with the item. Default implementation does nothing and returns false.
QString ruleKey() const
Returns the unique identifier of node for identification of the item within renderer.
QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const override
Adds a symbol in base64 string within a JSON object with the key "icon".
QgsRasterSymbolLegendNode(QgsLayerTreeLayer *nodeLayer, const QColor &color, const QString &label, QObject *parent=nullptr, bool isCheckable=false, const QString &ruleKey=QString(), const QString &parentRuleKey=QString())
Constructor for QgsRasterSymbolLegendNode.
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
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.
Contains information about the context of a rendering operation.
Q_DECL_DEPRECATED void setForceVectorOutput(bool force)
Sets whether rendering operations should use vector operations instead of any faster raster shortcuts...
double scaleFactor() const
Returns the scaling factor for the render to convert painter units to physical sizes.
void setScaleFactor(double factor)
Sets the scaling factor for the render to convert painter units to physical sizes.
double convertToPainterUnits(double size, Qgis::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale(), Qgis::RenderSubcomponentProperty property=Qgis::RenderSubcomponentProperty::Generic) const
Converts a size from the specified units to painter units (pixels).
QPainter * painter()
Returns the destination QPainter for the render operation.
void setPainterFlagsUsingContext(QPainter *painter=nullptr) const
Sets relevant flags on a destination painter, using the flags and settings currently defined for the ...
QgsExpressionContext & expressionContext()
Gets the expression context.
void setFlag(Qgis::RenderContextFlag flag, bool on=true)
Enable or disable a particular flag (other flags are not affected).
void setMapToPixel(const QgsMapToPixel &mtp)
Sets the context's map to pixel transform, which transforms between map coordinates and device coordi...
Qgis::RasterizedRenderingPolicy rasterizedRenderingPolicy() const
Returns the policy controlling when rasterisation of content during renders is permitted.
void setPainter(QPainter *p)
Sets the destination QPainter for the render operation.
static QgsRenderContext fromQPainter(QPainter *painter)
Creates a default render context given a pixel based QPainter destination.
void setExpressionContext(const QgsExpressionContext &context)
Sets the expression context.
void setRendererScale(double scale)
Sets the renderer map scale.
Qgis::RenderContextFlags flags() const
Returns combination of flags used for rendering.
Scoped object for saving and restoring a QPainter object's state.
Scoped object for temporary scaling of a QgsRenderContext for pixel based rendering.
Stores properties relating to a screen.
double devicePixelRatio() const
Returns the ratio between physical pixels and device-independent pixels for the screen.
Stores settings for use within QGIS.
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), Section section=NoSection) const
Returns the value for setting key.
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
QgsSimpleLegendNode(QgsLayerTreeLayer *nodeLayer, const QString &label, const QIcon &icon=QIcon(), QObject *parent=nullptr, const QString &key=QString())
Constructor for QgsSimpleLegendNode.
static std::unique_ptr< QgsSymbol > restrictedSizeSymbol(const QgsSymbol *s, double minSize, double maxSize, QgsRenderContext *context, double &width, double &height, bool *ok=nullptr)
Creates a new symbol with size restricted to min/max size if original size is out of min/max range.
static QPixmap symbolPreviewPixmap(const QgsSymbol *symbol, QSize size, int padding=0, QgsRenderContext *customContext=nullptr, bool selected=false, const QgsExpressionContext *expressionContext=nullptr, const QgsLegendPatchShape *shape=nullptr, const QgsScreenProperties &screen=QgsScreenProperties())
Returns a pixmap preview for a color ramp.
static double estimateMaxSymbolBleed(QgsSymbol *symbol, const QgsRenderContext &context)
Returns the maximum estimated bleed for the symbol.
static double MAXIMUM_SIZE
QString evaluateLabel(const QgsExpressionContext &context=QgsExpressionContext(), const QString &label=QString())
Evaluates and returns the text label of the current node.
const QgsSymbol * symbol() const
Returns the symbol used by the legend node.
void setPatchShape(const QgsLegendPatchShape &shape)
Sets the symbol patch shape to use when rendering the legend node symbol.
QgsSymbolLegendNode(QgsLayerTreeLayer *nodeLayer, const QgsLegendSymbolItem &item, QObject *parent=nullptr)
Constructor for QgsSymbolLegendNode.
void setIconSize(QSize sz)
Set the icon size.
QgsExpressionContextScope * createSymbolScope() const
Create an expression context scope containing symbol related variables.
QgsLegendPatchShape patchShape() const
Returns the symbol patch shape to use when rendering the legend node symbol.
QSize minimumIconSize() const
Calculates the minimum icon size to prevent cropping.
~QgsSymbolLegendNode() override
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item.
void invalidateMapBasedData() override
Notification from model that information from associated map view has changed.
bool setData(const QVariant &value, int role) override
Sets some data associated with the item. Default implementation does nothing and returns false.
Qt::ItemFlags flags() const override
Returns item flags associated with the item. Default implementation returns Qt::ItemIsEnabled.
void setCustomSymbol(QgsSymbol *symbol)
Sets the node's custom symbol.
void setEmbeddedInParent(bool embedded) override
QgsSymbol * customSymbol() const
Returns the node's custom symbol.
QString symbolLabel() const
Label of the symbol, user defined label will be used, otherwise will default to the label made by QGI...
void setSymbol(QgsSymbol *symbol)
Sets the symbol to be used by the legend node.
static double MINIMUM_SIZE
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const override
Adds a symbol in base64 string within a JSON object with the key "icon".
Abstract base class for all rendered symbols.
void drawPreviewIcon(QPainter *painter, QSize size, QgsRenderContext *customContext=nullptr, bool selected=false, const QgsExpressionContext *expressionContext=nullptr, const QgsLegendPatchShape *patchShape=nullptr, const QgsScreenProperties &screen=QgsScreenProperties())
Draws an icon of the symbol that occupies an area given by size using the specified painter.
Qgis::SymbolType type() const
Returns the symbol's type.
Contains pre-calculated metrics of a QgsTextDocument.
QSizeF documentSize(Qgis::TextLayoutMode mode, Qgis::TextOrientation orientation) const
Returns the overall size of the document.
double firstLineCapHeight() const
Returns the cap height for the first line of text.
static QgsTextDocumentMetrics calculateMetrics(const QgsTextDocument &document, const QgsTextFormat &format, const QgsRenderContext &context, double scaleFactor=1.0, const QgsTextDocumentRenderContext &documentContext=QgsTextDocumentRenderContext())
Returns precalculated text metrics for a text document, when rendered using the given base format and...
const QgsTextDocument & document() const
Returns the document associated with the calculated metrics.
Encapsulates the context in which a text document is to be rendered.
void setFlags(Qgis::TextRendererFlags flags)
Sets associated text renderer flags.
void setMaximumWidth(double width)
Sets the maximum width (in painter units) for rendered text.
Represents a document consisting of one or more QgsTextBlock objects.
static QgsTextDocument fromTextAndFormat(const QStringList &lines, const QgsTextFormat &format)
Constructor for QgsTextDocument consisting of a set of lines, respecting settings from a text format.
Container for all settings relating to text rendering.
QFont toQFont() const
Returns a QFont matching the relevant settings from this text format.
QColor color() const
Returns the color that text will be rendered in.
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.
static void drawDocument(const QRectF &rect, const QgsTextFormat &format, const QgsTextDocument &document, const QgsTextDocumentMetrics &metrics, QgsRenderContext &context, Qgis::TextHorizontalAlignment horizontalAlignment=Qgis::TextHorizontalAlignment::Left, Qgis::TextVerticalAlignment verticalAlignment=Qgis::TextVerticalAlignment::Top, double rotation=0, Qgis::TextLayoutMode mode=Qgis::TextLayoutMode::Rectangle, Qgis::TextRendererFlags flags=Qgis::TextRendererFlags())
Draws a text document within a rectangle using the specified settings.
static void drawText(const QRectF &rect, double rotation, Qgis::TextHorizontalAlignment alignment, const QStringList &textLines, QgsRenderContext &context, const QgsTextFormat &format, bool drawAsOutlines=true, Qgis::TextVerticalAlignment vAlignment=Qgis::TextVerticalAlignment::Top, Qgis::TextRendererFlags flags=Qgis::TextRendererFlags(), Qgis::TextLayoutMode mode=Qgis::TextLayoutMode::Rectangle)
Draws text within a rectangle using the specified settings.
static QFontMetricsF fontMetrics(QgsRenderContext &context, const QgsTextFormat &format, double scaleFactor=1.0)
Returns the font metrics for the given text format, when rendered in the specified render context.
static double calculateScaleFactorForFormat(const QgsRenderContext &context, const QgsTextFormat &format)
Returns the scale factor used for upscaling font sizes and downscaling destination painter devices.
static double textHeight(const QgsRenderContext &context, const QgsTextFormat &format, const QStringList &textLines, Qgis::TextLayoutMode mode=Qgis::TextLayoutMode::Point, QFontMetricsF *fontMetrics=nullptr, Qgis::TextRendererFlags flags=Qgis::TextRendererFlags(), double maxLineWidth=0)
Returns the height of a text based on a given format.
static bool isNull(const QVariant &variant, bool silenceNullWarnings=false)
Returns true if the specified variant should be considered a NULL value.
QgsVectorLabelLegendNode(QgsLayerTreeLayer *nodeLayer, const QgsPalLayerSettings &labelSettings, QObject *parent=nullptr)
QgsVectorLabelLegendNode.
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
drawSymbol
QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const override
exportSymbolToJson
~QgsVectorLabelLegendNode() override
QVariant data(int role) const override
data Returns data associated with the item
Represents a vector layer which manages a vector based dataset.
long long featureCount(const QString &legendKey) const
Number of features rendered with specified legend key.
void symbolFeatureCountMapChanged()
Emitted when the feature count for symbols on this layer has been recalculated.
QgsExpressionContextScope * createExpressionContextScope() const final
This method needs to be reimplemented in all classes which implement this interface and return an exp...
QgsFeatureRenderer * renderer()
Returns the feature renderer used for rendering the features in the layer in 2D map views.
QgsVectorDataProvider * dataProvider() final
Returns the layer's data provider, it may be nullptr.
QImage getLegendGraphicBlocking() const
Fetches the image from the server and returns it.
QSizeF drawSymbol(const QgsLegendSettings &settings, ItemContext *ctx, double itemHeight) const override
Draws symbol on the left side of the item.
void invalidateMapBasedData() override
Notification from model that information from associated map view has changed.
QVariant data(int role) const override
Returns data associated with the item. Must be implemented in derived class.
~QgsWmsLegendNode() override
QgsWmsLegendNode(QgsLayerTreeLayer *nodeLayer, QObject *parent=nullptr)
Constructor for QgsWmsLegendNode.
QJsonObject exportSymbolToJson(const QgsLegendSettings &settings, const QgsRenderContext &context) const override
Adds a symbol in base64 string within a JSON object with the key "icon".
#define Q_NOWARN_DEPRECATED_POP
#define Q_NOWARN_DEPRECATED_PUSH
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference).
QList< QgsLegendSymbolItem > QgsLegendSymbolList
#define QgsDebugError(str)
Single variable definition for use within a QgsExpressionContextScope.
QPainter * painter
Painter.
double top
Top y-position of legend item.
QgsLegendPatchShape patchShape
The patch shape to render for the node.
QgsScreenProperties screenProperties
Destination screen properties.
double maxSiblingSymbolWidth
Largest symbol width, considering all other sibling legend components associated with the current com...
QSizeF patchSize
Symbol patch size to render for the node.
const QgsTextDocument * textDocument
Optional text document.
double columnLeft
Left side of current legend column.
const QgsTextDocumentMetrics * textDocumentMetrics
Optional text document metrics.
double columnRight
Right side of current legend column.
Q_NOWARN_DEPRECATED_POP QgsRenderContext * context
Render context, if available.