41void QgsCallout::initPropertyDefinitions()
43 const QString origin = QStringLiteral(
"callouts" );
54 "<b>TR</b>=Top right|<br>"
55 "<b>L</b>=Left|<b>R</b>=Right|<br>"
56 "<b>BL</b>=Bottom left|<b>B</b>=Bottom middle|"
57 "<b>BR</b>=Bottom right]", origin )
68 static_cast< int >(
QgsCallout::Property::Margins ),
QgsPropertyDefinition(
"Margins",
QgsPropertyDefinition::DataTypeString, QObject::tr(
"Margins" ), QObject::tr(
"string of four doubles '<b>top,right,bottom,left</b>' or array of doubles <b>[top, right, bottom, left]</b>" ) )
84 props.insert( QStringLiteral(
"enabled" ), mEnabled ?
"1" :
"0" );
85 props.insert( QStringLiteral(
"anchorPoint" ),
encodeAnchorPoint( mAnchorPoint ) );
94 mEnabled = props.value( QStringLiteral(
"enabled" ), QStringLiteral(
"0" ) ).toInt();
95 mAnchorPoint =
decodeAnchorPoint( props.value( QStringLiteral(
"anchorPoint" ), QString() ).toString() );
96 mLabelAnchorPoint =
decodeLabelAnchorPoint( props.value( QStringLiteral(
"labelAnchorPoint" ), QString() ).toString() );
104 if ( element.isNull() )
111 QDomElement calloutElement = doc.createElement( QStringLiteral(
"callout" ) );
112 calloutElement.setAttribute( QStringLiteral(
"type" ),
type() );
113 calloutElement.appendChild( calloutPropsElement );
115 element.appendChild( calloutElement );
152 QPainter *painter = context.
painter();
156 const QPainter::CompositionMode
blendMode = mBlendMode;
163 painter->setCompositionMode(
blendMode );
168 painter->setRenderHint( QPainter::Antialiasing,
false );
169 painter->translate( rect.center() );
170 painter->rotate( -angle );
172 painter->setBrush( QColor( 255, 0, 0, 100 ) );
173 painter->setPen( QColor( 255, 0, 0, 150 ) );
175 painter->drawRect( rect.width() * -0.5, rect.height() * -0.5, rect.width(), rect.height() );
178 painter->setBrush( QColor( 0, 255, 0, 100 ) );
179 painter->setPen( QColor( 0, 255, 0, 150 ) );
184 draw( context, rect, angle, anchor, calloutContext );
186 painter->setCompositionMode( QPainter::CompositionMode_SourceOver );
196 static std::once_flag initialized;
197 std::call_once( initialized, [ = ]( )
199 initPropertyDefinitions();
201 return sPropertyDefinitions;
208 const QString cleaned = name.toLower().trimmed();
210 if ( cleaned == QLatin1String(
"pole_of_inaccessibility" ) )
212 else if ( cleaned == QLatin1String(
"point_on_exterior" ) )
214 else if ( cleaned == QLatin1String(
"point_on_surface" ) )
216 else if ( cleaned == QLatin1String(
"centroid" ) )
229 return QStringLiteral(
"pole_of_inaccessibility" );
231 return QStringLiteral(
"point_on_exterior" );
233 return QStringLiteral(
"point_on_surface" );
235 return QStringLiteral(
"centroid" );
245 return QStringLiteral(
"point_on_exterior" );
247 return QStringLiteral(
"centroid" );
249 return QStringLiteral(
"tl" );
251 return QStringLiteral(
"t" );
253 return QStringLiteral(
"tr" );
255 return QStringLiteral(
"l" );
257 return QStringLiteral(
"r" );
259 return QStringLiteral(
"bl" );
261 return QStringLiteral(
"b" );
263 return QStringLiteral(
"br" );
273 const QString cleaned = name.toLower().trimmed();
275 if ( cleaned == QLatin1String(
"point_on_exterior" ) )
277 else if ( cleaned == QLatin1String(
"centroid" ) )
279 else if ( cleaned == QLatin1String(
"tl" ) )
281 else if ( cleaned == QLatin1String(
"t" ) )
283 else if ( cleaned == QLatin1String(
"tr" ) )
285 else if ( cleaned == QLatin1String(
"l" ) )
287 else if ( cleaned == QLatin1String(
"r" ) )
289 else if ( cleaned == QLatin1String(
"bl" ) )
291 else if ( cleaned == QLatin1String(
"b" ) )
293 else if ( cleaned == QLatin1String(
"br" ) )
347 label.
rotate( angle, rect.topLeft() );
424 label.
rotate( angle, rect.topLeft() );
433 std::unique_ptr< QgsAbstractGeometry > tempPartAnchor;
446 evaluatedPartAnchor = tempPartAnchor.get();
454 evaluatedPartAnchor = partGeometry;
481 if ( labelGeos.
intersects( evaluatedPartAnchor ) )
518 if ( !mOriginalFeatureToMapTransform.
isValid() )
523 return mOriginalFeatureToMapTransform;
541 , mLineSymbol( other.mLineSymbol ? other.mLineSymbol->
clone() : nullptr )
542 , mMinCalloutLength( other.mMinCalloutLength )
543 , mMinCalloutLengthUnit( other.mMinCalloutLengthUnit )
544 , mMinCalloutLengthScale( other.mMinCalloutLengthScale )
545 , mOffsetFromAnchorDistance( other.mOffsetFromAnchorDistance )
546 , mOffsetFromAnchorUnit( other.mOffsetFromAnchorUnit )
547 , mOffsetFromAnchorScale( other.mOffsetFromAnchorScale )
548 , mOffsetFromLabelDistance( other.mOffsetFromLabelDistance )
549 , mOffsetFromLabelUnit( other.mOffsetFromLabelUnit )
550 , mOffsetFromLabelScale( other.mOffsetFromLabelScale )
551 , mDrawCalloutToAllParts( other.mDrawCalloutToAllParts )
558 std::unique_ptr< QgsSimpleLineCallout > callout = std::make_unique< QgsSimpleLineCallout >();
559 callout->readProperties(
properties, context );
560 return callout.release();
565 return QStringLiteral(
"simple" );
581 props[ QStringLiteral(
"minLength" ) ] = mMinCalloutLength;
585 props[ QStringLiteral(
"offsetFromAnchor" ) ] = mOffsetFromAnchorDistance;
588 props[ QStringLiteral(
"offsetFromLabel" ) ] = mOffsetFromLabelDistance;
592 props[ QStringLiteral(
"drawToAllParts" ) ] = mDrawCalloutToAllParts;
601 const QString lineSymbolDef = props.value( QStringLiteral(
"lineSymbol" ) ).toString();
602 QDomDocument doc( QStringLiteral(
"symbol" ) );
603 doc.setContent( lineSymbolDef );
604 const QDomElement symbolElem = doc.firstChildElement( QStringLiteral(
"symbol" ) );
605 std::unique_ptr< QgsLineSymbol >
lineSymbol( QgsSymbolLayerUtils::loadSymbol< QgsLineSymbol >( symbolElem, context ) );
609 mMinCalloutLength = props.value( QStringLiteral(
"minLength" ), 0 ).toDouble();
613 mOffsetFromAnchorDistance = props.value( QStringLiteral(
"offsetFromAnchor" ), 0 ).toDouble();
616 mOffsetFromLabelDistance = props.value( QStringLiteral(
"offsetFromLabel" ), 0 ).toDouble();
620 mDrawCalloutToAllParts = props.value( QStringLiteral(
"drawToAllParts" ),
false ).toBool();
627 mLineSymbol->startRender( context );
634 mLineSymbol->stopRender( context );
641 fields.unite( mLineSymbol->usedAttributes( context ) );
647 return mLineSymbol.get();
652 mLineSymbol.reset( symbol );
665 bool originPinned =
false;
670 auto drawCalloutLine = [
this, &context, &calloutContext, &label, &rect, angle, &anchor, originPinned](
const QgsAbstractGeometry * partAnchor )
672 bool destinationPinned =
false;
677 const double lineLength = line.
length();
681 double minLength = mMinCalloutLength;
687 const double minLengthPixels = context.
convertToPainterUnits( minLength, mMinCalloutLengthUnit, mMinCalloutLengthScale );
688 if ( minLengthPixels > 0 && lineLength < minLengthPixels )
691 std::unique_ptr< QgsCurve > calloutCurve(
createCalloutLine( qgsgeometry_cast< const QgsLineString * >( line.
constGet() )->startPoint(),
692 qgsgeometry_cast< const QgsLineString * >( line.
constGet() )->endPoint(), context, rect, angle, anchor, calloutContext ) );
709 if ( offsetFromAnchorPixels > 0 || offsetFromLabelPixels > 0 )
711 calloutCurve.reset( calloutCurve->curveSubstring( offsetFromLabelPixels, calloutCurve->length() - offsetFromAnchorPixels ) );
714 const QPolygonF points = calloutCurve->asQPolygonF();
716 if ( points.empty() )
726 mLineSymbol->renderPolyline( points,
nullptr, context );
729 bool toAllParts = mDrawCalloutToAllParts;
737 drawCalloutLine( anchor.
constGet() );
741 drawCalloutLine( *it );
767 std::unique_ptr< QgsManhattanLineCallout > callout = std::make_unique< QgsManhattanLineCallout >();
768 callout->readProperties(
properties, context );
769 return callout.release();
774 return QStringLiteral(
"manhattan" );
785 return new QgsLineString( QVector< QgsPoint >() << start << mid1 << end );
799 , mOrientation( other.mOrientation )
800 , mCurvature( other.mCurvature )
807 std::unique_ptr< QgsCurvedLineCallout > callout = std::make_unique< QgsCurvedLineCallout >();
808 callout->readProperties(
properties, context );
810 callout->setCurvature(
properties.value( QStringLiteral(
"curvature" ), 0.1 ).toDouble() );
811 callout->setOrientation( decodeOrientation(
properties.value( QStringLiteral(
"orientation" ), QStringLiteral(
"auto" ) ).toString() ) );
813 return callout.release();
818 return QStringLiteral(
"curved" );
829 props.insert( QStringLiteral(
"curvature" ), mCurvature );
830 props.insert( QStringLiteral(
"orientation" ), encodeOrientation( mOrientation ) );
850 orientation = decodeOrientation( orientationString );
865 if ( start.
x() < ( rect.left() + 0.5 * rect.width() ) )
870 else if ( end.
x() > start.
x() )
878 if ( end.
x() < start.
x() )
880 else if ( end.
y() < start.
y() )
882 else if ( end.
x() - start.
x() < end.
y() - start.
y() )
893 if ( start.
y() < ( rect.top() + 0.5 * rect.height() ) )
898 else if ( end.
y() < start.
y() )
906 if ( end.
x() < start.
x() )
908 else if ( end.
y() > start.
y() )
910 else if ( end.
x() - start.
x() < start.
y() - end.
y() )
921 if ( start.
x() < ( rect.left() + 0.5 * rect.width() ) )
926 else if ( end.
x() < start.
x() )
934 if ( end.
x() > start.
x() )
936 else if ( end.
y() > start.
y() )
938 else if ( start.
x() - end.
x() < start.
y() - end.
y() )
949 if ( start.
y() < ( rect.top() + 0.5 * rect.height() ) )
954 else if ( end.
y() > start.
y() )
962 if ( end.
x() > start.
x() )
964 else if ( end.
y() < start.
y() )
966 else if ( start.
x() - end.
x() < end.
y() - start.
y() )
986 const QString cleaned =
string.toLower().trimmed();
987 if ( cleaned == QLatin1String(
"auto" ) )
989 if ( cleaned == QLatin1String(
"clockwise" ) )
991 if ( cleaned == QLatin1String(
"counterclockwise" ) )
1001 return QStringLiteral(
"auto" );
1003 return QStringLiteral(
"clockwise" );
1005 return QStringLiteral(
"counterclockwise" );
1012 return mOrientation;
1045 , mFillSymbol( other.mFillSymbol ? other.mFillSymbol->clone() : nullptr )
1046 , mMarkerSymbol( other.mMarkerSymbol ? other.mMarkerSymbol->clone() : nullptr )
1047 , mOffsetFromAnchorDistance( other.mOffsetFromAnchorDistance )
1048 , mOffsetFromAnchorUnit( other.mOffsetFromAnchorUnit )
1049 , mOffsetFromAnchorScale( other.mOffsetFromAnchorScale )
1050 , mMargins( other.mMargins )
1051 , mMarginUnit( other.mMarginUnit )
1052 , mWedgeWidth( other.mWedgeWidth )
1053 , mWedgeWidthUnit( other.mWedgeWidthUnit )
1054 , mWedgeWidthScale( other.mWedgeWidthScale )
1055 , mCornerRadius( other.mCornerRadius )
1056 , mCornerRadiusUnit( other.mCornerRadiusUnit )
1057 , mCornerRadiusScale( other.mCornerRadiusScale )
1064 std::unique_ptr< QgsBalloonCallout > callout = std::make_unique< QgsBalloonCallout >();
1065 callout->readProperties(
properties, context );
1066 return callout.release();
1071 return QStringLiteral(
"balloon" );
1088 if ( mMarkerSymbol )
1093 props[ QStringLiteral(
"offsetFromAnchor" ) ] = mOffsetFromAnchorDistance;
1097 props[ QStringLiteral(
"margins" ) ] = mMargins.
toString();
1100 props[ QStringLiteral(
"wedgeWidth" ) ] = mWedgeWidth;
1104 props[ QStringLiteral(
"cornerRadius" ) ] = mCornerRadius;
1116 const QString fillSymbolDef = props.value( QStringLiteral(
"fillSymbol" ) ).toString();
1117 QDomDocument doc( QStringLiteral(
"symbol" ) );
1118 doc.setContent( fillSymbolDef );
1119 const QDomElement symbolElem = doc.firstChildElement( QStringLiteral(
"symbol" ) );
1120 std::unique_ptr< QgsFillSymbol >
fillSymbol( QgsSymbolLayerUtils::loadSymbol< QgsFillSymbol >( symbolElem, context ) );
1126 const QString markerSymbolDef = props.value( QStringLiteral(
"markerSymbol" ) ).toString();
1127 QDomDocument doc( QStringLiteral(
"symbol" ) );
1128 doc.setContent( markerSymbolDef );
1129 const QDomElement symbolElem = doc.firstChildElement( QStringLiteral(
"symbol" ) );
1130 std::unique_ptr< QgsMarkerSymbol >
markerSymbol( QgsSymbolLayerUtils::loadSymbol< QgsMarkerSymbol >( symbolElem, context ) );
1135 mOffsetFromAnchorDistance = props.value( QStringLiteral(
"offsetFromAnchor" ), 0 ).toDouble();
1142 mWedgeWidth = props.value( QStringLiteral(
"wedgeWidth" ), 2.64 ).toDouble();
1146 mCornerRadius = props.value( QStringLiteral(
"cornerRadius" ), 0 ).toDouble();
1155 mFillSymbol->startRender( context );
1156 if ( mMarkerSymbol )
1157 mMarkerSymbol->startRender( context );
1164 mFillSymbol->stopRender( context );
1165 if ( mMarkerSymbol )
1166 mMarkerSymbol->stopRender( context );
1173 fields.unite( mFillSymbol->usedAttributes( context ) );
1174 if ( mMarkerSymbol )
1175 fields.unite( mMarkerSymbol->usedAttributes( context ) );
1181 return mFillSymbol.get();
1186 mFillSymbol.reset( symbol );
1191 return mMarkerSymbol.get();
1196 mMarkerSymbol.reset( symbol );
1201 bool destinationIsPinned =
false;
1204 if ( mMarkerSymbol )
1209 mMarkerSymbol->renderPoint(
anchorPoint.toQPointF(),
nullptr, context );
1221 if ( offsetFromAnchorPixels > 0 )
1225 line =
QgsGeometry( ls->curveSubstring( 0, ls->length() - offsetFromAnchorPixels ) );
1233 origin = ls->startPoint();
1234 destination = ls->endPoint();
1241 const QPolygonF points = getPoints( context, destination, rect );
1242 if ( points.empty() )
1255 mFillSymbol->renderPolygon( points,
nullptr,
nullptr, context );
1260 double segmentPointWidth = mWedgeWidth;
1266 segmentPointWidth = context.
convertToPainterUnits( segmentPointWidth, mWedgeWidthUnit, mWedgeWidthScale );
1276 double left = mMargins.
left();
1277 double right = mMargins.
right();
1278 double top = mMargins.
top();
1279 double bottom = mMargins.
bottom();
1286 if ( value.userType() == QMetaType::Type::QVariantList )
1288 const QVariantList list = value.toList();
1289 if ( list.size() == 4 )
1292 bool rightOk =
false;
1293 bool bottomOk =
false;
1294 bool leftOk =
false;
1295 const double evaluatedTop = list.at( 0 ).toDouble( &topOk );
1296 const double evaluatedRight = list.at( 1 ).toDouble( &rightOk );
1297 const double evaluatedBottom = list.at( 2 ).toDouble( &bottomOk );
1298 const double evaluatedLeft = list.at( 3 ).toDouble( &leftOk );
1299 if ( topOk && rightOk && bottomOk && leftOk )
1301 left = evaluatedLeft;
1303 right = evaluatedRight;
1304 bottom = evaluatedBottom;
1310 const QStringList list = value.toString().trimmed().split(
',' );
1311 if ( list.count() == 4 )
1314 bool rightOk =
false;
1315 bool bottomOk =
false;
1316 bool leftOk =
false;
1317 const double evaluatedTop = list.at( 0 ).toDouble( &topOk );
1318 const double evaluatedRight = list.at( 1 ).toDouble( &rightOk );
1319 const double evaluatedBottom = list.at( 2 ).toDouble( &bottomOk );
1320 const double evaluatedLeft = list.at( 3 ).toDouble( &leftOk );
1321 if ( topOk && rightOk && bottomOk && leftOk )
1323 left = evaluatedLeft;
1325 right = evaluatedRight;
1326 bottom = evaluatedBottom;
1338 const QRectF expandedRect = rect.height() < 0 ?
1339 QRectF( rect.left() - marginLeft, rect.top() + marginBottom,
1340 rect.width() + marginLeft + marginRight,
1341 rect.height() - marginTop - marginBottom ) :
1342 QRectF( rect.left() - marginLeft, rect.top() - marginTop,
1343 rect.width() + marginLeft + marginRight,
1344 rect.height() + marginTop + marginBottom );
1348 if ( expandedRect.width() <= 0 || ( rect.height() < 0 && expandedRect.height() >= 0 ) || ( rect.height() > 0 && expandedRect.height() <= 0 ) )
1352 const QTransform t = QTransform::fromScale( 100, 100 );
1353 const QTransform ti = t.inverted();
1354 const QPolygonF poly = path.toFillPolygon( t );
1355 return ti.map( poly );
BlendMode
Blending modes defining the available composition modes that can be used when painting.
Abstract base class for all geometries.
virtual QgsRectangle boundingBox() const
Returns the minimal bounding box for the geometry.
Qgis::WkbType wkbType() const
Returns the WKB type of the geometry.
virtual void transform(const QgsCoordinateTransform &ct, Qgis::TransformDirection d=Qgis::TransformDirection::Forward, bool transformZ=false)=0
Transforms the geometry using a coordinate transform.
virtual QgsAbstractGeometry * clone() const =0
Clones the geometry by performing a deep copy.
bool valueAsBool(int key, const QgsExpressionContext &context, bool defaultValue=false, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as an boolean.
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.
A cartoon talking bubble callout style.
QgsFillSymbol * fillSymbol()
Returns the fill symbol used to render the callout.
double cornerRadius() const
Returns the corner radius of the balloon shapes.
QString type() const override
Returns a unique string representing the callout type.
QgsMarkerSymbol * markerSymbol()
Returns the marker symbol used to render the callout endpoint.
void startRender(QgsRenderContext &context) override
Prepares the callout for rendering on the specified render context.
QSet< QString > referencedFields(const QgsRenderContext &context) const override
Returns the set of attributes referenced by the callout.
void stopRender(QgsRenderContext &context) override
Finalises the callout after a set of rendering operations on the specified render context.
QVariantMap properties(const QgsReadWriteContext &context) const override
Returns the properties describing the callout encoded in a string format.
void setFillSymbol(QgsFillSymbol *symbol)
Sets the fill symbol used to render the callout.
void draw(QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCallout::QgsCalloutContext &calloutContext) override
Performs the actual rendering of the callout implementation onto the specified render context.
void setMarkerSymbol(QgsMarkerSymbol *symbol)
Sets the marker symbol used to render the callout endpoint.
~QgsBalloonCallout() override
QgsBalloonCallout * clone() const override
Duplicates a callout by creating a deep copy of the callout.
static QgsCallout * create(const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
Creates a new QgsBalloonCallout, using the settings serialized in the properties map (corresponding t...
double offsetFromAnchor() const
Returns the offset distance from the anchor point at which to start the line.
void readProperties(const QVariantMap &props, const QgsReadWriteContext &context) override
Reads a string map of an callout's properties and restores the callout to the state described by the ...
Represents the calculated placement of a map label callout line.
void setDestination(const QPointF &destination)
Sets the destination of the callout line, in map coordinates.
void setOrigin(const QPointF &origin)
Sets the origin of the callout line, in map coordinates.
void setDestinationIsPinned(bool pinned)
Sets whether the destination of the callout has pinned (manually placed).
void setOriginIsPinned(bool pinned)
Sets whether the origin of the callout has pinned (manually placed).
Contains additional contextual information about the context in which a callout is being rendered.
QgsCoordinateTransform originalFeatureToMapTransform(const QgsRenderContext &renderContext) const
Returns the coordinate transform to convert from the original layer associated with the callout to th...
void addCalloutPosition(const QgsCalloutPosition &position)
Adds a rendered callout position.
bool allFeaturePartsLabeled
true if all parts of associated feature were labeled
QgsCoordinateReferenceSystem originalFeatureCrs
Contains the CRS of the original feature associated with this callout.
Abstract base class for callout renderers.
static QString encodeAnchorPoint(AnchorPoint anchor)
Encodes an anchor point to its string representation.
bool containsAdvancedEffects() const
Returns true if the callout requires advanced effects such as blend modes, which require output in ra...
virtual bool saveProperties(QDomDocument &doc, QDomElement &element, const QgsReadWriteContext &context) const
Saves the current state of the callout to a DOM element.
virtual void stopRender(QgsRenderContext &context)
Finalises the callout after a set of rendering operations on the specified render context.
QgsGeometry calloutLineToPart(const QgsGeometry &labelGeometry, const QgsAbstractGeometry *partGeometry, QgsRenderContext &context, const QgsCalloutContext &calloutContext, bool &pinned) const
Calculates the direct line from a label geometry to an anchor geometry part, respecting the various c...
void setEnabled(bool enabled)
Sets whether the callout is enabled.
virtual QString type() const =0
Returns a unique string representing the callout type.
virtual QgsCallout * clone() const =0
Duplicates a callout by creating a deep copy of the callout.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the callout's property collection, used for data defined overrides.
QgsGeometry calloutLabelPoint(const QRectF &bodyBoundingBox, double angle, LabelAnchorPoint anchor, QgsRenderContext &context, const QgsCalloutContext &calloutContext, bool &pinned) const
Returns the anchor point geometry for a label with the given bounding box and anchor point mode.
static QgsPropertiesDefinition propertyDefinitions()
Returns the definitions for data defined properties available for use in callouts.
AnchorPoint anchorPoint() const
Returns the feature's anchor point position.
LabelAnchorPoint labelAnchorPoint() const
Returns the label's anchor point position.
AnchorPoint
Feature's anchor point position.
@ PointOnExterior
A point on the surface's outline closest to the label is used as anchor for polygon geometries.
@ Centroid
The surface's centroid is used as anchor for polygon geometries.
@ PointOnSurface
A point guaranteed to be on the surface is used as anchor for polygon geometries.
@ PoleOfInaccessibility
The surface's pole of inaccessibility used as anchor for polygon geometries.
void render(QgsRenderContext &context, const QRectF &rect, const double angle, const QgsGeometry &anchor, QgsCalloutContext &calloutContext)
Renders the callout onto the specified render context.
virtual void restoreProperties(const QDomElement &element, const QgsReadWriteContext &context)
Restores the callout's properties from a DOM element.
virtual void draw(QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCalloutContext &calloutContext)=0
Performs the actual rendering of the callout implementation onto the specified render context.
static QString encodeLabelAnchorPoint(LabelAnchorPoint anchor)
Encodes a label anchor point to its string representation.
virtual void startRender(QgsRenderContext &context)
Prepares the callout for rendering on the specified render context.
static QgsCallout::LabelAnchorPoint decodeLabelAnchorPoint(const QString &name, bool *ok=nullptr)
Attempts to decode a string representation of a label anchor point name to the corresponding anchor p...
Q_DECL_DEPRECATED QgsGeometry labelAnchorGeometry(const QRectF &bodyBoundingBox, const double angle, LabelAnchorPoint anchor) const
Returns the anchor point geometry for a label with the given bounding box and anchor point mode.
QgsCallout()
Constructor for QgsCallout.
DrawOrder
Options for draw order (stacking) of callouts.
@ OrderBelowAllLabels
Render callouts below all labels.
virtual DrawOrder drawOrder() const
Returns the desired drawing order (stacking) to use while rendering this callout.
QPainter::CompositionMode blendMode() const
Returns the blending mode used for drawing callouts.
LabelAnchorPoint
Label's anchor point position.
@ LabelPointOnExterior
The point on the label's boundary closest to the feature.
@ LabelBottomLeft
Bottom left corner of the label's boundary.
@ LabelBottomMiddle
Bottom middle of the label's boundary.
@ LabelMiddleLeft
Middle left of the label's boundary.
@ LabelBottomRight
Bottom right corner of the label's boundary.
@ LabelMiddleRight
Middle right of the label's boundary.
@ LabelTopMiddle
Top middle of the label's boundary.
@ LabelTopLeft
Top left corner of the label's boundary.
@ LabelCentroid
The labe's centroid.
@ LabelTopRight
Top right corner of the label's boundary.
static QgsCallout::AnchorPoint decodeAnchorPoint(const QString &name, bool *ok=nullptr)
Attempts to decode a string representation of an anchor point name to the corresponding anchor point.
virtual void readProperties(const QVariantMap &props, const QgsReadWriteContext &context)
Reads a string map of an callout's properties and restores the callout to the state described by the ...
virtual QSet< QString > referencedFields(const QgsRenderContext &context) const
Returns the set of attributes referenced by the callout.
@ MinimumCalloutLength
Minimum length of callouts.
@ LabelAnchorPointPosition
Label's anchor point position.
@ CornerRadius
Balloon callout corner radius.
@ OffsetFromAnchor
Distance to offset lines from anchor points.
@ OffsetFromLabel
Distance to offset lines from label area.
@ DestinationX
X-coordinate of callout destination (feature anchor)
@ DestinationY
Y-coordinate of callout destination (feature anchor)
@ WedgeWidth
Balloon callout wedge width.
@ AnchorPointPosition
Feature's anchor point position.
@ OriginX
X-coordinate of callout origin (label anchor)
@ OriginY
Y-coordinate of callout origin (label anchor)
@ Curvature
Curvature of curved line callouts.
@ BlendMode
Callout blend mode.
@ Orientation
Orientation of curved line callouts.
@ Margins
Margin from text.
@ DrawCalloutToAllParts
Whether callout lines should be drawn to all feature parts.
virtual QVariantMap properties(const QgsReadWriteContext &context) const
Returns the properties describing the callout encoded in a string format.
bool enabled() const
Returns true if the the callout is enabled.
Circular string geometry type.
Custom exception class for Coordinate Reference System related exceptions.
Abstract base class for curved geometry type.
Draws curved lines as callouts.
QgsCurvedLineCallout * clone() const override
Duplicates a callout by creating a deep copy of the callout.
QgsCurve * createCalloutLine(const QgsPoint &start, const QgsPoint &end, QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCalloutContext &calloutContext) const override
Creates a callout line between start and end in the desired style.
QVariantMap properties(const QgsReadWriteContext &context) const override
Returns the properties describing the callout encoded in a string format.
void setOrientation(Orientation orientation)
Sets the callout line's curve orientation.
void setCurvature(double curvature)
Sets the callout line's curvature.
static QgsCallout * create(const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
Creates a new QgsCurvedLineCallout, using the settings serialized in the properties map (correspondin...
QString type() const override
Returns a unique string representing the callout type.
double curvature() const
Returns the callout line's curvature.
Orientation
Curve orientation.
@ Clockwise
Curve lines in a clockwise direction.
@ CounterClockwise
Curve lines in a counter-clockwise direction.
@ Automatic
Automatically choose most cartographically pleasing orientation based on label and callout arrangemen...
Orientation orientation() const
Returns the callout line's curve orientation.
void setOriginalValueVariable(const QVariant &value)
Sets the original value variable value for the context.
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
static int closestSideOfRectangle(double right, double bottom, double left, double top, double x, double y)
Returns a number representing the closest side of a rectangle defined by /a right,...
static void perpendicularOffsetPointAlongSegment(double x1, double y1, double x2, double y2, double proportion, double offset, double *x, double *y)
Calculates a point a certain proportion of the way along the segment from (x1, y1) to (x2,...
A geometry is the spatial representation of a feature.
static QgsGeometry fromRect(const QgsRectangle &rect)
Creates a new geometry from a QgsRectangle.
double length() const
Returns the planar, 2-dimensional length of geometry.
QgsGeometry poleOfInaccessibility(double precision, double *distanceToBoundary=nullptr) const
Calculates the approximate pole of inaccessibility for a surface, which is the most distant internal ...
QgsAbstractGeometry::const_part_iterator const_parts_begin() const
Returns STL-style const iterator pointing to the first part of the geometry.
QgsGeometry pointOnSurface() const
Returns a point guaranteed to lie on the surface of a geometry.
Qgis::GeometryOperationResult transform(const QgsCoordinateTransform &ct, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward, bool transformZ=false)
Transforms this geometry as described by the coordinate transform ct.
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
static QgsGeometry fromPointXY(const QgsPointXY &point)
Creates a new geometry from a QgsPointXY object.
QgsGeometry centroid() const
Returns the center of mass of a geometry.
bool isEmpty() const
Returns true if the geometry is empty (eg a linestring with no vertices, or a collection with no geom...
QgsAbstractGeometry::const_part_iterator const_parts_end() const
Returns STL-style iterator pointing to the imaginary part after the last part of the geometry.
QgsRectangle boundingBox() const
Returns the bounding box of the geometry.
Qgis::GeometryOperationResult rotate(double rotation, const QgsPointXY ¢er)
Rotate this geometry around the Z axis.
Does vector analysis using the geos library and handles import, export, exception handling*.
QgsGeometry shortestLine(const QgsGeometry &other, QString *errorMsg=nullptr) const
Returns the shortest line joining this geometry to the other geometry.
bool intersects(const QgsAbstractGeometry *geom, QString *errorMsg=nullptr) const override
Checks if geom intersects this.
Line string geometry type, with support for z-dimension and m-values.
A line symbol type, for rendering LineString and MultiLineString geometries.
Draws straight (right angled) lines as callouts.
QgsManhattanLineCallout()
QString type() const override
Returns a unique string representing the callout type.
QgsCurve * createCalloutLine(const QgsPoint &start, const QgsPoint &end, QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCallout::QgsCalloutContext &calloutContext) const override
Creates a callout line between start and end in the desired style.
static QgsCallout * create(const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
Creates a new QgsManhattanLineCallout, using the settings serialized in the properties map (correspon...
QgsManhattanLineCallout * clone() const override
Duplicates a callout by creating a deep copy of the callout.
QgsPointXY toMapCoordinates(int x, int y) const
Transforms device coordinates to map (world) coordinates.
QgsPointXY transform(const QgsPointXY &p) const
Transforms a point p from map (world) coordinates to device coordinates.
double top() const
Returns the top margin.
static QgsMargins fromString(const QString &string)
Returns a QgsMargins object decoded from a string, or a null QgsMargins if the string could not be in...
double right() const
Returns the right margin.
double bottom() const
Returns the bottom margin.
QString toString() const
Returns the margins encoded to a string.
double left() const
Returns the left margin.
A marker symbol type, for rendering Point and MultiPoint geometries.
static Qgis::BlendMode getBlendModeEnum(QPainter::CompositionMode blendMode)
Returns a Qgis::BlendMode corresponding to a QPainter::CompositionMode.
static QPainter::CompositionMode getCompositionMode(Qgis::BlendMode blendMode)
Returns a QPainter::CompositionMode corresponding to a Qgis::BlendMode.
A class to represent a 2D point.
bool isEmpty() const
Returns true if the geometry is empty.
QPointF toQPointF() const
Converts a point to a QPointF.
Point geometry type, with support for z-dimension and m-values.
double distance(double x, double y) const
Returns the Cartesian 2D distance between this point and a specified x, y coordinate.
QVariant toVariant(const QgsPropertiesDefinition &definitions) const final
Saves this property collection to a QVariantMap, wrapped in a QVariant.
QVariant value(int key, const QgsExpressionContext &context, const QVariant &defaultValue=QVariant()) const final
Returns the calculated value of the property with the specified key from within the collection.
bool isActive(int key) const final
Returns true if the collection contains an active property with the specified key.
bool loadVariant(const QVariant &configuration, const QgsPropertiesDefinition &definitions) final
Loads this property collection from a QVariantMap, wrapped in a QVariant.
bool prepare(const QgsExpressionContext &context=QgsExpressionContext()) const final
Prepares the collection against a specified expression context.
QgsProperty property(int key) const final
Returns a matching property from the collection, if one exists.
QSet< QString > referencedFields(const QgsExpressionContext &context=QgsExpressionContext(), bool ignoreContext=false) const final
Returns the set of any fields referenced by the active properties from the collection.
Definition for a property.
@ Double
Double value (including negative values)
@ DoublePositive
Positive double value (including 0)
@ DataTypeString
Property requires a string value.
QString valueAsString(const QgsExpressionContext &context, const QString &defaultString=QString(), bool *ok=nullptr) const
Calculates the current value of the property and interprets it as a string.
The class is used as a container of context for various read/write operations on other objects.
double width() const
Returns the width of the rectangle.
QRectF toRectF() const
Returns a QRectF with same coordinates as the rectangle.
double height() const
Returns the height of the rectangle.
QgsRectangle buffered(double width) const
Gets rectangle enlarged by buffer.
Contains information about the context of a rendering operation.
bool useAdvancedEffects() const
Returns true if advanced effects such as blend modes such be used.
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.
QgsExpressionContext & expressionContext()
Gets the expression context.
QgsCoordinateTransformContext transformContext() const
Returns the context's coordinate transform context, which stores various information regarding which ...
const QgsMapToPixel & mapToPixel() const
Returns the context's map to pixel transform, which transforms between map coordinates and device coo...
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
static QPolygonF createBalloon(const QgsPointXY &origin, const QRectF &rect, double wedgeWidth)
Generates a "balloon"/"talking bubble" style shape (as a QPolygonF).
Renders polygons using a single fill and stroke color.
A simple direct line callout style.
void startRender(QgsRenderContext &context) override
Prepares the callout for rendering on the specified render context.
void setLineSymbol(QgsLineSymbol *symbol)
Sets the line symbol used to render the callout line.
void stopRender(QgsRenderContext &context) override
Finalises the callout after a set of rendering operations on the specified render context.
QSet< QString > referencedFields(const QgsRenderContext &context) const override
Returns the set of attributes referenced by the callout.
double offsetFromLabel() const
Returns the offset distance from label area at which to end the line.
void readProperties(const QVariantMap &props, const QgsReadWriteContext &context) override
Reads a string map of an callout's properties and restores the callout to the state described by the ...
void draw(QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCallout::QgsCalloutContext &calloutContext) override
Performs the actual rendering of the callout implementation onto the specified render context.
QString type() const override
Returns a unique string representing the callout type.
double offsetFromAnchor() const
Returns the offset distance from the anchor point at which to start the line.
~QgsSimpleLineCallout() override
virtual QgsCurve * createCalloutLine(const QgsPoint &start, const QgsPoint &end, QgsRenderContext &context, const QRectF &bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCallout::QgsCalloutContext &calloutContext) const
Creates a callout line between start and end in the desired style.
static QgsCallout * create(const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
Creates a new QgsSimpleLineCallout, using the settings serialized in the properties map (correspondin...
QVariantMap properties(const QgsReadWriteContext &context) const override
Returns the properties describing the callout encoded in a string format.
QgsSimpleLineCallout * clone() const override
Duplicates a callout by creating a deep copy of the callout.
QgsLineSymbol * lineSymbol()
Returns the line symbol used to render the callout line.
A simple line symbol layer, which renders lines using a line in a variety of styles (e....
static QString encodeMapUnitScale(const QgsMapUnitScale &mapUnitScale)
static QgsMapUnitScale decodeMapUnitScale(const QString &str)
static QPainter::CompositionMode decodeBlendMode(const QString &s)
static QString symbolProperties(QgsSymbol *symbol)
Returns a string representing the symbol.
static Q_INVOKABLE Qgis::RenderUnit decodeRenderUnit(const QString &string, bool *ok=nullptr)
Decodes a render unit from a string.
static Q_INVOKABLE QString encodeUnit(Qgis::DistanceUnit unit)
Encodes a distance unit to a string.
static bool isNull(const QVariant &variant, bool silenceNullWarnings=false)
Returns true if the specified variant should be considered a NULL value.
static Qgis::GeometryType geometryType(Qgis::WkbType type)
Returns the geometry type for a WKB type, e.g., both MultiPolygon and CurvePolygon would have a Polyg...
static QDomElement writeVariant(const QVariant &value, QDomDocument &doc)
Write a QVariant to a QDomElement.
static QVariant readVariant(const QDomElement &element)
Read a QVariant from a QDomElement.
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference)
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.
QList< QgsSymbolLayer * > QgsSymbolLayerList
record about vertex coordinates and index of anchor to which it is snapped