QPainterPath¶

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

Synopsis¶

Functions¶

def __add__ (other)
def __and__ (other)
def __eq__ (other)
def __iadd__ (other)
def __iand__ (other)
def __ior__ (other)
def __isub__ (other)
def __mul__ (, m)
def __mul__ (, m)
def __ne__ (other)
def __or__ (other)
def __sub__ (other)
def addEllipse (center, rx, ry)
def addEllipse (rect)
def addEllipse (x, y, w, h)
def addPath (path)
def addPolygon (polygon)
def addRect (rect)
def addRect (x, y, w, h)
def addRegion (region)
def addRoundRect (rect, roundness)
def addRoundRect (rect, xRnd, yRnd)
def addRoundRect (x, y, w, h, roundness)
def addRoundRect (x, y, w, h, xRnd, yRnd)
def addRoundedRect (rect, xRadius, yRadius[, mode=Qt.AbsoluteSize])
def addRoundedRect (x, y, w, h, xRadius, yRadius[, mode=Qt.AbsoluteSize])
def addText (point, f, text)
def addText (x, y, f, text)
def angleAtPercent (t)
def arcMoveTo (rect, angle)
def arcMoveTo (x, y, w, h, angle)
def arcTo (rect, startAngle, arcLength)
def arcTo (x, y, w, h, startAngle, arcLength)
def boundingRect ()
def capacity ()
def clear ()
def closeSubpath ()
def connectPath (path)
def contains (p)
def contains (pt)
def contains (rect)
def controlPointRect ()
def cubicTo (ctrlPt1, ctrlPt2, endPt)
def cubicTo (ctrlPt1x, ctrlPt1y, ctrlPt2x, ctrlPt2y, endPtx, endPty)
def currentPosition ()
def elementAt (i)
def elementCount ()
def fillRule ()
def intersected (r)
def intersects (p)
def intersects (rect)
def isEmpty ()
def length ()
def lineTo (p)
def lineTo (x, y)
def moveTo (p)
def moveTo (x, y)
def percentAtLength (t)
def pointAtPercent (t)
def quadTo (ctrlPt, endPt)
def quadTo (ctrlPtx, ctrlPty, endPtx, endPty)
def reserve (size)
def setElementPositionAt (i, x, y)
def setFillRule (fillRule)
def simplified ()
def slopeAtPercent (t)
def subtracted (r)
def subtractedInverted (r)
def swap (other)
def toFillPolygon ([matrix=QTransform()])
def toFillPolygon (matrix)
def toFillPolygons ([matrix=QTransform()])
def toFillPolygons (matrix)
def toReversed ()
def toSubpathPolygons ([matrix=QTransform()])
def toSubpathPolygons (matrix)
def translate (dx, dy)
def translate (offset)
def translated (dx, dy)
def translated (offset)
def united (r)

Detailed Description¶

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 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.

Composing a QPainterPath¶

A QPainterPath object can be constructed as an empty path, with a given start point, or as a copy of another QPainterPath object. Once created, lines and curves can be added to the path using the lineTo() , arcTo() , cubicTo() and quadTo() functions. The lines and curves stretch from the currentPosition() to the position passed as argument.

The currentPosition() of the QPainterPath object is always the end position of the last subpath that was added (or the initial start point). Use the moveTo() function to move the currentPosition() without adding a component. The moveTo() function implicitly starts a new subpath, and closes the previous one. Another way of starting a new subpath is to call the closeSubpath() function which closes the current path by adding a line from the currentPosition() back to the path’s start position. Note that the new path will have (0, 0) as its initial currentPosition() .

QPainterPath class also provides several convenience functions to add closed subpaths to a painter path: addEllipse() , addPath() , addRect() , addRegion() and addText() . The addPolygon() function adds an unclosed subpath. In fact, these functions are all collections of moveTo() , lineTo() and cubicTo() operations.

In addition, a path can be added to the current path using the connectPath() function. But note that this function will connect the last element of the current path to the first element of given one by adding a line.

Below is a code snippet that shows how a QPainterPath object can be used:
path = QPainterPath()
path.addRect(20, 20, 60, 60)

