\inmodule QtGui More...

#include <qpainterpath.h>

Collaboration diagram for QPainterPath:

Classes
class	Element
	\inmodule QtGui More...

Public Types
enum	ElementType { MoveToElement , LineToElement , CurveToElement , CurveToDataElement }
	This enum describes the types of elements used to connect vertices in subpaths. More...

Public Member Functions
	QPainterPath () noexcept
	Constructs an empty QPainterPath object.

	QPainterPath (const QPointF &startPoint)
	Creates a QPainterPath object with the given startPoint as its current position.

	QPainterPath (const QPainterPath &other)
	Creates a QPainterPath object that is a copy of the given path.

QPainterPath &	operator= (const QPainterPath &other)
	Assigns the given path to this painter path.

	~QPainterPath ()
	Destroys this QPainterPath object.

void	swap (QPainterPath &other) noexcept

void	clear ()
	Clears the path elements stored.

void	reserve (int size)
	Reserves a given amount of elements in QPainterPath's internal memory.

int	capacity () const
	Returns the number of elements allocated by the QPainterPath.

void	closeSubpath ()
	Closes the current subpath by drawing a line to the beginning of the subpath, automatically starting a new path.

void	moveTo (const QPointF &p)
	Moves the current point to the given point, implicitly starting a new subpath and closing the previous one.

void	moveTo (qreal x, qreal y)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Moves the current position to ({x}, {y}) and starts a new subpath, implicitly closing the previous path.

void	lineTo (const QPointF &p)
	Adds a straight line from the current position to the given endPoint.

void	lineTo (qreal x, qreal y)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Draws a line from the current position to the point ({x}, {y}).

void	arcMoveTo (const QRectF &rect, qreal angle)

void	arcMoveTo (qreal x, qreal y, qreal w, qreal h, qreal angle)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void	arcTo (const QRectF &rect, qreal startAngle, qreal arcLength)
	Creates an arc that occupies the given rectangle, beginning at the specified startAngle and extending sweepLength degrees counter-clockwise.

void	arcTo (qreal x, qreal y, qreal w, qreal h, qreal startAngle, qreal arcLength)

void	cubicTo (const QPointF &ctrlPt1, const QPointF &ctrlPt2, const QPointF &endPt)
	Adds a cubic Bezier curve between the current position and the given endPoint using the control points specified by c1, and c2.

void	cubicTo (qreal ctrlPt1x, qreal ctrlPt1y, qreal ctrlPt2x, qreal ctrlPt2y, qreal endPtx, qreal endPty)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a cubic Bezier curve between the current position and the end point ({endPointX}, {endPointY}) with control points specified by ({c1X}, {c1Y}) and ({c2X}, {c2Y}).

void	quadTo (const QPointF &ctrlPt, const QPointF &endPt)
	Adds a quadratic Bezier curve between the current position and the given endPoint with the control point specified by c.

void	quadTo (qreal ctrlPtx, qreal ctrlPty, qreal endPtx, qreal endPty)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a quadratic Bezier curve between the current point and the endpoint ({endPointX}, {endPointY}) with the control point specified by ({cx}, {cy}).

QPointF	currentPosition () const
	Returns the current position of the path.

void	addRect (const QRectF &rect)
	Adds the given rectangle to this path as a closed subpath.

void	addRect (qreal x, qreal y, qreal w, qreal h)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a rectangle at position ({x}, {y}), with the given width and height, as a closed subpath.

void	addEllipse (const QRectF &rect)
	Creates an ellipse within the specified boundingRectangle and adds it to the painter path as a closed subpath.

void	addEllipse (qreal x, qreal y, qreal w, qreal h)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Creates an ellipse within the bounding rectangle defined by its top-left corner at (x, y), width and height, and adds it to the painter path as a closed subpath.

void	addEllipse (const QPointF &center, qreal rx, qreal ry)

void	addPolygon (const QPolygonF &polygon)
	Adds the given polygon to the path as an (unclosed) subpath.

void	addText (const QPointF &point, const QFont &f, const QString &text)
	Adds the given text to this path as a set of closed subpaths created from the font supplied.

void	addText (qreal x, qreal y, const QFont &f, const QString &text)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds the given text to this path as a set of closed subpaths created from the font supplied.

void	addPath (const QPainterPath &path)
	Adds the given path to this path as a closed subpath.

void	addRegion (const QRegion &region)
	Adds the given region to the path by adding each rectangle in the region as a separate closed subpath.

void	addRoundedRect (const QRectF &rect, qreal xRadius, qreal yRadius, Qt::SizeMode mode=Qt::AbsoluteSize)

void	addRoundedRect (qreal x, qreal y, qreal w, qreal h, qreal xRadius, qreal yRadius, Qt::SizeMode mode=Qt::AbsoluteSize)

void	connectPath (const QPainterPath &path)
	Connects the given path to this path by adding a line from the last element of this path to the first element of the given path.

bool	contains (const QPointF &pt) const
	Returns `true` if the given point is inside the path, otherwise returns `false`.

bool	contains (const QRectF &rect) const
	Returns `true` if the given rectangle is inside the path, otherwise returns `false`.

bool	intersects (const QRectF &rect) const
	Returns `true` if any point in the given rectangle intersects the path; otherwise returns `false`.

void	translate (qreal dx, qreal dy)
	Translates all elements in the path by ({dx}, {dy}).

void	translate (const QPointF &offset)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

QPainterPath	translated (qreal dx, qreal dy) const
	Returns a copy of the path that is translated by ({dx}, {dy}).

QPainterPath	translated (const QPointF &offset) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

QRectF	boundingRect () const
	Returns the bounding rectangle of this painter path as a rectangle with floating point precision.

QRectF	controlPointRect () const
	Returns the rectangle containing all the points and control points in this path.

Qt::FillRule	fillRule () const
	Returns the painter path's currently set fill rule.

void	setFillRule (Qt::FillRule fillRule)
	Sets the fill rule of the painter path to the given fillRule.

bool	isEmpty () const
	Returns `true` if either there are no elements in this path, or if the only element is a MoveToElement; otherwise returns `false`.

QPainterPath	toReversed () const
	Creates and returns a reversed copy of the path.

QList< QPolygonF >	toSubpathPolygons (const QTransform &matrix=QTransform()) const
	Converts the path into a list of polygons using the QTransform matrix, and returns the list.

QList< QPolygonF >	toFillPolygons (const QTransform &matrix=QTransform()) const
	Converts the path into a list of polygons using the QTransform matrix, and returns the list.

QPolygonF	toFillPolygon (const QTransform &matrix=QTransform()) const
	Converts the path into a polygon using the QTransform matrix, and returns the polygon.

int	elementCount () const
	Returns the number of path elements in the painter path.

QPainterPath::Element	elementAt (int i) const
	Returns the element at the given index in the painter path.

void	setElementPositionAt (int i, qreal x, qreal y)

