# QPolygon#

The QPolygon class provides a list of points using integer precision. More

## Synopsis#

### Static functions#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

## Detailed Description#

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

A QPolygon object is a QList<QPoint>. The easiest way to add points to a QPolygon is to use QList’s streaming operator, as illustrated below:

polygon = QPolygon()
polygon << QPoint(10, 20) << QPoint(20, 30)

In addition to the functions provided by QList, QPolygon provides some point-specific functions.

Each point in a polygon can be retrieved by passing its index to the point() function. To populate the polygon, QPolygon provides the setPoint() function to set the point at a given index, the setPoints() function to set all the points in the polygon (resizing it to the given number of points), and the putPoints() function which copies a number of given points into the polygon from a specified index (resizing the polygon if necessary).

QPolygon provides the boundingRect() and translate() functions for geometry functions. Use the map() function for more general transformations of QPolygons.

The QPolygon class is implicitly shared.

QPolygonF QLine

class PySide6.QtGui.QPolygon#

PySide6.QtGui.QPolygon(v)

PySide6.QtGui.QPolygon(r[, closed=false])

Parameters:
• closed – bool

• v – .list of QPoint

Constructs a polygon with no points.

isEmpty()

Constructs a polygon containing the specified points.

setPoints()

Constructs a polygon from the given rectangle. If closed is false, the polygon just contains the four points of the rectangle ordered clockwise, otherwise the polygon’s fifth point is set to rectangle.topLeft().

Note that the bottom-right corner of the rectangle is located at (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()).

setPoints()

PySide6.QtGui.QPolygon.__reduce__()#
Return type:

object

PySide6.QtGui.QPolygon.append(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.append(l)
Parameters:

l – .list of QPoint

PySide6.QtGui.QPolygon.at(i)#
Parameters:

i – int

Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.back()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.boundingRect()#
Return type:

PySide6.QtCore.QRect

Returns the bounding rectangle of the polygon, or QRect(0, 0, 0, 0) if the polygon is empty.

isEmpty()

PySide6.QtGui.QPolygon.capacity()#
Return type:

int

PySide6.QtGui.QPolygon.clear()#
PySide6.QtGui.QPolygon.constData()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.constFirst()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.constLast()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.containsPoint(pt, fillRule)#
Parameters:
Return type:

bool

Returns true if the given point is inside the polygon according to the specified fillRule; otherwise returns false.

PySide6.QtGui.QPolygon.count()#
Return type:

int

PySide6.QtGui.QPolygon.data()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.empty()#
Return type:

bool

PySide6.QtGui.QPolygon.first()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.first(n)
Parameters:

n – int

Return type:

.list of QPoint

static PySide6.QtGui.QPolygon.fromList(list)#
Parameters:

list – .list of QPoint

Return type:

.list of QPoint

static PySide6.QtGui.QPolygon.fromVector(vector)#
Parameters:

vector – .list of QPoint

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.front()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.insert(arg__1, arg__2)#
Parameters:
PySide6.QtGui.QPolygon.intersected(r)#
Parameters:
Return type:

PySide6.QtGui.QPolygon

Returns a polygon which is the intersection of this polygon and r.

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

intersects()

PySide6.QtGui.QPolygon.intersects(r)#
Parameters:
Return type:

bool

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

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

intersected()

PySide6.QtGui.QPolygon.isEmpty()#
Return type:

bool

PySide6.QtGui.QPolygon.isSharedWith(other)#
Parameters:

other – .list of QPoint

Return type:

bool

PySide6.QtGui.QPolygon.last()#
Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.last(n)
Parameters:

n – int

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.length()#
Return type:

int

PySide6.QtGui.QPolygon.mid(pos[, len=-1])#
Parameters:
• pos – int

• len – int

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.move(from, to)#
Parameters:
• from – int

• to – int

PySide6.QtGui.QPolygon.__ne__(arg__1)#
Parameters:

arg__1PySide6.QtGui.QPolygon

Return type:

bool

PySide6.QtGui.QPolygon.__mul__(m)#
Parameters:
Return type:

PySide6.QtGui.QPolygon

Parameters:

l – .list of QPoint

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.__lshift__(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.__lshift__(arg__1)
Parameters:

arg__1 – .list of QPoint

PySide6.QtGui.QPolygon.__eq__(arg__1)#
Parameters:

arg__1PySide6.QtGui.QPolygon

Return type:

bool

PySide6.QtGui.QPolygon.operator(i)#
Parameters:

i – int

Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.pop_back()#
PySide6.QtGui.QPolygon.pop_front()#
PySide6.QtGui.QPolygon.prepend(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.push_back(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.push_front(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.remove(i[, n=1])#
Parameters:
• i – int

• n – int

PySide6.QtGui.QPolygon.removeAll(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.removeAt(i)#
Parameters:

i – int

PySide6.QtGui.QPolygon.removeFirst()#
PySide6.QtGui.QPolygon.removeLast()#
PySide6.QtGui.QPolygon.removeOne(arg__1)#
Parameters:

arg__1PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.reserve(size)#
Parameters:

size – int

PySide6.QtGui.QPolygon.resize(size)#
Parameters:

size – int

PySide6.QtGui.QPolygon.shrink_to_fit()#
PySide6.QtGui.QPolygon.size()#
Return type:

int

PySide6.QtGui.QPolygon.sliced(pos)#
Parameters:

pos – int

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.sliced(pos, n)
Parameters:
• pos – int

• n – int

Return type:

.list of QPoint

PySide6.QtGui.QPolygon.squeeze()#
PySide6.QtGui.QPolygon.subtracted(r)#
Parameters:
Return type:

PySide6.QtGui.QPolygon

Returns a polygon which is r subtracted from this polygon.

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

PySide6.QtGui.QPolygon.swap(other)#
Parameters:

otherPySide6.QtGui.QPolygon

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

PySide6.QtGui.QPolygon.swapItemsAt(i, j)#
Parameters:
• i – int

• j – int

PySide6.QtGui.QPolygon.takeAt(i)#
Parameters:

i – int

Return type:

PySide6.QtCore.QPoint

PySide6.QtGui.QPolygon.toList()#
Return type:

.list of QPoint

PySide6.QtGui.QPolygon.toPolygonF()#
Return type:

PySide6.QtGui.QPolygonF

Returns this polygon as a polygon with floating point accuracy.

toPolygon()

PySide6.QtGui.QPolygon.toVector()#
Return type:

.list of QPoint

PySide6.QtGui.QPolygon.translate(offset)#
Parameters:

offsetPySide6.QtCore.QPoint

Translates all points in the polygon by the given offset.

translated()

PySide6.QtGui.QPolygon.translate(dx, dy)
Parameters:
• dx – int

• dy – int

Translates all points in the polygon by (dx, dy).

translated()

PySide6.QtGui.QPolygon.translated(offset)#
Parameters:

offsetPySide6.QtCore.QPoint

Return type:

PySide6.QtGui.QPolygon

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

translate()

PySide6.QtGui.QPolygon.translated(dx, dy)
Parameters:
• dx – int

• dy – int

Return type:

PySide6.QtGui.QPolygon

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

translate()

PySide6.QtGui.QPolygon.united(r)#
Parameters:
Return type:

PySide6.QtGui.QPolygon

Returns a polygon which is the union of this polygon and r.

Set operations on polygons, will treat the polygons as areas, and implicitly close the polygon.