path.moveTo(0, 0)
path.cubicTo(99, 0,  50, 50,  99, 99)
path.cubicTo(0, 99,  50, 50,  0, 0)

QPainter painter(self)
painter.fillRect(0, 0, 100, 100, Qt.white)
painter.setPen(QPen(QColor(79, 106, 25), 1, Qt.SolidLine,
                    Qt.FlatCap, Qt.MiterJoin))
painter.setBrush(QColor(122, 163, 39))

painter.drawPath(path)
The painter path is initially empty when constructed. We first add a rectangle, which is a closed subpath. Then we add two bezier curves which together form a closed subpath even though they are not closed individually. Finally we draw the entire path. The path is filled using the default fill rule, OddEvenFill . Qt provides two methods for filling paths:

OddEvenFill

WindingFill

See the FillRule documentation for the definition of the rules. A painter path’s currently set fill rule can be retrieved using the fillRule() function, and altered using the setFillRule() function.

QPainterPath Information¶

The QPainterPath class provides a collection of functions that returns information about the path and its elements.

The currentPosition() function returns the end point of the last subpath that was added (or the initial start point). The elementAt() function can be used to retrieve the various subpath elements, the number of elements can be retrieved using the elementCount() function, and the isEmpty() function tells whether this QPainterPath object contains any elements at all.

The controlPointRect() function returns the rectangle containing all the points and control points in this path. This function is significantly faster to compute than the exact boundingRect() which returns the bounding rectangle of this painter path with floating point precision.

Finally, QPainterPath provides the contains() function which can be used to determine whether a given point or rectangle is inside the path, and the intersects() function which determines if any of the points inside a given rectangle also are inside this path.

QPainterPath Conversion¶

For compatibility reasons, it might be required to simplify the representation of a painter path: QPainterPath provides the toFillPolygon() , toFillPolygons() and toSubpathPolygons() functions which convert the painter path into a polygon. The toFillPolygon() returns the painter path as one single polygon, while the two latter functions return a list of polygons.

The toFillPolygons() and toSubpathPolygons() functions are 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 difference between the two is the number of polygons they return: The toSubpathPolygons() creates one polygon for each subpath regardless of intersecting subpaths (i.e. overlapping bounding rectangles), while the toFillPolygons() functions creates only one polygon for overlapping subpaths.

The toFillPolygon() and toFillPolygons() functions first convert all the subpaths to polygons, then uses a rewinding technique to make sure that overlapping subpaths can be filled using the correct fill rule. Note that rewinding inserts additional lines in the polygon so the outline of the fill polygon does not match the outline of the path.

Examples¶

Qt provides the Painter Paths Example and the Vector Deformation example which are located in Qt’s example directory.

The Painter Paths Example shows how painter paths can be used to build complex shapes for rendering and lets the user experiment with the filling and stroking. The Vector Deformation Example shows how to use QPainterPath to draw text.

Painter Paths Example

Vector Deformation Example

See also

QPainterPathStroker QPainter QRegion Painter Paths Example

class PySide2.QtGui.QPainterPath¶

PySide2.QtGui.QPainterPath(other)

PySide2.QtGui.QPainterPath(startPoint)

param other:

PySide2.QtGui.QPainterPath

param startPoint:

PySide2.QtCore.QPointF

Constructs an empty QPainterPath object.

PySide2.QtGui.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.

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

See also

elementAt() elementCount()

PySide2.QtGui.QPainterPath.addEllipse(center, rx, ry)¶

Parameters:

center – PySide2.QtCore.QPointF
rx – float
ry – float

This is an overloaded function.

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

PySide2.QtGui.QPainterPath.addEllipse(x, y, w, h)

Parameters:

x – float
y – float
w – float
h – float

This is an overloaded function.

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.

PySide2.QtGui.QPainterPath.addEllipse(rect)

Parameters:: rect – PySide2.QtCore.QRectF

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).

qpainterpath-addellipse1

myGradient = QLinearGradient()
myPen = QPen()
boundingRectangle = QRectF()

