class QPointF#

The `QPointF` class defines a point in the plane using floating point precision. More

# Synopsis#

## Methods#

• def `operator/=()`

## 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 point is specified by a x coordinate and an y coordinate which can be accessed using the `x()` and `y()` functions. The coordinates of the point are specified using finite floating point numbers for accuracy. The `isNull()` function returns `true` if both x and y are set to 0.0. The coordinates can be set (or altered) using the `setX()` and `setY()` functions, or alternatively the `rx()` and `ry()` functions which return references to the coordinates (allowing direct manipulation).

Given a point p, the following statements are all equivalent:

```p = QPointF()
p.setX(p.x() + 1.0)
p += QPointF(1.0, 0.0)
p.rx() = p.rx() + 1
```

A `QPointF` object can also be used as a vector: Addition and subtraction are defined as for vectors (each component is added separately). A `QPointF` object can also be divided or multiplied by an `int` or a `qreal`.

In addition, the `QPointF` class provides a constructor converting a `QPoint` object into a `QPointF` object, and a corresponding `toPoint()` function which returns a `QPoint` copy of this point. Finally, `QPointF` objects can be streamed as well as compared.

__init__()#

Constructs a null point, i.e. with coordinates (0.0, 0.0)

__init__(p)
Parameters:

Constructs a copy of the given `point`.

__init__(xpos, ypos)
Parameters:
• xpos – float

• ypos – float

Constructs a point with the given coordinates (`xpos`, `ypos`).

__reduce__()#
Return type:

object

__repr__()#
Return type:

object

static dotProduct(p1, p2)#
Parameters:
Return type:

float

Warning

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

```p = QPointF( 3.1, 7.1)
q = QPointF(-1.0, 4.1)
dotProduct = QPointF.dotProduct(p, q) # dotProduct becomes 26.01()
```

Returns the dot product of `p1` and `p2`.

isNull()#
Return type:

bool

Returns `true` if both the x and y coordinates are set to 0.0 (ignoring the sign); otherwise returns `false`.

manhattanLength()#
Return type:

float

Returns the sum of the absolute values of `x()` and `y()` , traditionally known as the “Manhattan length” of the vector from the origin to the point.

__ne__(p2)#
Parameters:
Return type:

bool

Returns `true` if `p1` is sufficiently different from `p2`; otherwise returns `false`.

Warning

This function does not check for strict inequality; instead, it uses a fuzzy comparison to compare the points’ coordinates.

`qFuzzyCompare`

__mul__(matrix)#
Parameters:

matrix`QMatrix4x4`

Return type:

`QPointF`

Note

This function is deprecated.

__mul__(matrix)
Parameters:

matrix`QMatrix4x4`

Return type:

`QPointF`

__mul__(m)
Parameters:
Return type:

`QPointF`

__mul__(c)
Parameters:

c – float

Return type:

`QPointF`

Returns a copy of the given `point`, multiplied by the given finite `factor`.

__mul__(c)
Parameters:

c – float

Return type:

`QPointF`

Returns a copy of the given `point`, multiplied by the given finite `factor`.

`operator*=()`

__imul__(c)#
Parameters:

c – float

Return type:

`QPointF`

Warning

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

Multiplies this point’s coordinates by the given finite `factor`, and returns a reference to this point. For example:

```p = QPointF(-1.1, 4.1)
= 2.5 # p becomes (-2.75, 10.25)
```

`operator/=()`

Return type:

`QPointF`

Returns `point` unmodified.

Parameters:
Return type:

`QPointF`

Returns a `QPointF` object that is the sum of the given points, `p1` and `p2`; each component is added separately.

`operator+=()`

Parameters:
Return type:

`QPointF`

Warning

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

Adds the given `point` to this point and returns a reference to this point. For example:

```p = QPointF( 3.1, 7.1)
q = QPointF(-1.0, 4.1)
p += q # p becomes (2.1, 11.2)
```

`operator-=()`

__sub__()#
Return type:

`QPointF`

Returns a `QPointF` object that is formed by changing the sign of each component of the given `point`.

Equivalent to `QPointF(0,0) - point`.

__sub__(p2)
Parameters:
Return type:

`QPointF`

Returns a `QPointF` object that is formed by subtracting `p2` from `p1`; each component is subtracted separately.

`operator-=()`

__isub__(p)#
Parameters:
Return type:

`QPointF`

Warning

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

Subtracts the given `point` from this point and returns a reference to this point. For example:

```p = QPointF( 3.1, 7.1)
q = QPointF(-1.0, 4.1)
p -= q # p becomes (4.1, 3.0)
```

`operator+=()`

__div__(divisor)#
Parameters:

divisor – float

Return type:

`QPointF`

Returns the `QPointF` object formed by dividing each component of the given `point` by the given `divisor`.

The `divisor` must not be zero or NaN.

`operator/=()`

operator/=(c)
Parameters:

c – float

Return type:

`QPointF`

Warning

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

Divides both x and y by the given `divisor`, and returns a reference to this point. For example:

```p = QPointF(-2.75, 10.25)
p /= 2.5 # p becomes (-1.1, 4.1)
```

The `divisor` must not be zero or NaN.

`operator*=()`

__eq__(p2)#
Parameters:
Return type:

bool

Returns `true` if `p1` is approximately equal to `p2`; otherwise returns `false`.

Warning

This function does not check for strict equality; instead, it uses a fuzzy comparison to compare the points’ coordinates.

`qFuzzyCompare`

setX(x)#
Parameters:

x – float

Sets the x coordinate of this point to the given finite `x` coordinate.

setY(y)#
Parameters:

y – float

Sets the y coordinate of this point to the given finite `y` coordinate.

toPoint()#
Return type:

`QPoint`

Rounds the coordinates of this point to the nearest integer, and returns a `QPoint` object with the rounded coordinates.

`QPointF()` `toPointF()`

toTuple()#
Return type:

object

transposed()#
Return type:

`QPointF`

Returns a point with x and y coordinates exchanged:

```QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}
```
x()#
Return type:

float

Returns the x coordinate of this point.

`setX()` `rx()`
`setY()` `ry()`