102 lines
3.2 KiB
C
102 lines
3.2 KiB
C
|
#pragma once
|
||
|
|
|
||
|
|
#include "GlobeRectangle.h"
|
||
|
|
#include "Library.h"
|
||
|
|
|
||
|
|
#include <glm/vec2.hpp>
|
||
|
|
|
||
|
|
#include <optional>
|
||
|
|
#include <string>
|
||
|
|
#include <vector>
|
||
|
|
|
||
|
|
namespace CesiumGeospatial {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief A 2D polygon expressed as a list of longitude/latitude coordinates in
|
||
|
|
* radians.
|
||
|
|
*
|
||
|
|
* The {@link Ellipsoid} associated with the coordinates is not specified
|
||
|
|
* directly by this instance, but it is assumed that the longitude values range
|
||
|
|
* from -PI to PI radians and the latitude values range from -PI/2 to PI/2
|
||
|
|
* radians. Longitude values outside this range are wrapped to be inside the
|
||
|
|
* range. Latitude values are clamped to the range.
|
||
|
|
*/
|
||
|
|
class CESIUMGEOSPATIAL_API CartographicPolygon final {
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* @brief Constructs a 2D polygon that can be rasterized onto {@link Cesium3DTilesSelection::Tileset}
|
||
|
|
* objects.
|
||
|
|
*
|
||
|
|
* @param polygon An array of longitude-latitude points in radians defining
|
||
|
|
* the perimeter of the 2D polygon.
|
||
|
|
*/
|
||
|
|
CartographicPolygon(const std::vector<glm::dvec2>& polygon);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Returns the longitude-latitude vertices that define the
|
||
|
|
* perimeter of the selected polygon.
|
||
|
|
*
|
||
|
|
* @return The perimeter vertices in longitude-latitude radians.
|
||
|
|
*/
|
||
|
|
constexpr const std::vector<glm::dvec2>& getVertices() const {
|
||
|
|
return this->_vertices;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Returns the triangulated indices representing a triangle
|
||
|
|
* decomposition of the polygon. The indices are in reference to the
|
||
|
|
* polygon's perimeter vertices.
|
||
|
|
*
|
||
|
|
* @return The indices for the polygon's triangle decomposition.
|
||
|
|
*/
|
||
|
|
constexpr const std::vector<uint32_t>& getIndices() const {
|
||
|
|
return this->_indices;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Returns a {@link GlobeRectangle} that represents the bounding
|
||
|
|
* rectangle of the polygon.
|
||
|
|
*
|
||
|
|
* @return The polygon's global bounding rectangle.
|
||
|
|
*/
|
||
|
|
constexpr const std::optional<CesiumGeospatial::GlobeRectangle>&
|
||
|
|
getBoundingRectangle() const {
|
||
|
|
return this->_boundingRectangle;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Determines whether a globe rectangle is completely inside any of the
|
||
|
|
* polygons in a list.
|
||
|
|
*
|
||
|
|
* @param rectangle The {@link CesiumGeospatial::GlobeRectangle} of the tile.
|
||
|
|
* @param cartographicPolygons The list of polygons to check.
|
||
|
|
* @return True if the rectangle is completely inside a polygon; otherwise,
|
||
|
|
* false.
|
||
|
|
*/
|
||
|
|
static bool rectangleIsWithinPolygons(
|
||
|
|
const CesiumGeospatial::GlobeRectangle& rectangle,
|
||
|
|
const std::vector<CesiumGeospatial::CartographicPolygon>&
|
||
|
|
cartographicPolygons) noexcept;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Determines whether a globe rectangle is completely outside all the
|
||
|
|
* polygons in a list.
|
||
|
|
*
|
||
|
|
* @param rectangle The {@link CesiumGeospatial::GlobeRectangle} of the tile.
|
||
|
|
* @param cartographicPolygons The list of polygons to check.
|
||
|
|
* @return True if the rectangle is completely outside all the polygons;
|
||
|
|
* otherwise, false.
|
||
|
|
*/
|
||
|
|
static bool rectangleIsOutsidePolygons(
|
||
|
|
const CesiumGeospatial::GlobeRectangle& rectangle,
|
||
|
|
const std::vector<CesiumGeospatial::CartographicPolygon>&
|
||
|
|
cartographicPolygons) noexcept;
|
||
|
|
|
||
|
|
private:
|
||
|
|
std::vector<glm::dvec2> _vertices;
|
||
|
|
std::vector<uint32_t> _indices;
|
||
|
|
std::optional<CesiumGeospatial::GlobeRectangle> _boundingRectangle;
|
||
|
|
};
|
||
|
|
|
||
|
|
} // namespace CesiumGeospatial
|