QgsBox3d Class Reference

A 3-dimensional box composed of x, y, z coordinates. More...

#include <qgsbox3d.h>

Public Member Functions
	QgsBox3d (const QgsPoint &p1, const QgsPoint &p2) SIP_HOLDGIL
	Constructs a QgsBox3D from two points representing opposite corners of the box. More...
	QgsBox3d (const QgsRectangle &rect) SIP_HOLDGIL
	Constructs a QgsBox3D from a rectangle. More...
	QgsBox3d (double xmin=0, double ymin=0, double zmin=0, double xmax=0, double ymax=0, double zmax=0) SIP_HOLDGIL
	Constructor for QgsBox3D which accepts the ranges of x/y/z coordinates. More...
bool	contains (const QgsBox3d &other) const
	Returns true when box contains other box. More...
bool	contains (const QgsPoint &point) const
	Returns true when box contains a point. More...
double	depth () const SIP_HOLDGIL
	Returns the depth of the box. More...
double	distanceTo (const QVector3D &point) const
	Returns the smallest distance between the box and the point point (returns 0 if the point is inside the box) More...
double	height () const SIP_HOLDGIL
	Returns the height of the box. More...
QgsBox3d	intersect (const QgsBox3d &other) const
	Returns the intersection of this box and another 3D box. More...
bool	intersects (const QgsBox3d &other) const
	Returns true if box intersects with another box. More...
bool	is2d () const SIP_HOLDGIL
	Returns true if the box can be considered a 2-dimensional box, i.e. More...
void	normalize ()
	Normalize the box so it has non-negative width/height/depth. More...
bool	operator== (const QgsBox3d &other) const
void	scale (double scaleFactor, const QgsPoint &center=QgsPoint())
	Scale the rectangle around a center QgsPoint. More...
void	scale (double scaleFactor, double centerX, double centerY, double centerZ)
	Scale the rectangle around a center coordinates. More...
void	setXMaximum (double x) SIP_HOLDGIL
	Sets the maximum x value. More...
void	setXMinimum (double x) SIP_HOLDGIL
	Sets the minimum x value. More...
void	setYMaximum (double y) SIP_HOLDGIL
	Sets the maximum y value. More...
void	setYMinimum (double y) SIP_HOLDGIL
	Sets the minimum y value. More...
void	setZMaximum (double z) SIP_HOLDGIL
	Sets the maximum z value. More...
void	setZMinimum (double z) SIP_HOLDGIL
	Sets the minimum z value. More...
QgsRectangle	toRectangle () const
	Converts the box to a 2D rectangle. More...
double	volume () const SIP_HOLDGIL
	Returns the volume of the box. More...
double	width () const SIP_HOLDGIL
	Returns the width of the box. More...
double	xMaximum () const SIP_HOLDGIL
	Returns the maximum x value. More...
double	xMinimum () const SIP_HOLDGIL
	Returns the minimum x value. More...
double	yMaximum () const SIP_HOLDGIL
	Returns the maximum y value. More...
double	yMinimum () const SIP_HOLDGIL
	Returns the minimum y value. More...
double	zMaximum () const SIP_HOLDGIL
	Returns the maximum z value. More...
double	zMinimum () const SIP_HOLDGIL
	Returns the minimum z value. More...

Detailed Description

A 3-dimensional box composed of x, y, z coordinates.

A box composed of x/y/z minimum and maximum values. It is often used to return the 3D extent of a geometry or collection of geometries.

See also

QgsRectangle

Since

QGIS 3.0

Definition at line 38 of file qgsbox3d.h.

Constructor & Destructor Documentation

QgsBox3d() [1/3]

QgsBox3d::QgsBox3d	(	double	xmin = 0,
		double	ymin = 0,
		double	zmin = 0,
		double	xmax = 0,
		double	ymax = 0,
		double	zmax = 0
	)

Constructor for QgsBox3D which accepts the ranges of x/y/z coordinates.

Definition at line 21 of file qgsbox3d.cpp.

QgsBox3d() [2/3]

QgsBox3d::QgsBox3d	(	const QgsPoint &	p1,
		const QgsPoint &	p2
	)

Constructs a QgsBox3D from two points representing opposite corners of the box.

The box is normalized after construction.

Definition at line 27 of file qgsbox3d.cpp.

QgsBox3d() [3/3]

QgsBox3d::QgsBox3d

(

const QgsRectangle &

rect

)

Constructs a QgsBox3D from a rectangle.

Z Minimum and Z Maximum are set to 0.0.

Definition at line 35 of file qgsbox3d.cpp.

Member Function Documentation

contains() [1/2]

bool QgsBox3d::contains

(

const QgsBox3d &

other

)

const

Returns true when box contains other box.

Definition at line 102 of file qgsbox3d.cpp.

contains() [2/2]

bool QgsBox3d::contains

(

const QgsPoint &

point

)

const

Returns true when box contains a point.

If the point is a 2D point (no z-coordinate), then the containment test will be performed on the x/y extent of the box only.

Definition at line 110 of file qgsbox3d.cpp.

depth()

double QgsBox3d::depth ( ) const

inline

Returns the depth of the box.

See also