myPath = QPainterPath()
myPath.addEllipse(boundingRectangle)

QPainter painter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

arcTo() drawEllipse() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addPath(path)¶

Parameters:: path – PySide2.QtGui.QPainterPath

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

See also

connectPath() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addPolygon(polygon)¶

Parameters:: polygon – PySide2.QtGui.QPolygonF

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.

qpainterpath-addpolygon1

myGradient = QLinearGradient()
myPen = QPen()
myPolygon = QPolygonF()

myPath = QPainterPath()
myPath.addPolygon(myPolygon)

QPainter painter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

lineTo() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addRect(rect)¶

Parameters:: rect – PySide2.QtCore.QRectF

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.

qpainterpath-addrectangle1

myGradient = QLinearGradient()
myPen = QPen()
myRectangle = QRectF()

myPath = QPainterPath()
myPath.addRect(myRectangle)

painter = QPainter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

addRegion() lineTo() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addRect(x, y, w, h)

Parameters:

x – float
y – float
w – float
h – float

This is an overloaded function.

Adds a rectangle at position (x , y ), with the given width and height , as a closed subpath.

PySide2.QtGui.QPainterPath.addRegion(region)¶

Parameters:: region – PySide2.QtGui.QRegion

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

See also

addRect() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addRoundRect(rect, roundness)¶

Parameters:

rect – PySide2.QtCore.QRectF
roundness – int

Note

This function is deprecated.

This is an overloaded function.

Adds a rounded rectangle, rect , to the path.

The roundness argument specifies uniform roundness for the rectangle. Vertical and horizontal roundness factors will be adjusted accordingly to act uniformly around both axes. Use this method if you want a rectangle equally rounded across both the X and Y axis.

See also

addRoundedRect()

PySide2.QtGui.QPainterPath.addRoundRect(rect, xRnd, yRnd)

Parameters:

rect – PySide2.QtCore.QRectF
xRnd – int
yRnd – int

Note

This function is deprecated.

Adds a rectangle r with rounded corners to the path.

The xRnd and yRnd arguments specify how rounded the corners should be. 0 is angled corners, 99 is maximum roundedness.

See also

addRoundedRect()

PySide2.QtGui.QPainterPath.addRoundRect(x, y, w, h, roundness)

Parameters:

x – float
y – float
w – float
h – float
roundness – int

Note

This function is deprecated.

This is an overloaded function.

Adds a rounded rectangle to the path, defined by the coordinates x and y with the specified width and height .

The roundness argument specifies uniform roundness for the rectangle. Vertical and horizontal roundness factors will be adjusted accordingly to act uniformly around both axes. Use this method if you want a rectangle equally rounded across both the X and Y axis.

See also

addRoundedRect()

PySide2.QtGui.QPainterPath.addRoundRect(x, y, w, h, xRnd, yRnd)

Parameters:

x – float
y – float
w – float
h – float
xRnd – int
yRnd – int

Note

This function is deprecated.

This is an overloaded function.

Adds a rectangle with rounded corners to the path. The rectangle is constructed from x , y , and the width and height w and h .

The xRnd and yRnd arguments specify how rounded the corners should be. 0 is angled corners, 99 is maximum roundedness.

See also

addRoundedRect()

PySide2.QtGui.QPainterPath.addRoundedRect(rect, xRadius, yRadius[, mode=Qt.AbsoluteSize])¶

Parameters:

rect – PySide2.QtCore.QRectF
xRadius – float
yRadius – float
mode – SizeMode

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 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()

PySide2.QtGui.QPainterPath.addRoundedRect(x, y, w, h, xRadius, yRadius[, mode=Qt.AbsoluteSize])

Parameters:

x – float
y – float
w – float
h – float
xRadius – float
yRadius – float
mode – SizeMode

This is an overloaded function.

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

PySide2.QtGui.QPainterPath.addText(point, f, text)¶

Parameters:

point – PySide2.QtCore.QPointF
f – PySide2.QtGui.QFont
text – str

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 .

qpainterpath-addtext1

