mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-26 00:02:08 -05:00
Because 3D coordinates should be the default. References https://github.com/qgis/qgis3.0_api/issues/36
214 lines
4.8 KiB
Plaintext
214 lines
4.8 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/geometry/qgsbox3d.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
class QgsBox3d
|
|
{
|
|
%Docstring
|
|
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.
|
|
|
|
.. versionadded:: 3.0
|
|
.. seealso:: QgsRectangle
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsbox3d.h"
|
|
%End
|
|
public:
|
|
|
|
QgsBox3d( double xmin = 0, double ymin = 0, double zmin = 0, double xmax = 0, double ymax = 0, double zmax = 0 );
|
|
%Docstring
|
|
Constructor for QgsBox3D which accepts the ranges of x/y/z coordinates.
|
|
%End
|
|
|
|
QgsBox3d( const QgsPoint &p1, const QgsPoint &p2 );
|
|
%Docstring
|
|
Constructs a QgsBox3D from two points representing opposite corners of the box.
|
|
The box is normalized after construction.
|
|
%End
|
|
|
|
void setXMinimum( double x );
|
|
%Docstring
|
|
Sets the minimum ``x`` value.
|
|
.. seealso:: xMinimum()
|
|
.. seealso:: setXMaximum()
|
|
%End
|
|
|
|
void setXMaximum( double x );
|
|
%Docstring
|
|
Sets the maximum ``x`` value.
|
|
.. seealso:: xMaximum()
|
|
.. seealso:: setXMinimum()
|
|
%End
|
|
|
|
double xMinimum() const;
|
|
%Docstring
|
|
Returns the minimum x value.
|
|
.. seealso:: setXMinimum()
|
|
.. seealso:: xMaximum()
|
|
:rtype: float
|
|
%End
|
|
|
|
double xMaximum() const;
|
|
%Docstring
|
|
Returns the maximum x value.
|
|
.. seealso:: setXMaximum()
|
|
.. seealso:: xMinimum()
|
|
:rtype: float
|
|
%End
|
|
|
|
void setYMinimum( double y );
|
|
%Docstring
|
|
Sets the minimum ``y`` value.
|
|
.. seealso:: yMinimum()
|
|
.. seealso:: setYMaximum()
|
|
%End
|
|
|
|
void setYMaximum( double y );
|
|
%Docstring
|
|
Sets the maximum ``y`` value.
|
|
.. seealso:: yMaximum()
|
|
.. seealso:: setYMinimum()
|
|
%End
|
|
|
|
double yMinimum() const;
|
|
%Docstring
|
|
Returns the minimum y value.
|
|
.. seealso:: setYMinimum()
|
|
.. seealso:: yMaximum()
|
|
:rtype: float
|
|
%End
|
|
|
|
double yMaximum() const;
|
|
%Docstring
|
|
Returns the maximum y value.
|
|
.. seealso:: setYMaximum()
|
|
.. seealso:: yMinimum()
|
|
:rtype: float
|
|
%End
|
|
|
|
void setZMinimum( double z );
|
|
%Docstring
|
|
Sets the minimum ``z`` value.
|
|
.. seealso:: zMinimum()
|
|
.. seealso:: setZMaximum()
|
|
%End
|
|
|
|
void setZMaximum( double z );
|
|
%Docstring
|
|
Sets the maximum ``z`` value.
|
|
.. seealso:: zMaximum()
|
|
.. seealso:: setZMinimum()
|
|
%End
|
|
|
|
double zMinimum() const;
|
|
%Docstring
|
|
Returns the minimum z value.
|
|
.. seealso:: setZMinimum()
|
|
.. seealso:: zMaximum()
|
|
:rtype: float
|
|
%End
|
|
|
|
double zMaximum() const;
|
|
%Docstring
|
|
Returns the maximum z value.
|
|
.. seealso:: setZMaximum()
|
|
.. seealso:: zMinimum()
|
|
:rtype: float
|
|
%End
|
|
|
|
void normalize();
|
|
%Docstring
|
|
Normalize the box so it has non-negative width/height/depth.
|
|
%End
|
|
|
|
double width() const;
|
|
%Docstring
|
|
Returns the width of the box.
|
|
.. seealso:: height()
|
|
.. seealso:: depth()
|
|
:rtype: float
|
|
%End
|
|
|
|
double height() const;
|
|
%Docstring
|
|
Returns the height of the box.
|
|
.. seealso:: width()
|
|
.. seealso:: depth()
|
|
:rtype: float
|
|
%End
|
|
|
|
double depth() const;
|
|
%Docstring
|
|
Returns the depth of the box.
|
|
.. seealso:: width()
|
|
.. seealso:: height()
|
|
:rtype: float
|
|
%End
|
|
|
|
double volume() const;
|
|
%Docstring
|
|
Returns the volume of the box.
|
|
:rtype: float
|
|
%End
|
|
|
|
QgsBox3d intersect( const QgsBox3d &other ) const;
|
|
%Docstring
|
|
Returns the intersection of this box and another 3D box.
|
|
:rtype: QgsBox3d
|
|
%End
|
|
|
|
bool is2d() const;
|
|
%Docstring
|
|
Returns true if the box can be considered a 2-dimensional box, i.e.
|
|
it has equal minimum and maximum z values.
|
|
:rtype: bool
|
|
%End
|
|
|
|
bool intersects( const QgsBox3d &other ) const;
|
|
%Docstring
|
|
Returns true if box intersects with another box.
|
|
:rtype: bool
|
|
%End
|
|
|
|
bool contains( const QgsBox3d &other ) const;
|
|
%Docstring
|
|
Returns true when box contains other box.
|
|
:rtype: bool
|
|
%End
|
|
|
|
bool contains( const QgsPoint &point ) const;
|
|
%Docstring
|
|
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.
|
|
:rtype: bool
|
|
%End
|
|
|
|
QgsRectangle toRectangle() const;
|
|
%Docstring
|
|
Converts the box to a 2D rectangle.
|
|
:rtype: QgsRectangle
|
|
%End
|
|
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/geometry/qgsbox3d.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|