qreal	length () const
	Returns the length of the current path.

qreal	percentAtLength (qreal t) const
	Returns percentage of the whole path at the specified length len.

QPointF	pointAtPercent (qreal t) const
	Returns the point at at the percentage t of the current path.

qreal	angleAtPercent (qreal t) const
	Returns the angle of the path tangent at the percentage t.

qreal	slopeAtPercent (qreal t) const
	Returns the slope of the path at the percentage t.

bool	intersects (const QPainterPath &p) const

bool	contains (const QPainterPath &p) const

QPainterPath	united (const QPainterPath &r) const

QPainterPath	intersected (const QPainterPath &r) const

QPainterPath	subtracted (const QPainterPath &r) const

QPainterPath	simplified () const

bool	operator== (const QPainterPath &other) const
	Returns `true` if this painterpath is equal to the given path.

bool	operator!= (const QPainterPath &other) const
	Returns `true` if this painter path differs from the given path.

QPainterPath	operator& (const QPainterPath &other) const

QPainterPath	operator\| (const QPainterPath &other) const

QPainterPath	operator+ (const QPainterPath &other) const

QPainterPath	operator- (const QPainterPath &other) const

QPainterPath &	operator&= (const QPainterPath &other)

QPainterPath &	operator\|= (const QPainterPath &other)

QPainterPath &	operator+= (const QPainterPath &other)

QPainterPath &	operator-= (const QPainterPath &other)

Friends
class	QPainterPathStroker

class	QPainterPathStrokerPrivate

class	QTransform

class	QVectorPath

Q_GUI_EXPORT const QVectorPath &	qtVectorPathForPath (const QPainterPath &)

Q_GUI_EXPORT QDataStream &	operator<< (QDataStream &, const QPainterPath &)
	Writes the given painter path to the given stream, and returns a reference to the stream.

Q_GUI_EXPORT QDataStream &	operator>> (QDataStream &, QPainterPath &)
	Reads a painter path from the given stream into the specified path, and returns a reference to the stream.

Related Symbols
(Note that these are not member symbols.)
QDataStream &	operator<< (QDataStream &stream, const QPainterPath &path)
	Writes the given painter path to the given stream, and returns a reference to the stream.

QDataStream &	operator>> (QDataStream &stream, QPainterPath &path)
	Reads a painter path from the given stream into the specified path, and returns a reference to the stream.

Detailed Description

\inmodule QtGui

The QPainterPath class provides a container for painting operations, enabling graphical shapes to be constructed and reused.

A painter path is an object composed of a number of graphical building blocks, such as rectangles, ellipses, lines, and curves. Building blocks can be joined in closed subpaths, for example as a rectangle or an ellipse. A closed path has coinciding start and end points. Or they can exist independently as unclosed subpaths, such as lines and curves.

A QPainterPath object can be used for filling, outlining, and clipping. To generate fillable outlines for a given painter path, use the QPainterPathStroker class. The main advantage of painter paths over normal drawing operations is that complex shapes only need to be created once; then they can be drawn many times using only calls to the QPainter::drawPath() function.

QPainterPath provides a collection of functions that can be used to obtain information about the path and its elements. In addition it is possible to reverse the order of the elements using the toReversed() function. There are also several functions to convert this painter path object into a polygon representation.

Definition at line 28 of file qpainterpath.h.

Member Enumeration Documentation

◆ ElementType

enum QPainterPath::ElementType

This enum describes the types of elements used to connect vertices in subpaths.

Note that elements added as closed subpaths using the addEllipse(), addPath(), addPolygon(), addRect(), addRegion() and addText() convenience functions, is actually added to the path as a collection of separate elements using the moveTo(), lineTo() and cubicTo() functions.

\value MoveToElement A new subpath. See also moveTo(). \value LineToElement A line. See also lineTo(). \value CurveToElement A curve. See also cubicTo() and quadTo(). \value CurveToDataElement The extra data required to describe a curve in a CurveToElement element.

See also: elementAt(), elementCount()

Enumerator
MoveToElement
LineToElement
CurveToElement
CurveToDataElement

Definition at line 31 of file qpainterpath.h.

Constructor & Destructor Documentation

◆ QPainterPath() [1/3]

QPainterPath::QPainterPath ( )

noexcept

Constructs an empty QPainterPath object.

Definition at line 500 of file qpainterpath.cpp.

Referenced by intersected(), and simplified().

Here is the caller graph for this function:

◆ QPainterPath() [2/3]

QPainterPath::QPainterPath ( const QPointF & startPoint )

explicit

Creates a QPainterPath object with the given startPoint as its current position.

Definition at line 519 of file qpainterpath.cpp.

◆ QPainterPath() [3/3]

QPainterPath::QPainterPath ( const QPainterPath & other )

default

Creates a QPainterPath object that is a copy of the given path.

See also: operator=()

◆ ~QPainterPath()

QPainterPath::~QPainterPath ( )

Destroys this QPainterPath object.

Definition at line 576 of file qpainterpath.cpp.

Member Function Documentation

◆ addEllipse() [1/3]

void QPainterPath::addEllipse	(	const QPointF &	center,
		qreal	rx,
		qreal	ry )

inline

Since: 4.4

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Creates an ellipse positioned at {center} with radii {rx} and {ry}, and adds it to the painter path as a closed subpath.

Definition at line 272 of file qpainterpath.h.

References rx(), and ry().

Here is the call graph for this function:

◆ addEllipse() [2/3]

void QPainterPath::addEllipse ( const QRectF & boundingRectangle )

Creates an ellipse within the specified boundingRectangle and adds it to the painter path as a closed subpath.