myGradient = QLinearGradient()
myPen = QPen()
myFont = QFont()
QPointF baseline(x, y)

myPath = QPainterPath()
myPath.addText(baseline, myFont, tr("Qt"))

painter QPainter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

drawText() Composing a QPainterPath

PySide2.QtGui.QPainterPath.addText(x, y, f, text)

Parameters:

x – float
y – float
f – PySide2.QtGui.QFont
text – str

This is an overloaded function.

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 ).

PySide2.QtGui.QPainterPath.angleAtPercent(t)¶

Parameters:: t – float
Return type:: float

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.

PySide2.QtGui.QPainterPath.arcMoveTo(rect, angle)¶

Parameters:

rect – PySide2.QtCore.QRectF
angle – float

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()

PySide2.QtGui.QPainterPath.arcMoveTo(x, y, w, h, angle)

Parameters:

x – float
y – float
w – float
h – float
angle – float

This is an overloaded function.

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

PySide2.QtGui.QPainterPath.arcTo(rect, startAngle, arcLength)¶

Parameters:

rect – PySide2.QtCore.QRectF
startAngle – float
arcLength – float

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.

qpainterpath-arcto1

myGradient = QLinearGradient()
myPen = QPen()

startPoint = QPointF()
center = QPointF()

myPath = QPainterPath()
myPath.moveTo(center)
myPath.arcTo(boundingRect, startAngle,
             sweepLength)

painter = QPainter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

arcMoveTo() addEllipse() drawArc() drawPie() Composing a QPainterPath

PySide2.QtGui.QPainterPath.arcTo(x, y, w, h, startAngle, arcLength)

Parameters:

x – float
y – float
w – float
h – float
startAngle – float
arcLength – float

This is an overloaded function.

Creates an arc that occupies the rectangle QRectF (x , y , width , height ), beginning at the specified startAngle and extending sweepLength degrees counter-clockwise.

PySide2.QtGui.QPainterPath.boundingRect()¶

Return type:: PySide2.QtCore.QRectF

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

See also

controlPointRect()

PySide2.QtGui.QPainterPath.capacity()¶

Return type:: int

Returns the number of elements allocated by the QPainterPath .

See also

clear() reserve()

PySide2.QtGui.QPainterPath.clear()¶

Clears the path elements stored.

This allows the path to reuse previous memory allocations.

See also

reserve() capacity()

PySide2.QtGui.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() Composing a QPainterPath

PySide2.QtGui.QPainterPath.connectPath(path)¶

Parameters:: path – PySide2.QtGui.QPainterPath

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() Composing a QPainterPath

PySide2.QtGui.QPainterPath.contains(p)¶

Parameters:: p – PySide2.QtGui.QPainterPath
Return type:: bool

PySide2.QtGui.QPainterPath.contains(pt)

Parameters:: pt – PySide2.QtCore.QPointF
Return type:: bool

PySide2.QtGui.QPainterPath.contains(rect)

Parameters:: rect – PySide2.QtCore.QRectF
Return type:: bool

PySide2.QtGui.QPainterPath.controlPointRect()¶

Return type:: PySide2.QtCore.QRectF

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()

PySide2.QtGui.QPainterPath.cubicTo(ctrlPt1, ctrlPt2, endPt)¶

Parameters:

ctrlPt1 – PySide2.QtCore.QPointF
ctrlPt2 – PySide2.QtCore.QPointF
endPt – PySide2.QtCore.QPointF

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.

qpainterpath-cubicto1

myGradient = QLinearGradient()
myPen = QPen()

myPath = QPainterPath()
myPath.cubicTo(c1, c2, endPoint)

painter = QPainter(self)
painter.setBrush(myGradient)
painter.setPen(myPen)
painter.drawPath(myPath)

See also

quadTo() Composing a QPainterPath

PySide2.QtGui.QPainterPath.cubicTo(ctrlPt1x, ctrlPt1y, ctrlPt2x, ctrlPt2y, endPtx, endPty)

Parameters:

ctrlPt1x – float
ctrlPt1y – float
ctrlPt2x – float
ctrlPt2y – float
endPtx – float
endPty – float

