Member Function Documentation
QGeoBoundingBox::QGeoBoundingBox()
Constructs a new, invalid bounding box.
QGeoBoundingBox::QGeoBoundingBox(const QGeoCoordinate & center, double degreesWidth, double degreesHeight)
Constructs a new bounding box centered at center with a width in degrees of degreesWidth and a height in degrees of degreesHeight.
If degreesHeight would take the bounding box beyond one of the poles, the height of the bounding box will be truncated such that the bounding box only extends up to the pole. The center of the bounding box will be unchanged, and the height will be adjusted such that the center point is at the center of the truncated bounding box.
QGeoBoundingBox::QGeoBoundingBox(const QGeoCoordinate & topLeft, const QGeoCoordinate & bottomRight)
Constructs a new bounding box with a top left coordinate topLeft and a bottom right coordinate bottomRight.
QGeoBoundingBox::QGeoBoundingBox(const QGeoBoundingBox & other)
Constructs a bounding box from the contents of other.
QGeoBoundingBox::QGeoBoundingBox(const QGeoBoundingArea & other)
Constructs a bounding box from the contents of other.
QGeoBoundingBox::~QGeoBoundingBox()
Destroys this bounding box.
QGeoCoordinate QGeoBoundingBox::bottomLeft() const
Returns the bottom left coordinate of this bounding box.
See also setBottomLeft().
QGeoCoordinate QGeoBoundingBox::bottomRight() const
Returns the bottom right coordinate of this bounding box.
See also setBottomRight().
QGeoCoordinate QGeoBoundingBox::center() const
Returns the center of this bounding box.
See also setCenter().
bool QGeoBoundingBox::contains(const QGeoCoordinate & coordinate) const
Returns true if coordinate is within this bounding box; otherwise returns false.
bool QGeoBoundingBox::contains(const QGeoBoundingBox & boundingBox) const
Returns whether the bounding box boundingBox is contained within this bounding box.
double QGeoBoundingBox::height() const
Returns the height of this bounding box in degrees.
The return value is undefined if this bounding box is invalid.
See also setHeight().
bool QGeoBoundingBox::intersects(const QGeoBoundingBox & boundingBox) const
Returns whether the bounding box boundingBox intersects this bounding box.
If the top or bottom edges of both bounding boxes are at one of the poles the bounding boxes are considered to be intersecting, since the longitude is irrelevant when the edges are at the pole.
void QGeoBoundingBox::setBottomLeft(const QGeoCoordinate & bottomLeft)
Sets the bottom left coordinate of this bounding box to bottomLeft.
See also bottomLeft().
void QGeoBoundingBox::setBottomRight(const QGeoCoordinate & bottomRight)
Sets the bottom right coordinate of this bounding box to bottomRight.
See also bottomRight().
void QGeoBoundingBox::setCenter(const QGeoCoordinate & center)
Sets the center of this bounding box to center.
If this causes the bounding box to cross on of the poles the height of the bounding box will be truncated such that the bounding box only extends up to the pole. The center of the bounding box will be unchanged, and the height will be adjusted such that the center point is at the center of the truncated bounding box.
See also center().
void QGeoBoundingBox::setHeight(double degreesHeight)
Sets the height of this bounding box in degrees to degreesHeight.
If degreesHeight is less than 0.0 or if this bounding box is invalid this function does nothing. To set up the values of an invalid QGeoBoundingBox based on the center, width and height you should use setCenter() first in order to make the QGeoBoundingBox valid.
If the change in height would cause the bounding box to cross a pole the height is adjusted such that the bounding box only touches the pole.
This change is done such that the center coordinate is still at the center of the bounding box, which may result in a bounding box with a smaller height than might otherwise be expected.
If degreesHeight is greater than 180.0 then 180.0 is used as the height.
See also height().
void QGeoBoundingBox::setTopLeft(const QGeoCoordinate & topLeft)
Sets the top left coordinate of this bounding box to topLeft.
See also topLeft().
void QGeoBoundingBox::setTopRight(const QGeoCoordinate & topRight)
Sets the top right coordinate of this bounding box to topRight.
See also topRight().
void QGeoBoundingBox::setWidth(double degreesWidth)
Sets the width of this bounding box in degrees to degreesWidth.
If degreesWidth is less than 0.0 or if this bounding box is invalid this function does nothing. To set up the values of an invalid QGeoBoundingBox based on the center, width and height you should use setCenter() first in order to make the QGeoBoundingBox valid.
If degreesWidth is greater than 360.0 then 360.0 is used as the width, the leftmost longitude of the bounding box is set to -180.0 degrees and the rightmost longitude of the bounding box is set to 180.0 degrees.
See also width().
QGeoCoordinate QGeoBoundingBox::topLeft() const
Returns the top left coordinate of this bounding box.
See also setTopLeft().
QGeoCoordinate QGeoBoundingBox::topRight() const
Returns the top right coordinate of this bounding box.
See also setTopRight().
void QGeoBoundingBox::translate(double degreesLatitude, double degreesLongitude)
Translates this bounding box by degreesLatitude northwards and degreesLongitude eastwards.
Negative values of degreesLatitude and degreesLongitude correspond to southward and westward translation respectively.
If the translation would have caused the bounding box to cross a pole the bounding box will be translated until the top or bottom edge of bounding box touches the pole but not further.
QGeoBoundingBox QGeoBoundingBox::translated(double degreesLatitude, double degreesLongitude) const
Returns a copy of this bounding box translated by degreesLatitude northwards and degreesLongitude eastwards.
Negative values of degreesLatitude and degreesLongitude correspond to southward and westward translation respectively.
See also translate().
QGeoBoundingBox QGeoBoundingBox::united(const QGeoBoundingBox & boundingBox) const
Returns the smallest bounding box which contains both this bounding box and boundingBox.
If the centers of the two bounding boxes are separated by exactly 180.0 degrees then the width is set to 360.0 degrees with the leftmost longitude set to -180.0 degrees and the rightmost longitude set to 180.0 degrees. This is done to ensure that the result is independent of the order of the operands.
double QGeoBoundingBox::width() const
Returns the width of this bounding box in degrees.
The return value is undefined if this bounding box is invalid.
See also setWidth().
bool QGeoBoundingBox::operator!=(const QGeoBoundingArea & other) const
Returns true if other is not equivalent to this bounding box; otherwise returns false.
bool QGeoBoundingBox::operator!=(const QGeoBoundingBox & other) const
Returns whether this bounding box is not equal to other.
QGeoBoundingBox & QGeoBoundingBox::operator=(const QGeoBoundingBox & other)
Assigns other to this bounding box and returns a reference to this bounding box.
bool QGeoBoundingBox::operator==(const QGeoBoundingArea & other) const
Returns true if other is equivalent to this bounding box; otherwise returns false.
bool QGeoBoundingBox::operator==(const QGeoBoundingBox & other) const
Returns whether this bounding box is equal to other.
QGeoBoundingBox QGeoBoundingBox::operator|(const QGeoBoundingBox & boundingBox) const
Returns the smallest bounding box which contains both this bounding box and boundingBox.
If the centers of the two bounding boxes are separated by exactly 180.0 degrees then the width is set to 360.0 degrees with the leftmost longitude set to -180.0 degrees and the rightmost longitude set to 180.0 degrees. This is done to ensure that the result is independent of the order of the operands.
QGeoBoundingBox & QGeoBoundingBox::operator|=(const QGeoBoundingBox & boundingBox)
Returns the smallest bounding box which contains both this bounding box and boundingBox.
If the centers of the two bounding boxes are separated by exactly 180.0 degrees then the width is set to 360.0 degrees with the leftmost longitude set to -180.0 degrees and the rightmost longitude set to 180.0 degrees. This is done to ensure that the result is independent of the order of the operands.