width()

height()

Definition at line 167 of file qgsbox3d.h.

distanceTo()

double QgsBox3d::distanceTo

(

const QVector3D &

point

)

const

Returns the smallest distance between the box and the point point (returns 0 if the point is inside the box)

Since

QGIS 3.18

Definition at line 121 of file qgsbox3d.cpp.

height()

double QgsBox3d::height ( ) const

inline

Returns the height of the box.

See also

width()

depth()

Definition at line 160 of file qgsbox3d.h.

intersect()

QgsBox3d QgsBox3d::intersect

(

const QgsBox3d &

other

)

const

Returns the intersection of this box and another 3D box.

Definition at line 78 of file qgsbox3d.cpp.

intersects()

bool QgsBox3d::intersects

(

const QgsBox3d &

other

)

const

Returns true if box intersects with another box.

Definition at line 92 of file qgsbox3d.cpp.

is2d()

bool QgsBox3d::is2d

(

)

const

Returns true if the box can be considered a 2-dimensional box, i.e.

it has equal minimum and maximum z values.

Definition at line 87 of file qgsbox3d.cpp.

normalize()

void QgsBox3d::normalize

(

)

Normalize the box so it has non-negative width/height/depth.

Definition at line 69 of file qgsbox3d.cpp.

operator==()

bool QgsBox3d::operator==

(

const QgsBox3d &

other

)

const

Definition at line 130 of file qgsbox3d.cpp.

scale() [1/2]

void QgsBox3d::scale	(	double	scaleFactor,
		const QgsPoint &	center = QgsPoint()
	)

Scale the rectangle around a center QgsPoint.

If no center point is specified then the current center of the box will be used.

Since

QGIS 3.26

Definition at line 137 of file qgsbox3d.cpp.

scale() [2/2]

void QgsBox3d::scale	(	double	scaleFactor,
		double	centerX,
		double	centerY,
		double	centerZ
	)

Scale the rectangle around a center coordinates.

Since

QGIS 3.26

Definition at line 156 of file qgsbox3d.cpp.

setXMaximum()

void QgsBox3d::setXMaximum

(

double

x

)

Sets the maximum x value.

See also

xMaximum()

setXMinimum()

Definition at line 44 of file qgsbox3d.cpp.

setXMinimum()

void QgsBox3d::setXMinimum

(

double

x

)

Sets the minimum x value.

See also

xMinimum()

setXMaximum()

Definition at line 39 of file qgsbox3d.cpp.

setYMaximum()

void QgsBox3d::setYMaximum

(

double

y

)

Sets the maximum y value.

See also

yMaximum()

setYMinimum()

Definition at line 54 of file qgsbox3d.cpp.

setYMinimum()

void QgsBox3d::setYMinimum

(

double

y

)

Sets the minimum y value.

See also

yMinimum()

setYMaximum()

Definition at line 49 of file qgsbox3d.cpp.

setZMaximum()

void QgsBox3d::setZMaximum

(

double

z

)

Sets the maximum z value.

See also

zMaximum()

setZMinimum()

Definition at line 64 of file qgsbox3d.cpp.

setZMinimum()

void QgsBox3d::setZMinimum

(

double

z

)

Sets the minimum z value.

See also

zMinimum()

setZMaximum()

Definition at line 59 of file qgsbox3d.cpp.

toRectangle()

QgsRectangle QgsBox3d::toRectangle ( ) const

inline

Converts the box to a 2D rectangle.

Definition at line 206 of file qgsbox3d.h.

volume()

double QgsBox3d::volume ( ) const

inline

Returns the volume of the box.

Definition at line 172 of file qgsbox3d.h.

width()

double QgsBox3d::width ( ) const

inline

Returns the width of the box.

See also

height()

depth()

Definition at line 153 of file qgsbox3d.h.

xMaximum()

double QgsBox3d::xMaximum ( ) const

inline

Returns the maximum x value.

See also

setXMaximum()

xMinimum()

Definition at line 85 of file qgsbox3d.h.

xMinimum()

double QgsBox3d::xMinimum ( ) const

inline

Returns the minimum x value.

See also

setXMinimum()

xMaximum()

Definition at line 78 of file qgsbox3d.h.

yMaximum()

double QgsBox3d::yMaximum ( ) const

inline

Returns the maximum y value.

See also

setYMaximum()

yMinimum()

Definition at line 113 of file qgsbox3d.h.

yMinimum()

double QgsBox3d::yMinimum ( ) const

inline

Returns the minimum y value.

See also

setYMinimum()

yMaximum()

Definition at line 106 of file qgsbox3d.h.

zMaximum()

double QgsBox3d::zMaximum ( ) const

inline

Returns the maximum z value.

See also

setZMaximum()

zMinimum()

Definition at line 141 of file qgsbox3d.h.

zMinimum()

double QgsBox3d::zMinimum ( ) const

inline

Returns the minimum z value.

See also

setZMinimum()

zMaximum()

Definition at line 134 of file qgsbox3d.h.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.28.0+99sid/src/core/geometry/qgsbox3d.h
• /build/qgis-3.28.0+99sid/src/core/geometry/qgsbox3d.cpp