This is an overloaded function.

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 ).

PySide2.QtGui.QPainterPath.currentPosition()¶

Return type:: PySide2.QtCore.QPointF

Returns the current position of the path.

PySide2.QtGui.QPainterPath.elementAt(i)¶

Parameters:: i – int
Return type:: PySide2.QtGui.QPainterPath.Element

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

See also

ElementType elementCount() isEmpty()

PySide2.QtGui.QPainterPath.elementCount()¶

Return type:: int

Returns the number of path elements in the painter path.

See also

ElementType elementAt() isEmpty()

PySide2.QtGui.QPainterPath.fillRule()¶

Return type:: FillRule

Returns the painter path’s currently set fill rule.

See also

setFillRule()

PySide2.QtGui.QPainterPath.intersected(r)¶

Parameters:: r – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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.

PySide2.QtGui.QPainterPath.intersects(rect)¶

Parameters:: rect – PySide2.QtCore.QRectF
Return type:: bool

PySide2.QtGui.QPainterPath.intersects(p)

Parameters:: p – PySide2.QtGui.QPainterPath
Return type:: bool

PySide2.QtGui.QPainterPath.isEmpty()¶

Return type:: bool

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()

PySide2.QtGui.QPainterPath.length()¶

Return type:: float

Returns the length of the current path.

PySide2.QtGui.QPainterPath.lineTo(p)¶

Parameters:: p – PySide2.QtCore.QPointF

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() Composing a QPainterPath

PySide2.QtGui.QPainterPath.lineTo(x, y)

Parameters:

x – float
y – float

This is an overloaded function.

Draws a line from the current position to the point (x , y ).

PySide2.QtGui.QPainterPath.moveTo(p)¶

Parameters:: p – PySide2.QtCore.QPointF

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

See also

closeSubpath() Composing a QPainterPath

PySide2.QtGui.QPainterPath.moveTo(x, y)

Parameters:

x – float
y – float

This is an overloaded function.

Moves the current position to (x , y ) and starts a new subpath, implicitly closing the previous path.

PySide2.QtGui.QPainterPath.__ne__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: bool

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==()

PySide2.QtGui.QPainterPath.__and__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

PySide2.QtGui.QPainterPath.__iand__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

PySide2.QtGui.QPainterPath.__mul__(m)¶

Parameters:: m – PySide2.QtGui.QMatrix
Return type:: PySide2.QtGui.QPainterPath

PySide2.QtGui.QPainterPath.__mul__(m)

Parameters:: m – PySide2.QtGui.QTransform
Return type:: PySide2.QtGui.QPainterPath

PySide2.QtGui.QPainterPath.__add__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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

See also

united() operator+=() operator-()

PySide2.QtGui.QPainterPath.__iadd__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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

See also

united() operator+() operator-=()

PySide2.QtGui.QPainterPath.__sub__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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

See also

subtracted() operator-=() operator+()

PySide2.QtGui.QPainterPath.__isub__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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

See also

subtracted() operator-() operator+=()

PySide2.QtGui.QPainterPath.__eq__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: bool

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!=()

PySide2.QtGui.QPainterPath.__or__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

Returns the union of this path and the other path.

See also

united() operator|=() intersected() operator&()