The ellipse is composed of a clockwise curve, starting and finishing at zero degrees (the 3 o'clock position).

\table 100% \row

\inlineimage qpainterpath-addellipse.png
QLinearGradient myGradient;

QPen myPen;

QRectF boundingRectangle;

QPainterPath myPath;

myPath.addEllipse(boundingRectangle);

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: arcTo(), QPainter::drawEllipse(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1097 of file qpainterpath.cpp.

References boundingRect(), cubicTo(), hasValidCoords(), QRectF::isNull(), moveTo(), qt_curves_for_arc(), qWarning, and QList< T >::size().

Referenced by QQC2::QWindowsStyle::drawPrimitive(), QSvgVisitorImpl::visitEllipseNode(), and src_gui_painting_qpainterpath::Wrapper::wrapper5().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addEllipse() [3/3]

void QPainterPath::addEllipse	(	qreal	x,
		qreal	y,
		qreal	w,
		qreal	h )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Creates an ellipse within the bounding rectangle defined by its top-left corner at (x, y), width and height, and adds it to the painter path as a closed subpath.

Definition at line 267 of file qpainterpath.h.

◆ addPath()

void QPainterPath::addPath ( const QPainterPath & path )

Adds the given path to this path as a closed subpath.

See also: connectPath(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1223 of file qpainterpath.cpp.

References d, MoveToElement, and other().

Referenced by QPathClipper::clip(), and qt_graphicsItem_shapeFromPath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addPolygon()

void QPainterPath::addPolygon ( const QPolygonF & polygon )

Adds the given polygon to the path as an (unclosed) subpath.

Note that the current position after the polygon has been added, is the last point in polygon. To draw a line back to the first point, use the closeSubpath() function.

\table 100% \row

\inlineimage qpainterpath-addpolygon.png
QLinearGradient myGradient;

QPen myPen;

QPolygonF myPolygon;

QPainterPath myPath;

myPath.addPolygon(myPolygon);

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: lineTo(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1063 of file qpainterpath.cpp.

References i, LineToElement, and moveTo().

Referenced by QSvgFeFilterPrimitive::clipToTransformedBounds(), QSvgMask::createMask(), QPolygon::intersected(), QPolygonF::intersected(), QPolygon::intersects(), QPolygonF::intersects(), QPolygon::subtracted(), QPolygonF::subtracted(), QPolygon::united(), QPolygonF::united(), and src_gui_painting_qpainterpath::Wrapper::wrapper4().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addRect() [1/2]

void QPainterPath::addRect ( const QRectF & rectangle )

Adds the given rectangle to this path as a closed subpath.

The rectangle is added as a clockwise set of lines. The painter path's current position after the rectangle has been added is at the top-left corner of the rectangle.

\table 100% \row

\inlineimage qpainterpath-addrectangle.png
QLinearGradient myGradient;

QPen myPen;

QRectF myRectangle;

QPainterPath myPath;

myPath.addRect(myRectangle);

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: addRegion(), lineTo(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1017 of file qpainterpath.cpp.

References hasValidCoords(), LineToElement, moveTo(), qWarning, QList< T >::size(), and QPainterPath::Element::x.

Referenced by addRegion(), addRoundedRect(), addSelectedRegionsToPath(), addText(), QPathClipper::clip(), QOutlineMapper::clipElements(), QGraphicsItem::clipPath(), QSvgFeFilterPrimitive::clipToTransformedBounds(), QSvgMask::createMask(), QTextLayout::draw(), QPainter::drawRects(), QPainter::drawRects(), QPdfEngine::drawRects(), QX11PaintEnginePrivate::fillPath(), QtPrivate::intersect_point(), QtPrivate::intersect_rect(), QGraphicsSceneIndexPrivate::itemCollidesWithPath(), QGraphicsWidget::paintWindowFrame(), qt_regionToPath(), QQuickContext2DCommandBuffer::strokeRect(), QGraphicsPixmapItemPrivate::updateShape(), and src_gui_painting_qpainterpath::Wrapper::wrapper3().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addRect() [2/2]

void QPainterPath::addRect	(	qreal	x,
		qreal	y,
		qreal	w,
		qreal	h )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a rectangle at position ({x}, {y}), with the given width and height, as a closed subpath.

Definition at line 277 of file qpainterpath.h.

References addRect().

Here is the call graph for this function:

◆ addRegion()

void QPainterPath::addRegion ( const QRegion & region )

Adds the given region to the path by adding each rectangle in the region as a separate closed subpath.

See also: addRect(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1292 of file qpainterpath.cpp.

References addRect(), and rect.

Referenced by QWindowsDirect2DPaintEngine::begin().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addRoundedRect() [1/2]

void QPainterPath::addRoundedRect	(	const QRectF &	rect,
		qreal	xRadius,
		qreal	yRadius,
		Qt::SizeMode	mode = Qt::AbsoluteSize )

Since: 4.4

Adds the given rectangle rect with rounded corners to the path.

The xRadius and yRadius arguments specify the radii of the ellipses defining the corners of the rounded rectangle. When mode is Qt::RelativeSize, xRadius and yRadius are specified in percentage of half the rectangle's width and height respectively, and should be in the range 0.0 to 100.0.

See also: addRect()

Definition at line 3108 of file qpainterpath.cpp.

References Qt::AbsoluteSize, addRect(), arcMoveTo(), arcTo(), closeSubpath(), QRectF::normalized(), qMin(), rect, QList< T >::size(), and QRectF::width().

Referenced by QtWaylandClient::QWaylandBradientDecoration::paint().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addRoundedRect() [2/2]

void QPainterPath::addRoundedRect	(	qreal	x,
		qreal	y,
		qreal	w,
		qreal	h,
		qreal	xRadius,
		qreal	yRadius,
		Qt::SizeMode	mode = Qt::AbsoluteSize )

inline

Since: 4.4 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Adds the given rectangle x, y, w, h with rounded corners to the path.

Definition at line 282 of file qpainterpath.h.

◆ addText() [1/2]

void QPainterPath::addText	(	const QPointF &	point,
		const QFont &	font,
		const QString &	text )

Adds the given text to this path as a set of closed subpaths created from the font supplied.

The subpaths are positioned so that the left end of the text's baseline lies at the specified point.

Some fonts may yield overlapping subpaths and will require the Qt::WindingFill fill rule for correct rendering.

\table 100% \row

\inlineimage qpainterpath-addtext.png
QLinearGradient myGradient;

QPen myPen;

QFont myFont;

QPointF baseline(x, y);

QPainterPath myPath;

myPath.addText(baseline, myFont, tr("Qt"));

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: QPainter::drawText(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}, setFillRule()

Definition at line 1149 of file qpainterpath.cpp.

References addRect(), QScriptItem::analysis, QList< T >::at(), QScriptAnalysis::bidiLevel, QTextEngine::bidiReorder(), QScriptAnalysis::flags, QTextEngine::fontEngine(), i, QString::isEmpty(), item, QTextEngine::LayoutData::items, layout, QTextEngine::layoutData, line, QTextEngine::lines, opt, pos, Q_ASSERT, Q_UNUSED, QTextItem::RightToLeft, QTextEngine::shapedGlyphs(), QList< T >::size(), QScriptAnalysis::TabOrObject, text, QFixed::toReal(), QScriptItem::width, QPointF::x(), and QPointF::y().

Referenced by QQuickContext2D::createTextGlyphs(), and src_gui_painting_qpainterpath::Wrapper::wrapper6().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addText() [2/2]

void QPainterPath::addText	(	qreal	x,
		qreal	y,
		const QFont &	font,
		const QString &	text )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds the given text to this path as a set of closed subpaths created from the font supplied.

The subpaths are positioned so that the left end of the text's baseline lies at the point specified by (x, y).

Definition at line 289 of file qpainterpath.h.

References addText(), and text.

Here is the call graph for this function:

◆ angleAtPercent()

qreal QPainterPath::angleAtPercent ( qreal t ) const

Returns the angle of the path tangent at the percentage t.

The argument t has to be between 0 and 1.

Positive values for the angles mean counter-clockwise while negative values mean the clockwise direction. Zero degrees is at the 3 o'clock position.

Note that similarly to the other percent methods, the percentage measurement is not linear with regards to the length if curves are present in the path. When curves are present the percentage argument is mapped to the t parameter of the Bezier equations.

Definition at line 3030 of file qpainterpath.cpp.

References QLineF::angle(), bezierAtT(), length(), qWarning, and slopeAt().

Here is the call graph for this function:

◆ arcMoveTo() [1/2]

void QPainterPath::arcMoveTo	(	const QRectF &	rectangle,
		qreal	angle )

Since: 4.2

Creates a move to that lies on the arc that occupies the given rectangle at angle.

Angles are specified in degrees. Clockwise arcs can be specified using negative angles.

See also: moveTo(), arcTo()

Definition at line 964 of file qpainterpath.cpp.

References moveTo(), qt_find_ellipse_coords(), and rect.

Referenced by addRoundedRect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ arcMoveTo() [2/2]

void QPainterPath::arcMoveTo	(	qreal	x,
		qreal	y,
		qreal	width,
		qreal	height,
		qreal	angle )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 4.2

Creates a move to that lies on the arc that occupies the QRectF(x, y, width, height) at angle.

Definition at line 250 of file qpainterpath.h.

◆ arcTo() [1/2]

void QPainterPath::arcTo	(	const QRectF &	rectangle,
		qreal	startAngle,
		qreal	sweepLength )

Creates an arc that occupies the given rectangle, beginning at the specified startAngle and extending sweepLength degrees counter-clockwise.

Angles are specified in degrees. Clockwise arcs can be specified using negative angles.

Note that this function connects the starting point of the arc to the current position if they are not already connected. After the arc has been added, the current position is the last point in arc. To draw a line back to the first point, use the closeSubpath() function.

\table 100% \row

\inlineimage qpainterpath-arcto.png
QPainterPath myPath;

myPath.moveTo(center);

myPath.arcTo(boundingRect, startAngle,

sweepLength);

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: arcMoveTo(), addEllipse(), QPainter::drawArc(), QPainter::drawPie(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 907 of file qpainterpath.cpp.

References cubicTo(), hasValidCoords(), i, isValidCoord(), lineTo(), qt_curves_for_arc(), qWarning, and rect.

Referenced by addRoundedRect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ arcTo() [2/2]

void QPainterPath::arcTo	(	qreal	x,
		qreal	y,
		qreal	w,
		qreal	h,
		qreal	startAngle,
		qreal	arcLength )

inline

Definition at line 245 of file qpainterpath.h.

◆ boundingRect()

QRectF QPainterPath::boundingRect ( ) const

Returns the bounding rectangle of this painter path as a rectangle with floating point precision.

See also: controlPointRect()

Definition at line 1448 of file qpainterpath.cpp.

References d.

Referenced by addEllipse(), boundsOnStroke(), QPathClipper::clip(), QPainterPrivate::draw_helper(), operator==(), QGraphicsPathItem::setPath(), QGeoMapPolylineGeometry::updateSourcePoints(), and QGeoMapPolygonGeometry::updateSourcePoints().

Here is the caller graph for this function:

◆ capacity()

int QPainterPath::capacity ( ) const

Returns the number of elements allocated by the QPainterPath.

See also: clear(), reserve()

Since: 5.13

Definition at line 622 of file qpainterpath.cpp.

References d.

◆ clear()

void QPainterPath::clear ( )

Clears the path elements stored.

This allows the path to reuse previous memory allocations.

See also: reserve(), capacity()

Since: 5.13

Definition at line 588 of file qpainterpath.cpp.

References QList< T >::append(), QPainterPathPrivate::clear(), and MoveToElement.

Here is the call graph for this function:

◆ closeSubpath()

void QPainterPath::closeSubpath ( )

Closes the current subpath by drawing a line to the beginning of the subpath, automatically starting a new path.

The current point of the new path is (0, 0).

If the subpath does not contain any elements, this function does nothing.

See also: moveTo(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 642 of file qpainterpath.cpp.

References QPainterPathPrivate::close(), and isEmpty().

Referenced by addRoundedRect(), QQuickContext2D::clip(), and QGeoMapPolygonGeometry::updateSourcePoints().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ connectPath()

void QPainterPath::connectPath ( const QPainterPath & path )

Connects the given path to this path by adding a line from the last element of this path to the first element of the given path.

See also: addPath(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 1254 of file qpainterpath.cpp.

References d, LineToElement, MoveToElement, and other().

Here is the call graph for this function:

◆ contains() [1/3]

bool QPainterPath::contains ( const QPainterPath & p ) const

Since: 4.3

Returns true if the given path p is contained within the current path. Returns false if any edges of the current path and p intersect.

Set operations on paths will treat the paths as areas. Non-closed paths will be treated as implicitly closed.

See also: intersects()

Definition at line 3277 of file qpainterpath.cpp.

References contains(), and isEmpty().

Here is the call graph for this function:

◆ contains() [2/3]

bool QPainterPath::contains ( const QPointF & point ) const

Returns true if the given point is inside the path, otherwise returns false.

See also: intersects()

Definition at line 1795 of file qpainterpath.cpp.

References contains(), controlPointRect(), CurveToElement, d, QBezier::fromPoints(), i, isEmpty(), LineToElement, MoveToElement, qt_painterpath_isect_curve(), qt_painterpath_isect_line(), QPainterPath::Element::type, and Qt::WindingFill.

Referenced by QPathClipper::contains(), contains(), QGraphicsItem::contains(), contains(), contains(), QPathClipper::intersect(), intersects(), and intersects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ contains() [3/3]

bool QPainterPath::contains ( const QRectF & rect ) const

Returns true if the given rectangle is inside the path, otherwise returns false.

Definition at line 2168 of file qpainterpath.cpp.

References QStringView::at(), contains(), controlPointRect(), CurveToElement, d, el, fillRule(), i, isEmpty(), LineToElement, MoveToElement, Qt::OddEvenFill, qt_painterpath_check_crossing(), rect, and QPainterPath::Element::type.

Here is the call graph for this function:

◆ controlPointRect()

QRectF QPainterPath::controlPointRect ( ) const

Returns the rectangle containing all the points and control points in this path.

This function is significantly faster to compute than the exact boundingRect(), and the returned rectangle is always a superset of the rectangle returned by boundingRect().

See also: boundingRect()

Definition at line 1469 of file qpainterpath.cpp.

References d.

Referenced by QAlphaPaintEnginePrivate::addPenWidth(), QGraphicsPathItem::boundingRect(), QGraphicsEllipseItem::boundingRect(), QGraphicsPolygonItem::boundingRect(), QGraphicsLineItem::boundingRect(), QPathClipper::contains(), contains(), contains(), QSvgPath::fastBounds(), QPathClipper::intersect(), and intersects().

Here is the caller graph for this function:

◆ cubicTo() [1/2]

void QPainterPath::cubicTo	(	const QPointF &	c1,
		const QPointF &	c2,
		const QPointF &	endPoint )

Adds a cubic Bezier curve between the current position and the given endPoint using the control points specified by c1, and c2.

After the curve is added, the current position is updated to be at the end point of the curve.

\table 100% \row

\inlineimage qpainterpath-cubicto.png
QLinearGradient myGradient;

QPen myPen;

QPainterPath myPath;

myPath.cubicTo(c1, c2, endPoint);

QPainter painter(this);

painter.setBrush(myGradient);

painter.setPen(myPen);

painter.drawPath(myPath);

\endtable

See also: quadTo(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 780 of file qpainterpath.cpp.

References c2, CurveToDataElement, CurveToElement, d, hasValidCoords(), Q_ASSERT, qWarning, QPointF::x(), and QPointF::y().

Referenced by addEllipse(), arcTo(), quadTo(), and src_gui_painting_qpainterpath::Wrapper::wrapper1().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cubicTo() [2/2]

void QPainterPath::cubicTo	(	qreal	ctrlPt1x,
		qreal	ctrlPt1y,
		qreal	ctrlPt2x,
		qreal	ctrlPt2y,
		qreal	endPtx,
		qreal	endPty )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a cubic Bezier curve between the current position and the end point ({endPointX}, {endPointY}) with control points specified by ({c1X}, {c1Y}) and ({c2X}, {c2Y}).

Definition at line 255 of file qpainterpath.h.

◆ currentPosition()

QPointF QPainterPath::currentPosition ( ) const

Returns the current position of the path.

Definition at line 981 of file qpainterpath.cpp.

References elements, and QList< T >::isEmpty().

Here is the call graph for this function:

◆ elementAt()

QPainterPath::Element QPainterPath::elementAt ( int index ) const

Returns the element at the given index in the painter path.

See also: ElementType, elementCount(), isEmpty()

Definition at line 464 of file qpainterpath.cpp.

References QList< T >::at(), elementCount(), i, and Q_ASSERT.

Referenced by QPathClipper::contains(), QPathClipper::intersect(), intersects(), and operator==().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ elementCount()

int QPainterPath::elementCount ( ) const

Returns the number of path elements in the painter path.

See also: ElementType, elementAt(), isEmpty()

Definition at line 451 of file qpainterpath.cpp.

References QList< T >::size().

Referenced by QPathClipper::contains(), elementAt(), QPathClipper::intersect(), intersects(), quadTo(), setElementPositionAt(), toSubpathPolygons(), and SvgDebugVisitor::visitPathNode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fillRule()

Qt::FillRule QPainterPath::fillRule ( ) const

Returns the painter path's currently set fill rule.

See also: setFillRule()

Definition at line 1307 of file qpainterpath.cpp.

References Qt::OddEvenFill.

Referenced by QPathClipper::QPathClipper(), QPathClipper::clip(), contains(), QQuickItemGenerator::outputShapePath(), QQuickQmlGenerator::outputShapePath(), setFillRule(), and QX11PaintEngine::updateState().

Here is the caller graph for this function:

◆ intersected()

QPainterPath QPainterPath::intersected ( const QPainterPath & p ) const

Since: 4.3

Returns a path which is the intersection of this path's fill area and p's fill area. Bezier curves may be flattened to line segments due to numerical instability of doing bezier curve intersections.

Definition at line 3201 of file qpainterpath.cpp.

References QPainterPath(), QPathClipper::BoolAnd, and isEmpty().

Referenced by QQuickContext2D::clip(), QOutlineMapper::clipElements(), QGraphicsItem::clipPath(), QPolygon::intersected(), QPolygonF::intersected(), and operator&().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ intersects() [1/2]

bool QPainterPath::intersects ( const QPainterPath & p ) const

Since: 4.3

Returns true if the current path intersects at any point the given path p. Also returns true if the current path contains or is contained by any part of p.

Set operations on paths will treat the paths as areas. Non-closed paths will be treated as implicitly closed.

See also: contains()

Definition at line 3255 of file qpainterpath.cpp.

References contains(), and isEmpty().

Here is the call graph for this function:

◆ intersects() [2/2]

bool QPainterPath::intersects ( const QRectF & rectangle ) const

Returns true if any point in the given rectangle intersects the path; otherwise returns false.

There is an intersection if any of the lines making up the rectangle crosses a part of the path or if any part of the rectangle overlaps with any area enclosed by the path. This function respects the current fillRule to determine what is considered inside the path.

See also: contains()

Definition at line 2067 of file qpainterpath.cpp.

References QRectF::bottom(), contains(), controlPointRect(), d, elementAt(), elementCount(), i, isEmpty(), QRectF::left(), MoveToElement, QRectF::normalized(), qMax(), qMin(), qt_painterpath_check_crossing(), rect, QRectF::right(), QRectF::top(), and QPainterPath::Element::type.

Referenced by QPathClipper::intersect(), QPolygon::intersects(), and QPolygonF::intersects().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isEmpty()

bool QPainterPath::isEmpty ( ) const

Returns true if either there are no elements in this path, or if the only element is a MoveToElement; otherwise returns false.

See also: elementCount()

Definition at line 1490 of file qpainterpath.cpp.

References QList< T >::constFirst(), MoveToElement, QList< T >::size(), and QPainterPath::Element::type.

Referenced by QGraphicsItem::clipPath(), closeSubpath(), contains(), contains(), contains(), QPainterPrivate::draw_helper(), QX11PaintEngine::drawPath(), intersected(), intersects(), intersects(), length(), operator==(), percentAtLength(), simplified(), QWin32PrintEnginePrivate::strokePath(), subtracted(), toReversed(), toSubpathPolygons(), and united().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ length()

qreal QPainterPath::length ( ) const

Returns the length of the current path.

Definition at line 2836 of file qpainterpath.cpp.

References CurveToElement, d, QBezier::fromPoints(), i, isEmpty(), QLineF::length(), LineToElement, MoveToElement, and QPainterPath::Element::type.

Referenced by angleAtPercent(), percentAtLength(), pointAtPercent(), and slopeAtPercent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lineTo() [1/2]

void QPainterPath::lineTo ( const QPointF & endPoint )

Adds a straight line from the current position to the given endPoint.

After the line is drawn, the current position is updated to be at the end point of the line.

See also: addPolygon(), addRect(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 722 of file qpainterpath.cpp.

References d, hasValidCoords(), LineToElement, Q_ASSERT, qWarning, and QPainterPath::Element::x.

Referenced by arcTo(), QQC2::QCommonStyle::drawPrimitive(), QCommonStyle::drawPrimitive(), QGeoMapPolylineGeometry::updateSourcePoints(), and QGeoMapPolygonGeometry::updateSourcePoints().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lineTo() [2/2]

void QPainterPath::lineTo	(	qreal	x,
		qreal	y )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Draws a line from the current position to the point ({x}, {y}).

Definition at line 240 of file qpainterpath.h.

◆ moveTo() [1/2]

void QPainterPath::moveTo ( const QPointF & point )

Moves the current point to the given point, implicitly starting a new subpath and closing the previous one.

See also: closeSubpath(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 672 of file qpainterpath.cpp.

References d, hasValidCoords(), MoveToElement, Q_ASSERT, qWarning, and QPainterPath::Element::x.

Referenced by addEllipse(), addPolygon(), addRect(), arcMoveTo(), convertCGPathToQPainterPath(), QPainter::drawLines(), QPainter::drawLines(), QPdfEngine::drawLines(), QPdfEngine::drawPoints(), QQC2::QCommonStyle::drawPrimitive(), QCommonStyle::drawPrimitive(), qt_painterPathFromVectorPath(), toReversed(), QGeoMapPolylineGeometry::updateSourcePoints(), QGeoMapPolygonGeometry::updateSourcePoints(), QSvgVisitorImpl::visitLineNode(), QSvgVisitorImpl::visitRectNode(), and src_gui_painting_qpainterpath::Wrapper::wrapper2().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ moveTo() [2/2]

void QPainterPath::moveTo	(	qreal	x,
		qreal	y )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Moves the current position to ({x}, {y}) and starts a new subpath, implicitly closing the previous path.

Definition at line 235 of file qpainterpath.h.

◆ operator!=()

bool QPainterPath::operator!= ( const QPainterPath & path ) const

Returns true if this painter path differs from the given path.

Note that comparing paths may involve a per element comparison which can be slow for complex paths.

See also: operator==()

Definition at line 2298 of file qpainterpath.cpp.

◆ operator&()

QPainterPath QPainterPath::operator& ( const QPainterPath & other ) const

Since: 4.5

Returns the intersection of this path and the other path.

See also: intersected(), operator&=(), united(), operator|()

Definition at line 2310 of file qpainterpath.cpp.

References intersected(), and other().

Here is the call graph for this function:

◆ operator&=()

QPainterPath & QPainterPath::operator&= ( const QPainterPath & other )

Since: 4.5

Intersects this path with other and returns a reference to this path.

See also: intersected(), operator&(), operator|=()

Definition at line 2359 of file qpainterpath.cpp.

References other().

Here is the call graph for this function:

◆ operator+()

QPainterPath QPainterPath::operator+ ( const QPainterPath & other ) const

Since: 4.5

Returns the union of this path and the other path. This function is equivalent to operator|().

See also: united(), operator+=(), operator-()

Definition at line 2335 of file qpainterpath.cpp.

References other(), and united().

Here is the call graph for this function:

◆ operator+=()

QPainterPath & QPainterPath::operator+= ( const QPainterPath & other )

Since: 4.5

Unites this path with other, and returns a reference to this path. This is equivalent to operator|=().

See also: united(), operator+(), operator-=()

Definition at line 2384 of file qpainterpath.cpp.

References other().

Here is the call graph for this function:

◆ operator-()

QPainterPath QPainterPath::operator- ( const QPainterPath & other ) const

Since: 4.5

Subtracts the other path from a copy of this path, and returns the copy.

See also: subtracted(), operator-=(), operator+()

Definition at line 2347 of file qpainterpath.cpp.

References other(), and subtracted().

Here is the call graph for this function:

◆ operator-=()

QPainterPath & QPainterPath::operator-= ( const QPainterPath & other )

Since: 4.5

Subtracts other from this path, and returns a reference to this path.

See also: subtracted(), operator-(), operator+=()

Definition at line 2397 of file qpainterpath.cpp.

References other().

Here is the call graph for this function:

◆ operator=()

QPainterPath & QPainterPath::operator= ( const QPainterPath & path )

Assigns the given path to this painter path.

Move-assigns other to this QPainterPath instance.

See also: QPainterPath()

Since: 5.2

Definition at line 550 of file qpainterpath.cpp.

References copy(), other(), and swap().

Here is the call graph for this function:

◆ operator==()

bool QPainterPath::operator== ( const QPainterPath & path ) const

Returns true if this painterpath is equal to the given path.

Note that comparing paths may involve a per element comparison which can be slow for complex paths.

See also: operator!=()

Definition at line 2257 of file qpainterpath.cpp.

References boundingRect(), d, elementAt(), epsilon, epsilonCompare(), i, isEmpty(), Qt::OddEvenFill, and QRectF::size().

Here is the call graph for this function:

◆ operator|()

QPainterPath QPainterPath::operator| ( const QPainterPath & other ) const

Since: 4.5

Returns the union of this path and the other path.

See also: united(), operator|=(), intersected(), operator&()

Definition at line 2322 of file qpainterpath.cpp.

References other(), and united().

Here is the call graph for this function:

◆ operator|=()

QPainterPath & QPainterPath::operator|= ( const QPainterPath & other )

Since: 4.5

Unites this path with other and returns a reference to this path.

See also: united(), operator|(), operator&=()

Definition at line 2371 of file qpainterpath.cpp.

References other().

Here is the call graph for this function:

◆ percentAtLength()

qreal QPainterPath::percentAtLength ( qreal len ) const

Returns percentage of the whole path at the specified length len.

Note that similarly to other percent methods, the percentage measurement is not linear with regards to the length, if curves are present in the path. When curves are present the percentage argument is mapped to the t parameter of the Bezier equations.

Definition at line 2879 of file qpainterpath.cpp.

References CurveToElement, d, QBezier::fromPoints(), i, isEmpty(), length(), QString::length(), line, LineToElement, MoveToElement, and QPainterPath::Element::type.

Here is the call graph for this function:

◆ pointAtPercent()

QPointF QPainterPath::pointAtPercent ( qreal t ) const

Returns the point at at the percentage t of the current path.

The argument t has to be between 0 and 1.

Note that similarly to other percent methods, the percentage measurement is not linear with regards to the length, if curves are present in the path. When curves are present the percentage argument is mapped to the t parameter of the Bezier equations.

Definition at line 2996 of file qpainterpath.cpp.

References QList< T >::at(), bezierAtT(), length(), qBound(), qWarning, and QList< T >::size().

Referenced by QSvgMarker::drawMarkersForNode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ quadTo() [1/2]

void QPainterPath::quadTo	(	const QPointF &	c,
		const QPointF &	endPoint )

Adds a quadratic Bezier curve between the current position and the given endPoint with the control point specified by c.

After the curve is added, the current point is updated to be at the end point of the curve.

See also: cubicTo(), {QPainterPath::Composing a QPainterPath}{Composing a QPainterPath}

Definition at line 836 of file qpainterpath.cpp.

References c2, cubicTo(), d, elementCount(), hasValidCoords(), Q_ASSERT, qWarning, QPointF::x(), and QPointF::y().

Here is the call graph for this function:

◆ quadTo() [2/2]

void QPainterPath::quadTo	(	qreal	ctrlPtx,
		qreal	ctrlPty,
		qreal	endPtx,
		qreal	endPty )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Adds a quadratic Bezier curve between the current point and the endpoint ({endPointX}, {endPointY}) with the control point specified by ({cx}, {cy}).

Definition at line 262 of file qpainterpath.h.

◆ reserve()

void QPainterPath::reserve ( int size )

Reserves a given amount of elements in QPainterPath's internal memory.

Attempts to allocate memory for at least size elements.

See also: clear(), capacity(), QList::reserve()

Since: 5.13

Definition at line 606 of file qpainterpath.cpp.

References d, and QList< T >::reserve().

Referenced by QQuadPath::toPainterPath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setElementPositionAt()

void QPainterPath::setElementPositionAt	(	int	index,
		qreal	x,
		qreal	y )

Since: 4.2

Sets the x and y coordinate of the element at index index to x and y.

Definition at line 479 of file qpainterpath.cpp.

References elementCount(), i, Q_ASSERT, QPainterPath::Element::x, and QPainterPath::Element::y.

Here is the call graph for this function:

◆ setFillRule()

void QPainterPath::setFillRule ( Qt::FillRule fillRule )

Sets the fill rule of the painter path to the given fillRule.

Qt provides two methods for filling paths:

\table \header

Qt::OddEvenFill (default)
Qt::WindingFill \row
\inlineimage qt-fillrule-oddeven.png
\inlineimage qt-fillrule-winding.png \endtable

See also: fillRule()

Definition at line 1329 of file qpainterpath.cpp.

References fillRule().

Referenced by QSvgFeFilterPrimitive::clipToTransformedBounds(), QSvgMask::createMask(), createPathNode(), QPainterPathStroker::createStroke(), QTextLayout::draw(), QSvgPath::drawCommand(), QMacStylePrivate::drawFocusRing(), QX11PaintEngine::drawPath(), QPdfEngine::drawPolygon(), and QSGCurveProcessor::processFill().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ simplified()

QPainterPath QPainterPath::simplified ( ) const

Since: 4.4

Returns a simplified version of this path. This implies merging all subpaths that intersect, and returning a path containing no intersecting edges. Consecutive parallel lines will also be merged. The simplified path will always use the default fill rule, Qt::OddEvenFill. Bezier curves may be flattened to line segments due to numerical instability of doing bezier curve intersections.

Definition at line 3236 of file qpainterpath.cpp.

References QPainterPath(), isEmpty(), and QPathClipper::Simplify.

Referenced by QPathClipper::clip(), and QGeoMapPolygonGeometry::updateSourcePoints().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ slopeAtPercent()

qreal QPainterPath::slopeAtPercent ( qreal t ) const

Returns the slope of the path at the percentage t.

The argument t has to be between 0 and 1.

Note that similarly to other percent methods, the percentage measurement is not linear with regards to the length, if curves are present in the path. When curves are present the percentage argument is mapped to the t parameter of the Bezier equations.

Definition at line 3059 of file qpainterpath.cpp.

References bezierAtT(), length(), qWarning, and slopeAt().

Here is the call graph for this function:

◆ subtracted()

QPainterPath QPainterPath::subtracted ( const QPainterPath & p ) const

Since: 4.3

Returns a path which is p's fill area subtracted from this path's fill area.

Set operations on paths will treat the paths as areas. Non-closed paths will be treated as implicitly closed. Bezier curves may be flattened to line segments due to numerical instability of doing bezier curve intersections.

Definition at line 3219 of file qpainterpath.cpp.

References QPathClipper::BoolSub, and isEmpty().

Referenced by operator-(), QPolygon::subtracted(), and QPolygonF::subtracted().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ swap()

void QPainterPath::swap ( QPainterPath & other )

inlinenoexcept

Since: 4.8

Swaps painter path other with this painter path. This operation is very fast and never fails.

Definition at line 62 of file qpainterpath.h.

References other(), and swap().

Referenced by operator=(), and swap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toFillPolygon()

QPolygonF QPainterPath::toFillPolygon ( const QTransform & matrix = QTransform() ) const

Converts the path into a polygon using the QTransform matrix, and returns the polygon.

The polygon is created by first converting all subpaths to polygons, then using a rewinding technique to make sure that overlapping subpaths can be filled using the correct fill rule.

Note that rewinding inserts addition lines in the polygon so the outline of the fill polygon does not match the outline of the path.

See also: toSubpathPolygons(), toFillPolygons(), {QPainterPath::QPainterPath Conversion}{QPainterPath Conversion}

Definition at line 2810 of file qpainterpath.cpp.

References i, and toSubpathPolygons().

Referenced by QPolygon::intersected(), QPolygonF::intersected(), QPolygon::subtracted(), QPolygonF::subtracted(), QX11PaintEnginePrivate::systemStateChanged(), QPolygon::united(), QPolygonF::united(), and QX11PaintEngine::updateState().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toFillPolygons()

QList< QPolygonF > QPainterPath::toFillPolygons ( const QTransform & matrix = QTransform() ) const

Converts the path into a list of polygons using the QTransform matrix, and returns the list.

The function differs from the toFillPolygon() function in that it creates several polygons. It is provided because it is usually faster to draw several small polygons than to draw one large polygon, even though the total number of points drawn is the same.

The toFillPolygons() function differs from the toSubpathPolygons() function in that it create only polygon for subpaths that have overlapping bounding rectangles.

Like the toFillPolygon() function, this function uses a rewinding technique to make sure that overlapping subpaths can be filled using the correct fill rule. Note that rewinding inserts addition lines in the polygons so the outline of the fill polygon does not match the outline of the path.

See also: toSubpathPolygons(), toFillPolygon(), {QPainterPath::QPainterPath Conversion}{QPainterPath Conversion}

Definition at line 1624 of file qpainterpath.cpp.

References QList< T >::at(), i, j, qDebug, and toSubpathPolygons().

Here is the call graph for this function:

◆ toReversed()

QPainterPath QPainterPath::toReversed ( ) const

Creates and returns a reversed copy of the path.

It is the order of the elements that is reversed: If a QPainterPath is composed by calling the moveTo(), lineTo() and cubicTo() functions in the specified order, the reversed copy is composed by calling cubicTo(), lineTo() and moveTo().

Definition at line 1503 of file qpainterpath.cpp.

References CurveToDataElement, CurveToElement, d, i, isEmpty(), LineToElement, moveTo(), MoveToElement, Q_ASSERT, sp, QPainterPath::Element::type, QPainterPath::Element::x, and QPainterPath::Element::y.

Here is the call graph for this function:

◆ toSubpathPolygons()

QList< QPolygonF > QPainterPath::toSubpathPolygons ( const QTransform & matrix = QTransform() ) const

Converts the path into a list of polygons using the QTransform matrix, and returns the list.

This function creates one polygon for each subpath regardless of intersecting subpaths (i.e. overlapping bounding rectangles). To make sure that such overlapping subpaths are filled correctly, use the toFillPolygons() function instead.

See also: toFillPolygons(), toFillPolygon(), {QPainterPath::QPainterPath Conversion}{QPainterPath Conversion}

Definition at line 1557 of file qpainterpath.cpp.

References QBezier::addToPolygon(), QList< T >::clear(), CurveToDataElement, CurveToElement, d, elementCount(), QBezier::fromPoints(), i, isEmpty(), LineToElement, MoveToElement, Q_ASSERT, QList< T >::reserve(), QList< T >::size(), QPainterPath::Element::type, QPainterPath::Element::x, and QPainterPath::Element::y.

Referenced by toFillPolygon(), and toFillPolygons().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ translate() [1/2]

void QPainterPath::translate ( const QPointF & offset )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 4.6

Translates all elements in the path by the given offset.

See also: translated()

Definition at line 294 of file qpainterpath.h.

References translate().

Here is the call graph for this function:

◆ translate() [2/2]

void QPainterPath::translate	(	qreal	dx,
		qreal	dy )

Translates all elements in the path by ({dx}, {dy}).

Since: 4.6

See also: translated()

Definition at line 2110 of file qpainterpath.cpp.

References QList< T >::data(), Q_ASSERT, QList< T >::size(), QPainterPath::Element::x, and QPainterPath::Element::y.

Referenced by QDistanceField::setGlyph(), QDeclarativeCircleMapItemPrivateCPU::updatePolish(), QDeclarativePolygonMapItemPrivateCPU::updatePolish(), QDeclarativePolylineMapItemPrivateCPU::updatePolish(), and QDeclarativeRectangleMapItemPrivateCPU::updatePolish().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ translated() [1/2]

QPainterPath QPainterPath::translated ( const QPointF & offset ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 4.6

Returns a copy of the path that is translated by the given offset.

See also: translate()

Definition at line 297 of file qpainterpath.h.

◆ translated() [2/2]

QPainterPath QPainterPath::translated	(	qreal	dx,
		qreal	dy ) const

Returns a copy of the path that is translated by ({dx}, {dy}).

Since: 4.6

See also: translate()

Definition at line 2145 of file qpainterpath.cpp.

References copy().

Referenced by QtPrivate::intersect_path().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ united()

QPainterPath QPainterPath::united ( const QPainterPath & p ) const

Since: 4.3

Returns a path which is the union of this path's fill area and p's fill area.

Set operations on paths will treat the paths as areas. Non-closed paths will be treated as implicitly closed. Bezier curves may be flattened to line segments due to numerical instability of doing bezier curve intersections.

See also: intersected(), subtracted()

Definition at line 3186 of file qpainterpath.cpp.

References QPathClipper::BoolOr, and isEmpty().

Referenced by operator+(), operator|(), QPolygon::united(), and QPolygonF::united().

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Symbol Documentation

◆ operator<< [1/2]

QDataStream & operator<<	(	QDataStream &	stream,
		const QPainterPath &	path )

friend

Writes the given painter path to the given stream, and returns a reference to the stream.

See also: {Serializing Qt Data Types}

Definition at line 2412 of file qpainterpath.cpp.

◆ operator<<() [2/2]

QDataStream & operator<<	(	QDataStream &	stream,
		const QPainterPath &	path )

See also: {Serializing Qt Data Types}

Definition at line 2412 of file qpainterpath.cpp.

◆ operator>> [1/2]

QDataStream & operator>>	(	QDataStream &	stream,
		QPainterPath &	path )

friend

Reads a painter path from the given stream into the specified path, and returns a reference to the stream.

See also: {Serializing Qt Data Types}

Definition at line 2439 of file qpainterpath.cpp.

◆ operator>>() [2/2]

QDataStream & operator>>	(	QDataStream &	stream,
		QPainterPath &	path )

See also: {Serializing Qt Data Types}

Definition at line 2439 of file qpainterpath.cpp.

◆ QPainterPathStroker

friend class QPainterPathStroker

friend

Definition at line 175 of file qpainterpath.h.

◆ QPainterPathStrokerPrivate

friend class QPainterPathStrokerPrivate

friend

Definition at line 176 of file qpainterpath.h.

◆ QTransform

friend class QTransform

friend

Definition at line 177 of file qpainterpath.h.

◆ qtVectorPathForPath

Q_GUI_EXPORT const QVectorPath & qtVectorPathForPath ( const QPainterPath & )

friend

Definition at line 95 of file qpaintengineex.cpp.

◆ QVectorPath

friend class QVectorPath

friend

Definition at line 178 of file qpainterpath.h.

The documentation for this class was generated from the following files:

qtbase/src/gui/painting/qpainterpath.h (05fc3aef53348fb58be6308076e000825b704e58)
qtbase/src/gui/painting/qpainterpath.cpp (2925683268ca9d8dc6811f8f64c50ca488b27acc)

Classes

Public Types

Public Member Functions

Friends

Related Symbols

Detailed Description

Member Enumeration Documentation

◆ ElementType

Constructor & Destructor Documentation

◆ QPainterPath() [1/3]

◆ QPainterPath() [2/3]

◆ QPainterPath() [3/3]

◆ ~QPainterPath()

Member Function Documentation

◆ addEllipse() [1/3]

◆ addEllipse() [2/3]

◆ addEllipse() [3/3]

◆ addPath()

◆ addPolygon()

◆ addRect() [1/2]

◆ addRect() [2/2]

◆ addRegion()

◆ addRoundedRect() [1/2]

◆ addRoundedRect() [2/2]

◆ addText() [1/2]

◆ addText() [2/2]

◆ angleAtPercent()

◆ arcMoveTo() [1/2]

◆ arcMoveTo() [2/2]

◆ arcTo() [1/2]

◆ arcTo() [2/2]

◆ boundingRect()

◆ capacity()

◆ clear()

◆ closeSubpath()

◆ connectPath()

◆ contains() [1/3]

◆ contains() [2/3]

◆ contains() [3/3]

◆ controlPointRect()

◆ cubicTo() [1/2]

◆ cubicTo() [2/2]

◆ currentPosition()

◆ elementAt()

◆ elementCount()

◆ fillRule()

◆ intersected()

◆ intersects() [1/2]

◆ intersects() [2/2]

◆ isEmpty()

◆ length()

◆ lineTo() [1/2]

◆ lineTo() [2/2]

◆ moveTo() [1/2]

◆ moveTo() [2/2]

◆ operator!=()

◆ operator&()

◆ operator&=()

◆ operator+()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator=()

◆ operator==()

◆ operator|()

◆ operator|=()

◆ percentAtLength()

◆ pointAtPercent()

◆ quadTo() [1/2]

◆ quadTo() [2/2]

◆ reserve()

◆ setElementPositionAt()

◆ setFillRule()

◆ simplified()

◆ slopeAtPercent()

◆ subtracted()

◆ swap()

◆ toFillPolygon()

◆ toFillPolygons()

◆ toReversed()