Class: QgsCurvedLineCallout

class qgis.core.QgsCurvedLineCallout

Bases: QgsSimpleLineCallout

Draws curved lines as callouts.

New in version 3.20:

Methods

calloutLabelPoint

Returns the anchor point geometry for a label with the given bounding box and anchor point mode.

calloutLineToPart

Calculates the direct line from a label geometry to an anchor geometry part, respecting the various callout settings which influence how the callout end should be placed in the anchor geometry.

clone

rtype:

QgsCurvedLineCallout

create

Creates a new QgsCurvedLineCallout, using the settings serialized in the properties map (corresponding to the output from QgsCurvedLineCallout.properties() ).

createCalloutLine

param start:

curvature

Returns the callout line's curvature.

draw

labelAnchorGeometry

Returns the anchor point geometry for a label with the given bounding box and anchor point mode.

orientation

Returns the callout line's curve orientation.

properties

param context:

setCurvature

Sets the callout line's curvature.

setOrientation

Sets the callout line's curve orientation.

type

rtype:

str

Attributes

Automatic

Clockwise

CounterClockwise

Automatic = 0
Clockwise = 1
CounterClockwise = 2
class Orientation

Bases: int

calloutLabelPoint(self, bodyBoundingBox: QRectF, angle: float, anchor: QgsCallout.LabelAnchorPoint, context: QgsRenderContext, calloutContext: QgsCallout.QgsCalloutContext) Tuple[QgsGeometry, bool]

Returns the anchor point geometry for a label with the given bounding box and anchor point mode.

The pinned argument will be set to True if the callout label point is pinned (manually placed).

New in version 3.20.

calloutLineToPart(self, labelGeometry: QgsGeometry, partGeometry: QgsAbstractGeometry, context: QgsRenderContext, calloutContext: QgsCallout.QgsCalloutContext) Tuple[QgsGeometry, bool]

Calculates the direct line from a label geometry to an anchor geometry part, respecting the various callout settings which influence how the callout end should be placed in the anchor geometry.

Returns a null geometry if the callout line cannot be calculated.

The pinned argument will be set to True if the callout anchor point is pinned (manually placed).

New in version 3.20.

clone(self) QgsCurvedLineCallout
Return type:

QgsCurvedLineCallout

create(properties: Dict[str, Any] = {}, context: QgsReadWriteContext = QgsReadWriteContext()) QgsCallout

Creates a new QgsCurvedLineCallout, using the settings serialized in the properties map (corresponding to the output from QgsCurvedLineCallout.properties() ).

Parameters:
Return type:

QgsCallout

createCalloutLine(self, start: QgsPoint, end: QgsPoint, context: QgsRenderContext, bodyBoundingBox: QRectF, angle: float, anchor: QgsGeometry, calloutContext: QgsCallout.QgsCalloutContext) QgsCurve
Parameters:
Return type:

QgsCurve

curvature(self) float

Returns the callout line’s curvature.

The curvature is a percentage value (with typical ranges between 0.0 and 1.0), representing the overall curvature of the line.

See also

setCurvature()

Return type:

float

draw(self, context: QgsRenderContext, bodyBoundingBox: QRectF, angle: float, anchor: QgsGeometry, calloutContext: QgsCallout.QgsCalloutContext)
labelAnchorGeometry(self, bodyBoundingBox: QRectF, angle: float, anchor: QgsCallout.LabelAnchorPoint) QgsGeometry

Returns the anchor point geometry for a label with the given bounding box and anchor point mode.

Deprecated since version QGIS: 3.20 use calloutLabelPoint() instead

orientation(self) QgsCurvedLineCallout.Orientation

Returns the callout line’s curve orientation.

See also

setOrientation()

Return type:

QgsCurvedLineCallout.Orientation

properties(self, context: QgsReadWriteContext) Dict[str, Any]
Parameters:

context (QgsReadWriteContext) –

Return type:

Dict[str, Any]

setCurvature(self, curvature: float)

Sets the callout line’s curvature.

The curvature is a percentage value (with typical ranges between 0.0 and 1.0), representing the overall curvature of the line.

See also

curvature()

Parameters:

curvature (float) –

setOrientation(self, orientation: QgsCurvedLineCallout.Orientation)

Sets the callout line’s curve orientation.

See also

orientation()

Parameters:

orientation (QgsCurvedLineCallout.Orientation) –

type(self) str
Return type:

str