PySide2.QtGui.QPainterPath.__ior__(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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

See also

united() operator|() operator&=()

PySide2.QtGui.QPainterPath.percentAtLength(t)¶

Parameters:: t – float
Return type:: float

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.

PySide2.QtGui.QPainterPath.pointAtPercent(t)¶

Parameters:: t – float
Return type:: PySide2.QtCore.QPointF

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.

PySide2.QtGui.QPainterPath.quadTo(ctrlPt, endPt)¶

Parameters:

ctrlPt – PySide2.QtCore.QPointF
endPt – PySide2.QtCore.QPointF

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() Composing a QPainterPath

PySide2.QtGui.QPainterPath.quadTo(ctrlPtx, ctrlPty, endPtx, endPty)

Parameters:

ctrlPtx – float
ctrlPty – float
endPtx – float
endPty – float

This is an overloaded function.

Adds a quadratic Bezier curve between the current point and the endpoint (endPointX , endPointY ) with the control point specified by (cx , cy ).

PySide2.QtGui.QPainterPath.reserve(size)¶

Parameters:: size – int

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

Attempts to allocate memory for at least size elements.

See also

clear() capacity() reserve()

PySide2.QtGui.QPainterPath.setElementPositionAt(i, x, y)¶

Parameters:

i – int
x – float
y – float

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

PySide2.QtGui.QPainterPath.setFillRule(fillRule)¶

Parameters:: fillRule – FillRule

Sets the fill rule of the painter path to the given fillRule . Qt provides two methods for filling paths:

`OddEvenFill` (default)	`WindingFill`

See also

fillRule()

PySide2.QtGui.QPainterPath.simplified()¶

Return type:: PySide2.QtGui.QPainterPath

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, OddEvenFill . Bezier curves may be flattened to line segments due to numerical instability of doing bezier curve intersections.

PySide2.QtGui.QPainterPath.slopeAtPercent(t)¶

Parameters:: t – float
Return type:: float

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.

PySide2.QtGui.QPainterPath.subtracted(r)¶

Parameters:: r – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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.

PySide2.QtGui.QPainterPath.subtractedInverted(r)¶

Parameters:: r – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

Note

This function is deprecated.

Use subtracted() instead.

See also

subtracted()

PySide2.QtGui.QPainterPath.swap(other)¶

Parameters:: other – PySide2.QtGui.QPainterPath

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

PySide2.QtGui.QPainterPath.toFillPolygon([matrix=QTransform()])¶

Parameters:: matrix – PySide2.QtGui.QTransform
Return type:: PySide2.QtGui.QPolygonF

PySide2.QtGui.QPainterPath.toFillPolygon(matrix)

Parameters:: matrix – PySide2.QtGui.QMatrix
Return type:: PySide2.QtGui.QPolygonF

Note

This function is deprecated.

PySide2.QtGui.QPainterPath.toFillPolygons(matrix)¶

Parameters:: matrix – PySide2.QtGui.QMatrix
Return type:

Note

This function is deprecated.

PySide2.QtGui.QPainterPath.toFillPolygons([matrix=QTransform()])

Parameters:: matrix – PySide2.QtGui.QTransform
Return type:

PySide2.QtGui.QPainterPath.toReversed()¶

Return type:: PySide2.QtGui.QPainterPath

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() .

PySide2.QtGui.QPainterPath.toSubpathPolygons(matrix)¶

Parameters:: matrix – PySide2.QtGui.QMatrix
Return type:

Note

This function is deprecated.

PySide2.QtGui.QPainterPath.toSubpathPolygons([matrix=QTransform()])

Parameters:: matrix – PySide2.QtGui.QTransform
Return type:

PySide2.QtGui.QPainterPath.translate(offset)¶

Parameters:: offset – PySide2.QtCore.QPointF

This is an overloaded function.

Translates all elements in the path by the given offset .

See also

translated()

PySide2.QtGui.QPainterPath.translate(dx, dy)

Parameters:

dx – float
dy – float

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

See also

translated()

PySide2.QtGui.QPainterPath.translated(offset)¶

Parameters:: offset – PySide2.QtCore.QPointF
Return type:: PySide2.QtGui.QPainterPath

This is an overloaded function.

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

See also

translate()

PySide2.QtGui.QPainterPath.translated(dx, dy)

Parameters:

dx – float
dy – float

Return type:

PySide2.QtGui.QPainterPath

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

See also

translate()

PySide2.QtGui.QPainterPath.united(r)¶

Parameters:: r – PySide2.QtGui.QPainterPath
Return type:: PySide2.QtGui.QPainterPath

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()

Table of Contents

Previous topic

Next topic

QPainterPath¶

Synopsis¶

Functions¶

Detailed Description¶

Composing a QPainterPath¶

QPainterPath Information¶

QPainterPath Conversion¶

Examples¶