20 #include <QSvgGenerator>
69 for (
int i = 0; i <
mLayers.count(); i++ )
75 else if ( !
mLayers.at( i )->isCompatibleWithSymbol(
this ) )
87 return _getLineString3d( context, curve, clipToExtent );
89 return _getLineString2d( context, curve, clipToExtent );
94 const unsigned int nPoints = curve.
numPoints();
98 QVector< double > pointsX;
99 QVector< double > pointsY;
100 QVector< double > pointsZ;
106 const double cw = e.
width() / 10;
107 const double ch = e.
height() / 10;
111 if (
const QgsLineString *ls = qgsgeometry_cast< const QgsLineString * >( &curve ) )
117 std::unique_ptr< QgsLineString > segmentized;
118 segmentized.reset( qgsgeometry_cast< QgsLineString * >( curve.
segmentize( ) ) );
119 lineString = segmentized.get();
127 if (
const QgsLineString *ls = qgsgeometry_cast<const QgsLineString *>( &curve ) )
129 pointsX = ls->xVector();
130 pointsY = ls->yVector();
131 pointsZ = ls->zVector();
135 std::unique_ptr< QgsLineString > segmentized;
136 segmentized.reset( qgsgeometry_cast< QgsLineString * >( curve.
segmentize( ) ) );
138 pointsX = segmentized->xVector();
139 pointsY = segmentized->yVector();
140 pointsZ = segmentized->zVector();
148 const int nVertices = pointsX.size();
152 ct.
transformCoords( nVertices, pointsX.data(), pointsY.data(), pointsZ.data(), Qgis::TransformDirection::Forward );
162 const int size = pointsX.size();
164 const double *xIn = pointsX.data();
165 const double *yIn = pointsY.data();
166 const double *zIn = pointsZ.data();
167 double *xOut = pointsX.data();
168 double *yOut = pointsY.data();
169 double *zOut = pointsZ.data();
171 for (
int i = 0; i < size; ++i )
173 if ( std::isfinite( *xIn ) && std::isfinite( *yIn ) && std::isfinite( *zIn ) )
187 pointsX.resize( outSize );
188 pointsY.resize( outSize );
189 pointsZ.resize( outSize );
196 const double cw = e.
width() / 10;
197 const double ch = e.
height() / 10;
200 QVector< double > tempX;
201 QVector< double > tempY;
202 QVector< double > tempZ;
209 const int polygonSize = pointsX.size();
210 QPolygonF out( polygonSize );
211 const double *x = pointsX.constData();
212 const double *y = pointsY.constData();
213 QPointF *dest = out.data();
214 for (
int i = 0; i < polygonSize; ++i )
216 double screenX = *x++;
217 double screenY = *y++;
219 *dest++ = QPointF( screenX, screenY );
227 const unsigned int nPoints = curve.
numPoints();
237 const double cw = e.
width() / 10;
238 const double ch = e.
height() / 10;
261 pts.erase( std::remove_if( pts.begin(), pts.end(),
262 [](
const QPointF point )
264 return !std::isfinite( point.x() ) || !std::isfinite( point.y() );
271 const double cw = e.
width() / 10;
272 const double ch = e.
height() / 10;
277 QPointF *ptr = pts.data();
278 for (
int i = 0; i < pts.size(); ++i, ++ptr )
290 return _getPolygonRing3d( context, curve, clipToExtent, isExteriorRing, correctRingOrientation );
292 return _getPolygonRing2d( context, curve, clipToExtent, isExteriorRing, correctRingOrientation );
295 QPolygonF QgsSymbol::_getPolygonRing3d(
QgsRenderContext &context,
const QgsCurve &curve,
const bool clipToExtent,
const bool isExteriorRing,
const bool correctRingOrientation )
300 QVector< double > pointsX;
301 QVector< double > pointsY;
302 QVector< double > pointsZ;
307 bool reverseRing =
false;
308 if ( correctRingOrientation )
321 const double cw = e.
width() / 10;
322 const double ch = e.
height() / 10;
326 if (
const QgsLineString *ls = qgsgeometry_cast< const QgsLineString * >( &curve ) )
332 std::unique_ptr< QgsLineString > segmentized;
333 segmentized.reset( qgsgeometry_cast< QgsLineString * >( curve.
segmentize( ) ) );
334 lineString = segmentized.get();
342 if (
const QgsLineString *ls = qgsgeometry_cast<const QgsLineString *>( &curve ) )
344 pointsX = ls->xVector();
345 pointsY = ls->yVector();
346 pointsZ = ls->zVector();
350 std::unique_ptr< QgsLineString > segmentized;
351 segmentized.reset( qgsgeometry_cast< QgsLineString * >( curve.
segmentize( ) ) );
353 pointsX = segmentized->xVector();
354 pointsY = segmentized->yVector();
355 pointsZ = segmentized->zVector();
361 std::reverse( pointsX.begin(), pointsX.end() );
362 std::reverse( pointsY.begin(), pointsY.end() );
363 std::reverse( pointsZ.begin(), pointsZ.end() );
369 const int nVertices = pointsX.size();
372 ct.
transformCoords( nVertices, pointsX.data(), pointsY.data(), pointsZ.data(), Qgis::TransformDirection::Forward );
382 const int size = pointsX.size();
384 const double *xIn = pointsX.data();
385 const double *yIn = pointsY.data();
386 const double *zIn = pointsZ.data();
387 double *xOut = pointsX.data();
388 double *yOut = pointsY.data();
389 double *zOut = pointsZ.data();
391 for (
int i = 0; i < size; ++i )
393 if ( std::isfinite( *xIn ) && std::isfinite( *yIn ) && std::isfinite( *zIn ) )
407 pointsX.resize( outSize );
408 pointsY.resize( outSize );
409 pointsZ.resize( outSize );
416 const double cw = e.
width() / 10;
417 const double ch = e.
height() / 10;
420 QVector< double > tempX;
421 QVector< double > tempY;
422 QVector< double > tempZ;
429 const int polygonSize = pointsX.size();
430 QPolygonF out( polygonSize );
431 const double *x = pointsX.constData();
432 const double *y = pointsY.constData();
433 QPointF *dest = out.data();
434 for (
int i = 0; i < polygonSize; ++i )
436 double screenX = *x++;
437 double screenY = *y++;
439 *dest++ = QPointF( screenX, screenY );
442 if ( !out.empty() && !out.isClosed() )
449 QPolygonF QgsSymbol::_getPolygonRing2d(
QgsRenderContext &context,
const QgsCurve &curve,
const bool clipToExtent,
const bool isExteriorRing,
const bool correctRingOrientation )
459 if ( correctRingOrientation )
463 std::reverse( poly.begin(), poly.end() );
465 std::reverse( poly.begin(), poly.end() );
472 const double cw = e.
width() / 10;
473 const double ch = e.
height() / 10;
492 poly.erase( std::remove_if( poly.begin(), poly.end(),
493 [](
const QPointF point )
495 return !std::isfinite( point.x() ) || !std::isfinite( point.y() );
502 const double cw = e.
width() / 10;
503 const double ch = e.
height() / 10;
508 QPointF *ptr = poly.data();
509 for (
int i = 0; i < poly.size(); ++i, ++ptr )
514 if ( !poly.empty() && !poly.isClosed() )
515 poly << poly.at( 0 );
526 holes.reserve( ringCount );
527 for (
int idx = 0; idx < ringCount; idx++ )
530 if ( !hole.isEmpty() )
531 holes.append( hole );
540 return QObject::tr(
"Marker" );
542 return QObject::tr(
"Line" );
544 return QObject::tr(
"Fill" );
546 return QObject::tr(
"Hybrid" );
570 QgsSymbol::initPropertyDefinitions();
571 return sPropertyDefinitions;
587 QgsSymbolLayerList::const_iterator it =
mLayers.constBegin();
591 for ( ; it !=
mLayers.constEnd(); ++it )
593 if ( ( *it )->outputUnit() != unit )
610 if (
layer->usesMapUnits() )
625 QgsSymbolLayerList::const_iterator it =
mLayers.constBegin();
626 if ( it ==
mLayers.constEnd() )
632 for ( ; it !=
mLayers.constEnd(); ++it )
634 if ( ( *it )->mapUnitScale() != scale )
644 const auto constMLayers =
mLayers;
647 layer->setOutputUnit( u );
653 const auto constMLayers =
mLayers;
656 layer->setMapUnitScale( scale );
677 std::unique_ptr< QgsSymbol > s;
701 s = std::make_unique< QgsMarkerSymbol >();
704 s = std::make_unique< QgsLineSymbol >();
707 s = std::make_unique< QgsFillSymbol >();
710 QgsDebugMsg( QStringLiteral(
"unknown layer's geometry type" ) );
739 if ( index < 0 || index >
mLayers.count() )
742 if ( !
layer || !
layer->isCompatibleWithSymbol(
this ) )
752 if ( !
layer || !
layer->isCompatibleWithSymbol(
this ) )
762 if ( index < 0 || index >=
mLayers.count() )
773 if ( index < 0 || index >=
mLayers.count() )
776 return mLayers.takeAt( index );
784 if ( oldLayer ==
layer )
787 if ( !
layer || !
layer->isCompatibleWithSymbol(
this ) )
798 Q_ASSERT_X( !mStarted,
"startRender",
"Rendering has already been started for this symbol instance!" );
811 const long long mapFrameNumber = context.
currentFrame();
812 double animationTimeSeconds = 0;
813 if ( mapFrameNumber >= 0 && context.
frameRate() > 0 )
816 animationTimeSeconds = mapFrameNumber / context.
frameRate();
821 animationTimeSeconds = QDateTime::currentMSecsSinceEpoch() / 1000.0;
825 scope->setVariable( QStringLiteral(
"symbol_frame" ), symbolFrame, true );
828 mSymbolRenderContext->setExpressionContextScope( scope.release() );
832 const auto constMLayers =
mLayers;
838 layer->prepareExpressions( symbolContext );
839 layer->prepareMasks( symbolContext );
840 layer->startRender( symbolContext );
846 Q_ASSERT_X( mStarted,
"startRender",
"startRender was not called for this symbol instance!" );
850 if ( mSymbolRenderContext )
852 const auto constMLayers =
mLayers;
858 layer->stopRender( *mSymbolRenderContext );
862 mSymbolRenderContext.reset(
nullptr );
871 const auto constMLayers =
mLayers;
874 if ( !
layer->isLocked() )
884 if ( !
layer->isLocked() )
886 const QColor layerColor =
layer->color();
887 if ( layerColor.isValid() )
891 return QColor( 0, 0, 0 );
897 std::unique_ptr< QgsRenderContext > tempContext;
901 context = tempContext.get();
931 if ( !customContext && expressionContext )
935 else if ( !customContext )
959 const QSizeF targetSize = QSizeF( size.width() - 1, size.height() - 1 );
967 std::unique_ptr< QgsEffectPainter > effectPainter;
968 if ( effect && effect->
enabled() )
969 effectPainter = std::make_unique< QgsEffectPainter >( symbolContext.
renderContext(), effect );
971 for (
const QList< QPolygonF > &poly : polys )
973 QVector< QPolygonF > rings;
974 rings.reserve( poly.size() );
975 for (
int i = 1; i < poly.size(); ++i )
976 rings << poly.at( i );
980 effectPainter.reset();
985 layer->drawPreviewIcon( symbolContext, size );
993 if ( format.compare( QLatin1String(
"svg" ), Qt::CaseInsensitive ) == 0 )
995 QSvgGenerator generator;
996 generator.setFileName( path );
997 generator.setSize( size );
998 generator.setViewBox( QRect( 0, 0, size.height(), size.height() ) );
1000 QPainter painter( &generator );
1006 QImage image =
asImage( size );
1013 QImage image( size, QImage::Format_ARGB32_Premultiplied );
1016 QPainter p( &image );
1017 p.setRenderHint( QPainter::Antialiasing );
1018 p.setRenderHint( QPainter::SmoothPixmapTransform );
1028 QImage preview( QSize( 100, 100 ), QImage::Format_ARGB32_Premultiplied );
1031 QPainter p( &preview );
1032 p.setRenderHint( QPainter::Antialiasing );
1033 p.translate( 0.5, 0.5 );
1037 p.setPen( QPen( Qt::gray ) );
1038 p.drawLine( 0, 50, 100, 50 );
1039 p.drawLine( 50, 0, 50, 100 );
1047 if ( expressionContext )
1056 poly << QPointF( 0, 50 ) << QPointF( 99, 50 );
1057 static_cast<QgsLineSymbol *
>( this )->renderPolyline( poly,
nullptr, context );
1062 polygon << QPointF( 20, 20 ) << QPointF( 80, 20 ) << QPointF( 80, 80 ) << QPointF( 20, 80 ) << QPointF( 20, 20 );
1063 static_cast<QgsFillSymbol *
>( this )->renderPolygon( polygon,
nullptr,
nullptr, context );
1067 static_cast<QgsMarkerSymbol *
>( this )->renderPoint( QPointF( 50, 50 ),
nullptr, context );
1085 t = QStringLiteral(
"MARKER" );
1088 t = QStringLiteral(
"LINE" );
1091 t = QStringLiteral(
"FILL" );
1094 Q_ASSERT(
false &&
"unknown symbol type" );
1098 for ( QgsSymbolLayerList::const_iterator it =
mLayers.begin(); it !=
mLayers.end(); ++it )
1107 props[ QStringLiteral(
"alpha" )] = QString::number(
opacity() );
1108 double scaleFactor = 1.0;
1112 for ( QgsSymbolLayerList::const_iterator it =
mLayers.begin(); it !=
mLayers.end(); ++it )
1114 ( *it )->toSld( doc, element, props );
1121 for ( QgsSymbolLayerList::const_iterator it =
mLayers.begin(); it !=
mLayers.end(); ++it )
1124 layer->setLocked( ( *it )->isLocked() );
1125 layer->setRenderingPass( ( *it )->renderingPass() );
1126 layer->setEnabled( ( *it )->enabled() );
1127 lst.append(
layer );
1142 if ( effect && effect->
enabled() )
1145 generatorLayer->
render( context, geometryType, points, rings );
1149 generatorLayer->
render( context, geometryType, points, rings );
1159 QgsSymbolLayerList::const_iterator sIt =
mLayers.constBegin();
1160 for ( ; sIt !=
mLayers.constEnd(); ++sIt )
1164 attributes.unite( ( *sIt )->usedAttributes( context ) );
1172 mDataDefinedProperties.
setProperty( key, property );
1182 if (
layer->hasDataDefinedProperties() )
1192 if (
layer->canCauseArtifactsBetweenAdjacentTiles() )
1217 class ExpressionContextScopePopper
1221 ExpressionContextScopePopper() =
default;
1223 ~ExpressionContextScopePopper()
1226 context->popScope();
1235 class GeometryRestorer
1239 : mContext( context ),
1240 mGeometry( context.geometry() )
1245 mContext.setGeometry( mGeometry );
1265 GeometryRestorer geomRestorer( context );
1267 bool usingSegmentizedGeometry =
false;
1275 if ( std::isfinite( boundsOrigin.x() ) && std::isfinite( boundsOrigin.y() ) )
1290 clippingEnabled =
false;
1301 clippingEnabled =
false;
1305 clippingEnabled =
false;
1308 mSymbolRenderContext->setGeometryPartNum( 1 );
1311 ExpressionContextScopePopper scopePopper;
1312 if ( mSymbolRenderContext->expressionContextScope() )
1314 if ( needsExpressionContext )
1340 QPointF renderPoint;
1341 const QgsPoint *originalGeometry =
nullptr;
1343 QVector< PointInfo > pointsToRender;
1347 QPolygonF renderLine;
1348 const QgsCurve *originalGeometry =
nullptr;
1350 QVector< LineInfo > linesToRender;
1354 QPolygonF renderExterior;
1355 QVector< QPolygonF > renderRings;
1357 int originalPartIndex = 0;
1359 QVector< PolygonInfo > polygonsToRender;
1362 getPartGeometry = [&pointsToRender, &linesToRender, &polygonsToRender, &getPartGeometry, &context, &clippingEnabled, &markers, &feature, &usingSegmentizedGeometry,
this](
const QgsAbstractGeometry * part,
int partIndex = 0 )
1373 const bool isMultiPart = qgsgeometry_cast< const QgsGeometryCollection * >( part ) && qgsgeometry_cast< const QgsGeometryCollection * >( part )->numGeometries() > 1;
1379 if ( needsSegmentizing )
1382 if ( !segmentizedPart )
1386 temporaryGeometryContainer.
set( segmentizedPart.release() );
1387 processedGeometry = temporaryGeometryContainer.
constGet();
1388 usingSegmentizedGeometry =
true;
1393 processedGeometry = part;
1403 std::unique_ptr< QgsAbstractGeometry > simplified( simplifier.
simplify( processedGeometry ) );
1406 temporaryGeometryContainer.
set( simplified.release() );
1407 processedGeometry = temporaryGeometryContainer.
constGet();
1422 temporaryGeometryContainer.
set( clippedGeom.release() );
1423 processedGeometry = temporaryGeometryContainer.
constGet();
1430 processedGeometry = part;
1433 if ( !processedGeometry )
1436 QgsDebugMsg( QStringLiteral(
"No processed geometry to render for part!" ) );
1446 QgsDebugMsgLevel( QStringLiteral(
"point can be drawn only with marker symbol!" ), 2 );
1451 info.originalGeometry = qgsgeometry_cast< const QgsPoint * >( part );
1452 info.renderPoint =
_getPoint( context, *info.originalGeometry );
1453 pointsToRender << info;
1461 QgsDebugMsgLevel( QStringLiteral(
"linestring can be drawn only with line symbol!" ), 2 );
1466 info.originalGeometry = qgsgeometry_cast<const QgsCurve *>( part );
1467 info.renderLine =
_getLineString( context, *qgsgeometry_cast<const QgsCurve *>( processedGeometry ), clippingEnabled );
1468 linesToRender << info;
1478 QgsDebugMsgLevel( QStringLiteral(
"polygon can be drawn only with fill symbol!" ), 2 );
1483 info.originalGeometry = qgsgeometry_cast<const QgsCurvePolygon *>( part );
1484 info.originalPartIndex = partIndex;
1485 if ( !qgsgeometry_cast<const QgsPolygon *>( processedGeometry )->exteriorRing() )
1487 QgsDebugMsg( QStringLiteral(
"cannot render polygon with no exterior ring" ) );
1491 _getPolygon( info.renderExterior, info.renderRings, context, *qgsgeometry_cast<const QgsPolygon *>( processedGeometry ), clippingEnabled,
mForceRHR );
1492 polygonsToRender << info;
1498 const QgsMultiPoint *mp = qgsgeometry_cast< const QgsMultiPoint * >( processedGeometry );
1506 const QgsGeometryCollection *geomCollection = qgsgeometry_cast<const QgsGeometryCollection *>( processedGeometry );
1509 for (
unsigned int i = 0; i < num; ++i )
1514 getPartGeometry( geomCollection->
geometryN( i ), i );
1524 QgsDebugMsgLevel( QStringLiteral(
"multi-polygon can be drawn only with fill symbol!" ), 2 );
1535 std::map<double, QList<unsigned int> > thisAreaToPartNum;
1536 for (
unsigned int i = 0; i < num; ++i )
1545 std::map<double, QList<unsigned int> >::const_reverse_iterator iter = thisAreaToPartNum.rbegin();
1546 for ( ; iter != thisAreaToPartNum.rend(); ++iter )
1548 const QList<unsigned int> &listPartIndex = iter->second;
1549 for (
int idx = 0; idx < listPartIndex.size(); ++idx )
1551 const unsigned i = listPartIndex[idx];
1552 getPartGeometry( geomCollection->
geometryN( i ), i );
1559 QgsDebugMsg( QStringLiteral(
"feature %1: unsupported wkb type %2/%3 for rendering" )
1560 .arg( feature.
id() )
1562 .arg( part->wkbType(), 0, 16 ) );
1572 std::vector< int > layers;
1575 layers.reserve(
mLayers.count() );
1576 for (
int i = 0; i <
mLayers.count(); ++i )
1577 layers.emplace_back( i );
1581 layers.emplace_back(
layer );
1586 if ( needsExpressionContext )
1589 for (
const int symbolLayerIndex : layers )
1595 if ( needsExpressionContext )
1604 int geometryPartNumber = 0;
1605 for (
const PointInfo &point : std::as_const( pointsToRender ) )
1610 mSymbolRenderContext->setGeometryPartNum( geometryPartNumber + 1 );
1611 if ( needsExpressionContext )
1614 static_cast<QgsMarkerSymbol *
>( this )->renderPoint( point.renderPoint, &feature, context, symbolLayerIndex, selected );
1615 geometryPartNumber++;
1623 if ( linesToRender.empty() )
1626 int geometryPartNumber = 0;
1627 for (
const LineInfo &line : std::as_const( linesToRender ) )
1632 mSymbolRenderContext->setGeometryPartNum( geometryPartNumber + 1 );
1633 if ( needsExpressionContext )
1637 static_cast<QgsLineSymbol *
>( this )->renderPolyline( line.renderLine, &feature, context, symbolLayerIndex, selected );
1638 geometryPartNumber++;
1645 for (
const PolygonInfo &info : std::as_const( polygonsToRender ) )
1650 mSymbolRenderContext->setGeometryPartNum( info.originalPartIndex + 1 );
1651 if ( needsExpressionContext )
1655 static_cast<QgsFillSymbol *
>( this )->renderPolygon( info.renderExterior, ( !info.renderRings.isEmpty() ? &info.renderRings : nullptr ), &feature, context, symbolLayerIndex, selected );
1673 markers.reserve( pointsToRender.size() );
1674 for (
const PointInfo &info : std::as_const( pointsToRender ) )
1678 const QRectF bounds =
static_cast<QgsMarkerSymbol *
>( this )->bounds( info.renderPoint, context, feature );
1687 context.
painter()->setPen( Qt::red );
1688 context.
painter()->setBrush( QColor( 255, 0, 0, 100 ) );
1689 context.
painter()->drawRect( bounds );
1693 if ( drawVertexMarker && !usingSegmentizedGeometry )
1695 markers.append( info.renderPoint );
1703 for (
const LineInfo &info : std::as_const( linesToRender ) )
1711 if ( drawVertexMarker && !usingSegmentizedGeometry )
1713 markers << info.renderLine;
1722 for (
const PolygonInfo &info : std::as_const( polygonsToRender ) )
1731 if ( drawVertexMarker && !usingSegmentizedGeometry )
1733 markers << info.renderExterior;
1735 for (
const QPolygonF &hole : info.renderRings )
1754 handler->handleRenderedFeature( feature, renderedBoundsGeom, featureContext );
1757 if ( drawVertexMarker )
1761 const auto constMarkers = markers;
1762 for ( QPointF marker : constMarkers )
1764 renderVertexMarker( marker, context, currentVertexMarkerType, currentVertexMarkerSize );
1779 x = vertexPoint.
x();
1780 y = vertexPoint.
y();
1789 renderVertexMarker( mapPoint, context, currentVertexMarkerType, currentVertexMarkerSize );
1797 return mSymbolRenderContext.get();
1806 void QgsSymbol::initPropertyDefinitions()
1808 if ( !sPropertyDefinitions.isEmpty() )
1811 QString origin = QStringLiteral(
"symbol" );
1832 const QList< QgsSymbolLayer * > layers =
mLayers;
1856 const QList< QgsSymbolLayer * > layers =
mLayers;
@ CounterClockwise
Counter-clockwise direction.
@ Clockwise
Clockwise direction.
@ DisableFeatureClipping
If present, indicates that features should never be clipped to the map extent during rendering.
@ RenderSymbolPreview
The render is for a symbol preview only and map based properties may not be available,...
@ ApplyClipAfterReprojection
Feature geometry clipping to mapExtent() must be performed after the geometries are transformed using...
@ DrawSymbolBounds
Draw bounds of symbols (for debugging/testing)
@ RenderMapTile
Draw map such that there are no problems between adjacent tiles.
@ Antialiasing
Use antialiasing while drawing.
@ HighQualityImageTransforms
Enable high quality image transformations, which results in better appearance of scaled or rotated ra...
@ FlagIncludeCrosshairsForMarkerSymbols
Include a crosshairs reference image in the background of marker symbol previews.
VertexMarkerType
Editing vertex markers, used for showing vertices during a edit operation.
Abstract base class for all geometries.
bool is3D() const SIP_HOLDGIL
Returns true if the geometry is 3D and contains a z-value.
virtual QgsRectangle boundingBox() const =0
Returns the minimal bounding box for the geometry.
virtual const QgsAbstractGeometry * simplifiedTypeRef() const SIP_HOLDGIL
Returns a reference to the simplest lossless representation of this geometry, e.g.
virtual int partCount() const =0
Returns count of parts contained in the geometry.
QgsWkbTypes::Type wkbType() const SIP_HOLDGIL
Returns the WKB type of the geometry.
virtual bool nextVertex(QgsVertexId &id, QgsPoint &vertex) const =0
Returns next vertex id and coordinates.
double valueAsDouble(int key, const QgsExpressionContext &context, double defaultValue=0.0, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as a double.
static QgsColorSchemeRegistry * colorSchemeRegistry()
Returns the application's color scheme registry, used for managing color schemes.
A 3-dimensional box composed of x, y, z coordinates.
static void trimPolygon(QPolygonF &pts, const QgsRectangle &clipRect)
Trims the given polygon to a rectangular box, by modifying the given polygon in place.
static QPolygonF clippedLine(const QgsCurve &curve, const QgsRectangle &clipExtent)
Takes a linestring and clips it to clipExtent.
static void clipped3dLine(const QVector< double > &xIn, const QVector< double > &yIn, const QVector< double > &zIn, QVector< double > &x, QVector< double > &y, QVector< double > &z, const QgsBox3d &clipExtent)
Takes a line with 3D coordinates and clips it to clipExtent.
Custom exception class for Coordinate Reference System related exceptions.
Curve polygon geometry type.
const QgsCurve * interiorRing(int i) const SIP_HOLDGIL
Retrieves an interior ring from the curve polygon.
const QgsCurve * exteriorRing() const SIP_HOLDGIL
Returns the curve polygon's exterior ring.
int numInteriorRings() const SIP_HOLDGIL
Returns the number of interior rings contained with the curve polygon.
Abstract base class for curved geometry type.
Qgis::AngularDirection orientation() const
Returns the curve's orientation, e.g.
QgsRectangle boundingBox() const override
Returns the minimal bounding box for the geometry.
virtual int numPoints() const =0
Returns the number of points in the curve.
QgsCurve * segmentize(double tolerance=M_PI_2/90, SegmentationToleranceType toleranceType=MaximumAngle) const override
Returns a geometry without curves.
virtual QPolygonF asQPolygonF() const
Returns a QPolygonF representing the points.
A class to manager painter saving and restoring required for effect drawing.
Single scope for storing variables and functions for use within a QgsExpressionContext.
static QgsExpressionContextScope * updateSymbolScope(const QgsSymbol *symbol, QgsExpressionContextScope *symbolScope=nullptr)
Updates a symbol scope related to a QgsSymbol to an expression context.
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...
static const QString EXPR_GEOMETRY_PART_COUNT
Inbuilt variable name for geometry part count variable.
static const QString EXPR_GEOMETRY_PART_NUM
Inbuilt variable name for geometry part number variable.
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.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Container of fields for a vector layer.
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
int numGeometries() const SIP_HOLDGIL
Returns the number of geometries within the collection.
const QgsAbstractGeometry * geometryN(int n) const
Returns a const reference to a geometry from within the collection.
void render(QgsSymbolRenderContext &context, QgsWkbTypes::GeometryType geometryType=QgsWkbTypes::GeometryType::UnknownGeometry, const QPolygonF *points=nullptr, const QVector< QPolygonF > *rings=nullptr)
Will render this symbol layer using the context.
A geometry is the spatial representation of a feature.
const QgsAbstractGeometry * constGet() const SIP_HOLDGIL
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
static QgsGeometry collectGeometry(const QVector< QgsGeometry > &geometries)
Creates a new multipart geometry from a list of QgsGeometry objects.
static QgsGeometry fromQPolygonF(const QPolygonF &polygon)
Construct geometry from a QPolygonF.
static QgsGeometry fromRect(const QgsRectangle &rect) SIP_HOLDGIL
Creates a new geometry from a QgsRectangle.
QgsWkbTypes::GeometryType type
void set(QgsAbstractGeometry *geometry)
Sets the underlying geometry store.
bool isEmpty() const
Returns true if the geometry is empty (eg a linestring with no vertices, or a collection with no geom...
QgsRectangle boundingBox() const
Returns the bounding box of the geometry.
Does vector analysis using the geos library and handles import, export, exception handling*.
Represents a patch shape for use in map legends.
QList< QList< QPolygonF > > toQPolygonF(Qgis::SymbolType type, QSizeF size) const
Converts the patch shape to a set of QPolygonF objects representing how the patch should be drawn for...
Line string geometry type, with support for z-dimension and m-values.
QVector< double > xVector() const
Returns the x vertex values as a vector.
QVector< double > yVector() const
Returns the y vertex values as a vector.
QVector< double > zVector() const
Returns the z vertex values as a vector.
virtual void renderPolygonStroke(const QPolygonF &points, const QVector< QPolygonF > *rings, QgsSymbolRenderContext &context)
Renders the line symbol layer along the outline of polygon, using the given render context.
A line symbol type, for rendering LineString and MultiLineString geometries.
QgsMapLayer::LayerFlags flags() const
Returns the flags for this layer.
Implementation of GeometrySimplifier using the "MapToPixel" algorithm.
SimplifyAlgorithm
Types of simplification algorithms that can be used.
QgsGeometry simplify(const QgsGeometry &geometry) const override
Returns a simplified version the specified geometry.
Perform transforms between map coordinates and device coordinates.
void transformInPlace(double &x, double &y) const
Transforms device coordinates to map coordinates.
Struct for storing maximum and minimum scales for measurements in map units.
A marker symbol type, for rendering Point and MultiPoint geometries.
Multi point geometry collection.
Base class for visual effects which can be applied to QPicture drawings.
bool enabled() const
Returns whether the effect is enabled.
Point geometry type, with support for z-dimension and m-values.
static QgsProject * instance()
Returns the QgsProject singleton instance.
void setProperty(int key, const QgsProperty &property)
Adds a property to the collection and takes ownership of it.
QSet< QString > referencedFields(const QgsExpressionContext &context=QgsExpressionContext(), bool ignoreContext=false) const override
Returns the set of any fields referenced by the active properties from the collection.
bool hasActiveProperties() const override
Returns true if the collection has any active properties, or false if all properties within the colle...
bool prepare(const QgsExpressionContext &context=QgsExpressionContext()) const override
Prepares the collection against a specified expression context.
Definition for a property.
A store for object properties.
A rectangle specified with double values.
double yMaximum() const SIP_HOLDGIL
Returns the y maximum value (top side of rectangle).
double xMaximum() const SIP_HOLDGIL
Returns the x maximum value (right side of rectangle).
double xMinimum() const SIP_HOLDGIL
Returns the x minimum value (left side of rectangle).
double yMinimum() const SIP_HOLDGIL
Returns the y minimum value (bottom side of rectangle).
bool isNull() const
Test if the rectangle is null (all coordinates zero or after call to setMinimal()).
double height() const SIP_HOLDGIL
Returns the height of the rectangle.
double width() const SIP_HOLDGIL
Returns the width of the rectangle.
bool isEmpty() const
Returns true if the rectangle is empty.
bool contains(const QgsRectangle &rect) const SIP_HOLDGIL
Returns true when rectangle contains other rectangle.
Contains information about the context of a rendering operation.
void setForceVectorOutput(bool force)
Sets whether rendering operations should use vector operations instead of any faster raster shortcuts...
void setTextureOrigin(const QPointF &origin)
Sets the texture origin, which should be used as a brush transform when rendering using QBrush object...
bool hasRenderedFeatureHandlers() const
Returns true if the context has any rendered feature handlers.
double segmentationTolerance() const
Gets the segmentation tolerance applied when rendering curved geometries.
QPainter * painter()
Returns the destination QPainter for the render operation.
QgsExpressionContext & expressionContext()
Gets the expression context.
const QgsMapToPixel & mapToPixel() const
Returns the context's map to pixel transform, which transforms between map coordinates and device coo...
void setPainterFlagsUsingContext(QPainter *painter=nullptr) const
Sets relevant flags on a destination painter, using the flags and settings currently defined for the ...
double convertToPainterUnits(double size, QgsUnitTypes::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale(), Qgis::RenderSubcomponentProperty property=Qgis::RenderSubcomponentProperty::Generic) const
Converts a size from the specified units to painter units (pixels).
void setGeometry(const QgsAbstractGeometry *geometry)
Sets pointer to original (unsegmentized) geometry.
QgsGeometry featureClipGeometry() const
Returns the geometry to use to clip features at render time.
bool testFlag(Qgis::RenderContextFlag flag) const
Check whether a particular flag is enabled.
bool forceVectorOutput() const
Returns true if rendering operations should use vector operations instead of any faster raster shortc...
long long currentFrame() const
Returns the current frame number of the map (in frames per second), for maps which are part of an ani...
void setIsGuiPreview(bool preview)
Sets GUI preview mode.
QgsRectangle mapExtent() const
Returns the original extent of the map being rendered.
QList< QgsRenderedFeatureHandlerInterface * > renderedFeatureHandlers() const
Returns the list of rendered feature handlers to use while rendering map layers.
void setFlag(Qgis::RenderContextFlag flag, bool on=true)
Enable or disable a particular flag (other flags are not affected)
double frameRate() const
Returns the frame rate of the map, for maps which are part of an animation.
bool isSymbolLayerEnabled(const QgsSymbolLayer *layer) const
When rendering a map layer in a second pass (for selective masking), some symbol layers may be disabl...
bool renderingStopped() const
Returns true if the rendering operation has been stopped and any ongoing rendering should be canceled...
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.
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
Qgis::RenderContextFlags flags() const
Returns combination of flags used for rendering.
const QgsRectangle & extent() const
When rendering a map layer, calling this method returns the "clipping" extent for the layer (in the l...
QgsAbstractGeometry::SegmentationToleranceType segmentationToleranceType() const
Gets segmentation tolerance type (maximum angle or maximum difference between curve and approximation...
const QgsVectorSimplifyMethod & vectorSimplifyMethod() const
Returns the simplification settings to use when rendering vector layers.
An interface for classes which provider custom handlers for features rendered as part of a map render...
static QgsStyle * defaultStyle()
Returns default application-wide style.
QList< QList< QPolygonF > > defaultPatchAsQPolygonF(Qgis::SymbolType type, QSizeF size) const
Returns the default patch geometry for the given symbol type and size as a set of QPolygonF objects (...
Contains settings relating to symbol animation.
bool isAnimated() const
Returns true if the symbol is animated.
double frameRate() const
Returns the symbol animation frame rate (in frames per second).
static void drawVertexMarker(double x, double y, QPainter &p, Qgis::VertexMarkerType type, int markerSize)
Draws a vertex symbol at (painter) coordinates x, y.
static QString encodeSldUom(QgsUnitTypes::RenderUnit unit, double *scaleFactor)
Encodes a render unit into an SLD unit of measure string.
static QString encodeColor(const QColor &color)
@ PropertyLayerEnabled
Whether symbol layer is enabled.
virtual void startFeatureRender(const QgsFeature &feature, QgsRenderContext &context)
Called before the layer will be rendered for a particular feature.
QgsPaintEffect * paintEffect() const
Returns the current paint effect for the layer.
virtual void startRender(QgsSymbolRenderContext &context)=0
Called before a set of rendering operations commences on the supplied render context.
bool enabled() const
Returns true if symbol layer is enabled and will be drawn.
virtual void stopRender(QgsSymbolRenderContext &context)=0
Called after a set of rendering operations has finished on the supplied render context.
virtual void stopFeatureRender(const QgsFeature &feature, QgsRenderContext &context)
Called after the layer has been rendered for a particular feature.
void setSelected(bool selected)
Sets whether symbols should be rendered using the selected symbol coloring and style.
QgsRenderContext & renderContext()
Returns a reference to the context's render context.
void setPatchShape(const QgsLegendPatchShape &shape)
Sets the symbol patch shape, to use if rendering symbol preview icons.
void setOriginalGeometryType(QgsWkbTypes::GeometryType type)
Sets the geometry type for the original feature geometry being rendered.
Abstract base class for all rendered symbols.
QgsSymbolLayerList cloneLayers() const
Retrieve a cloned list of all layers that make up this symbol.
QgsSymbolRenderContext * symbolRenderContext()
Returns the symbol render context.
QgsSymbolLayer * symbolLayer(int layer)
Returns the symbol layer at the specified index.
Property
Data definable properties.
@ PropertyOpacity
Opacity.
void setDataDefinedProperty(Property key, const QgsProperty &property)
Sets a data defined property for the symbol.
void renderUsingLayer(QgsSymbolLayer *layer, QgsSymbolRenderContext &context, QgsWkbTypes::GeometryType geometryType=QgsWkbTypes::GeometryType::UnknownGeometry, const QPolygonF *points=nullptr, const QVector< QPolygonF > *rings=nullptr)
Renders a context using a particular symbol layer without passing in a geometry.
static QPolygonF _getLineString(QgsRenderContext &context, const QgsCurve &curve, bool clipToExtent=true)
Creates a line string in screen coordinates from a QgsCurve in map coordinates.
void setOutputUnit(QgsUnitTypes::RenderUnit unit) const
Sets the units to use for sizes and widths within the symbol.
void stopRender(QgsRenderContext &context)
Ends the rendering process.
qreal mOpacity
Symbol opacity (in the range 0 - 1)
Q_DECL_DEPRECATED const QgsVectorLayer * mLayer
static QPolygonF _getPolygonRing(QgsRenderContext &context, const QgsCurve &curve, bool clipToExtent, bool isExteriorRing=false, bool correctRingOrientation=false)
Creates a polygon ring in screen coordinates from a QgsCurve in map coordinates.
QgsSymbolAnimationSettings & animationSettings()
Returns a reference to the symbol animation settings.
static Qgis::SymbolType symbolTypeForGeometryType(QgsWkbTypes::GeometryType type)
Returns the default symbol type required for the specified geometry type.
void drawPreviewIcon(QPainter *painter, QSize size, QgsRenderContext *customContext=nullptr, bool selected=false, const QgsExpressionContext *expressionContext=nullptr, const QgsLegendPatchShape *patchShape=nullptr)
Draws an icon of the symbol that occupies an area given by size using the specified painter.
void renderVertexMarker(QPointF pt, QgsRenderContext &context, Qgis::VertexMarkerType currentVertexMarkerType, double currentVertexMarkerSize)
Render editing vertex marker at specified point.
static QPointF _getPoint(QgsRenderContext &context, const QgsPoint &point)
Creates a point in screen coordinates from a QgsPoint in map coordinates.
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the symbol property definitions.
bool appendSymbolLayer(QgsSymbolLayer *layer)
Appends a symbol layer at the end of the current symbol layer list.
static QgsSymbol * defaultSymbol(QgsWkbTypes::GeometryType geomType)
Returns a new default symbol for the specified geometry type.
bool usesMapUnits() const
Returns true if the symbol has any components which use map unit based sizes.
QgsUnitTypes::RenderUnit outputUnit() const
Returns the units to use for sizes and widths within the symbol.
Qgis::SymbolFlags flags() const
Returns flags for the symbol.
void toSld(QDomDocument &doc, QDomElement &element, QVariantMap props) const
Converts the symbol to a SLD representation.
void setColor(const QColor &color) const
Sets the color for the symbol.
bool insertSymbolLayer(int index, QgsSymbolLayer *layer)
Inserts a symbol layer to specified index.
QgsMapUnitScale mapUnitScale() const
Returns the map unit scale for the symbol.
static QString symbolTypeToString(Qgis::SymbolType type)
Returns a translated string version of the specified symbol type.
qreal opacity() const
Returns the opacity for the symbol.
bool canCauseArtifactsBetweenAdjacentTiles() const
Returns true if the symbol rendering can cause visible artifacts across a single feature when the fea...
void setMapUnitScale(const QgsMapUnitScale &scale) const
Sets the map unit scale for the symbol.
bool clipFeaturesToExtent() const
Returns whether features drawn by the symbol will be clipped to the render context's extent.
QImage asImage(QSize size, QgsRenderContext *customContext=nullptr)
Returns an image of the symbol at the specified size.
static void _getPolygon(QPolygonF &pts, QVector< QPolygonF > &holes, QgsRenderContext &context, const QgsPolygon &polygon, bool clipToExtent=true, bool correctRingOrientation=false)
Creates a polygon in screen coordinates from a QgsPolygonXYin map coordinates.
QString dump() const
Returns a string dump of the symbol's properties.
bool hasDataDefinedProperties() const
Returns whether the symbol utilizes any data defined properties.
bool deleteSymbolLayer(int index)
Removes and deletes the symbol layer at the specified index.
QSet< QString > usedAttributes(const QgsRenderContext &context) const
Returns a list of attributes required to render this feature.
QImage bigSymbolPreviewImage(QgsExpressionContext *expressionContext=nullptr, Qgis::SymbolPreviewFlags flags=Qgis::SymbolPreviewFlag::FlagIncludeCrosshairsForMarkerSymbols)
Returns a large (roughly 100x100 pixel) preview image for the symbol.
bool changeSymbolLayer(int index, QgsSymbolLayer *layer)
Deletes the current layer at the specified index and replaces it with layer.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the symbol's property collection, used for data defined overrides.
QgsSymbolLayer * takeSymbolLayer(int index)
Removes a symbol layer from the list and returns a pointer to it.
Qgis::SymbolRenderHints mRenderHints
QgsSymbolLayerList mLayers
Q_DECL_DEPRECATED const QgsVectorLayer * layer() const
QgsSymbolAnimationSettings mAnimationSettings
void startFeatureRender(const QgsFeature &feature, QgsRenderContext &context, int layer=-1)
Called before symbol layers will be rendered for a particular feature.
void renderFeature(const QgsFeature &feature, QgsRenderContext &context, int layer=-1, bool selected=false, bool drawVertexMarker=false, Qgis::VertexMarkerType currentVertexMarkerType=Qgis::VertexMarkerType::SemiTransparentCircle, double currentVertexMarkerSize=0.0) SIP_THROW(QgsCsException)
Render a feature.
QColor color() const
Returns the symbol's color.
Qgis::SymbolType type() const
Returns the symbol's type.
QgsSymbol(Qgis::SymbolType type, const QgsSymbolLayerList &layers)
Constructor for a QgsSymbol of the specified type.
void setAnimationSettings(const QgsSymbolAnimationSettings &settings)
Sets a the symbol animation settings.
void startRender(QgsRenderContext &context, const QgsFields &fields=QgsFields())
Begins the rendering process for the symbol.
Q_DECL_DEPRECATED void setLayer(const QgsVectorLayer *layer)
void exportImage(const QString &path, const QString &format, QSize size)
Export the symbol as an image format, to the specified path and with the given size.
void stopFeatureRender(const QgsFeature &feature, QgsRenderContext &context, int layer=-1)
Called after symbol layers have been rendered for a particular feature.
RenderUnit
Rendering size units.
@ RenderUnknownUnit
Mixed or unknown units.
@ RenderMillimeters
Millimeters.
Represents a vector layer which manages a vector based data sets.
QgsVectorLayer * clone() const override
Returns a new instance equivalent to this one.
double tolerance() const
Gets the tolerance of simplification in map units. Represents the maximum distance in map units betwe...
bool forceLocalOptimization() const
Gets where the simplification executes, after fetch the geometries from provider, or when supported,...
SimplifyHints simplifyHints() const
Gets the simplification hints of the vector layer managed.
SimplifyAlgorithm simplifyAlgorithm() const
Gets the local simplification algorithm of the vector layer managed.
GeometryType
The geometry types are used to group QgsWkbTypes::Type in a coarse way.
static QString displayString(Type type) SIP_HOLDGIL
Returns a non-translated display string type for a WKB type, e.g., the geometry name used in WKT geom...
static bool isCurvedType(Type type) SIP_HOLDGIL
Returns true if the WKB type is a curved type or can contain curved geometries.
static Type flatType(Type type) SIP_HOLDGIL
Returns the flat type for a WKB type.
Contains geos related utilities and functions.
#define Q_NOWARN_DEPRECATED_POP
QString qgsDoubleToString(double a, int precision=17)
Returns a string representation of a double.
#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)
#define QgsDebugMsgLevel(str, level)
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.
QList< QgsSymbolLayer * > QgsSymbolLayerList
Single variable definition for use within a QgsExpressionContextScope.
Utility class for identifying a unique vertex within a geometry.