QPolygon#

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

Synopsis#

Functions#

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.

See also

QPolygonF QLine

class PySide6.QtGui.QPolygon#

PySide6.QtGui.QPolygon(v)

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

Parameters:

Constructs a polygon with no points.

See also

isEmpty()

Constructs a polygon containing the specified points.

See also

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

See also

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.

See also

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:

rPySide6.QtGui.QPolygon

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.

See also

intersects()

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

rPySide6.QtGui.QPolygon

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.

See also

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:

mPySide6.QtGui.QTransform

Return type:

PySide6.QtGui.QPolygon

PySide6.QtGui.QPolygon.__add__(l)#
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:

rPySide6.QtGui.QPolygon

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.

See also

toPolygon()

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

.list of QPoint

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

offsetPySide6.QtCore.QPoint

This is an overloaded function.

Translates all points in the polygon by the given offset.

See also

translated()

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

  • dy – int

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

See also

translated()

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

offsetPySide6.QtCore.QPoint

Return type:

PySide6.QtGui.QPolygon

This is an overloaded function.

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

See also

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

See also

translate()

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

rPySide6.QtGui.QPolygon

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.

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

i – int

Return type:

PySide6.QtCore.QPoint