// Copyright (c) 2009 INRIA Sophia-Antipolis (France). // All rights reserved. // // This file is part of CGAL (www.cgal.org). // // $URL$ // $Id$ // SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-Commercial // // // Author(s) : Stéphane Tayeb, Pierre Alliez, Camille Wormser // #ifndef CGAL_AABB_TRAITS_2_H_ #define CGAL_AABB_TRAITS_2_H_ #include #include #include #include #include #include #include #include #include #include #include #include #include /// \file AABB_traits_2.h namespace CGAL { namespace internal{ namespace AABB_tree { // AABB_traits_intersection_base_2 brings in the Intersection_distance predicate, // if GeomTraits is a model RayIntersectionGeomTraits. template ::value> struct AABB_traits_intersection_base_2; template struct AABB_traits_intersection_base_2{}; template struct AABB_traits_intersection_base_2{ template friend class AABB_ray_intersection; private: typedef typename GeomTraits::FT FT; typedef typename GeomTraits::Point_2 Point; typedef typename GeomTraits::Cartesian_const_iterator_2 Cartesian_const_iterator; typedef typename GeomTraits::Construct_cartesian_const_iterator_2 Construct_cartesian_const_iterator; static Construct_cartesian_const_iterator construct_cartesian_const_iterator_object() { return GeomTraits().construct_cartesian_const_iterator_2_object(); } public: typedef typename GeomTraits::Ray_2 Ray; typedef typename GeomTraits::Vector_2 Vector; typedef typename GeomTraits::Construct_source_2 Construct_source; typedef typename GeomTraits::Construct_vector_2 Construct_vector; static Construct_source construct_source_object() { return GeomTraits().construct_source_2_object(); } static Construct_vector construct_vector_object() { return GeomTraits().construct_vector_2_object(); } // Defining Bounding_box and other types from the full AABB_traits_2 // here might seem strange, but otherwise we would need to use // CRTP to get access to the derived class, which would bloat the // code more. typedef typename CGAL::Bbox_2 Bounding_box; struct Intersection_distance { std::optional operator()(const Ray& ray, const Bounding_box& bbox) const { FT t_near = -DBL_MAX; // std::numeric_limits::lowest(); C++1903 FT t_far = DBL_MAX; const Construct_cartesian_const_iterator construct_cartesian_const_iterator_2 = GeomTraits().construct_cartesian_const_iterator_2_object(); const Construct_source construct_source_2 = GeomTraits().construct_source_2_object(); const Construct_vector construct_vector_2 = GeomTraits().construct_vector_2_object(); const Point source = construct_source_2(ray); const Vector direction = construct_vector_2(ray); Cartesian_const_iterator source_iter = construct_cartesian_const_iterator_2(source); Cartesian_const_iterator direction_iter = construct_cartesian_const_iterator_2(direction); for(int i = 0; i < 2; ++i, ++source_iter, ++direction_iter) { if(*direction_iter == 0) { if((*source_iter < (bbox.min)(i)) || (*source_iter > (bbox.max)(i))) { return std::nullopt; } } else { FT t1 = ((bbox.min)(i) - *source_iter) / *direction_iter; FT t2 = ((bbox.max)(i) - *source_iter) / *direction_iter; t_near = (std::max)(t_near, (std::min)(t1, t2)); t_far = (std::min)(t_far, (std::max)(t1, t2)); if(t_near > t_far || t_far < FT(0.)) return std::nullopt; } } if(t_near < FT(0.)) return FT(0.); else return t_near; } }; Intersection_distance intersection_distance_object() const { return Intersection_distance(); } }; } } //end of namespace internal::AABB_tree /// \addtogroup PkgAABBTreeRef /// @{ // forward declaration template< typename AABBTraits> class AABB_tree; /// This traits class handles any type of 2D geometric /// primitives provided that the proper intersection tests and /// constructions are implemented. It handles points, rays, lines and /// segments as query types for intersection detection and /// computations, and it handles points as query type for distance /// queries. /// /// \cgalModels{AABBTraits,AABBRayIntersectionTraits} /// /// \tparam GeomTraits must be a model of the concept \ref AABBGeomTraits_2, /// and provide the geometric types as well as the intersection tests and computations. /// \tparam Primitive provide the type of primitives stored in the AABB_tree. /// It is a model of the concept `AABBPrimitive` or `AABBPrimitiveWithSharedData`. /// /// \tparam BboxMap must be a model of `ReadablePropertyMap` that has as key type a primitive id, /// and as value type a `Bounding_box`. /// If the type is `Default` the `Datum` must have the /// member function `bbox()` that returns the bounding box of the primitive. /// /// If the argument `GeomTraits` is a model of the concept \ref /// AABBRayIntersectionGeomTraits_2, this class is also a model of \ref /// AABBRayIntersectionTraits. /// /// \sa `AABBTraits` /// \sa `AABB_tree` /// \sa `AABBPrimitive` /// \sa `AABBPrimitiveWithSharedData` template class AABB_traits_2 #ifndef DOXYGEN_RUNNING : public internal::AABB_tree::AABB_traits_base, public internal::AABB_tree::AABB_traits_intersection_base_2, public Search_traits_2 #endif { typedef typename CGAL::Object Object; typedef GeomTraits Geom_traits; public: typedef AABB_traits_2 AT; // AABBTraits concept types typedef typename GeomTraits::FT FT; typedef AABBPrimitive Primitive; typedef typename std::pair Object_and_primitive_id; typedef typename std::pair Point_and_primitive_id; /// `Intersection_and_primitive_id::%Type::first_type` is found according to /// the result type of `GeomTraits::Intersect_2::operator()`. If it is /// `std::optional` then it is `T`, and the result type otherwise. template struct Intersection_and_primitive_id { typedef decltype( std::declval()( std::declval(), std::declval())) Intersection_type; typedef std::pair< typename internal::Remove_optional::type, typename Primitive::Id > Type; }; // types for search tree /// \name Types /// @{ /// /// point type /// typedef typename GeomTraits::Point_2 Point; /// additional types for the search tree, required by the RangeSearchTraits concept /// \bug This is not documented for now in the AABBTraits concept. typedef typename GeomTraits::Iso_rectangle_2 Iso_rectangle_2; /// Bounding box type. typedef typename CGAL::Bbox_2 Bounding_box; /// @} typedef typename GeomTraits::Circle_2 Circle_2; typedef typename GeomTraits::Cartesian_const_iterator_2 Cartesian_const_iterator_2; typedef typename GeomTraits::Construct_cartesian_const_iterator_2 Construct_cartesian_const_iterator_2; typedef typename GeomTraits::Construct_center_2 Construct_center_2; typedef typename GeomTraits::Compute_squared_radius_2 Compute_squared_radius_2; typedef typename GeomTraits::Construct_min_vertex_2 Construct_min_vertex_2; typedef typename GeomTraits::Construct_max_vertex_2 Construct_max_vertex_2; typedef typename GeomTraits::Construct_iso_rectangle_2 Construct_iso_rectangle_2; BboxMap bbm; /// Default constructor. AABB_traits_2() { } AABB_traits_2(BboxMap bbm) : bbm(bbm) {} typedef typename GeomTraits::Compute_squared_distance_2 Squared_distance; Squared_distance squared_distance_object() const { return GeomTraits().compute_squared_distance_2_object(); } typedef typename GeomTraits::Equal_2 Equal; Equal equal_object() const { return GeomTraits().equal_2_object(); } /** * @internal * @brief Sorts [first,beyond[ * @param first iterator on first element * @param beyond iterator on beyond element * @param bbox the bounding box of [first,beyond[ * * Sorts the range defined by [first,beyond[. Sort is achieved on bbox longest * axis, using the comparison function `_less_than` (dim in {x,y,z}) */ class Split_primitives { typedef AABB_traits_2 Traits; const Traits& m_traits; public: Split_primitives(const AABB_traits_2& traits) : m_traits(traits) {} typedef void result_type; template void operator()(PrimitiveIterator first, PrimitiveIterator beyond, const typename AT::Bounding_box& bbox) const { PrimitiveIterator middle = first + (beyond - first)/2; switch(Traits::longest_axis(bbox)) { case AT::CGAL_AXIS_X: // sort along x std::nth_element(first, middle, beyond, [this](const Primitive& p1, const Primitive& p2){ return Traits::less_x(p1, p2, this->m_traits); }); break; case AT::CGAL_AXIS_Y: // sort along y std::nth_element(first, middle, beyond, [this](const Primitive& p1, const Primitive& p2){ return Traits::less_y(p1, p2, this->m_traits); }); break; default: CGAL_error(); } } }; Split_primitives split_primitives_object() const {return Split_primitives(*this);} /* * Computes the bounding box of a set of primitives * @param first an iterator on the first primitive * @param beyond an iterator on the past-the-end primitive * @return the bounding box of the primitives of the iterator range */ class Compute_bbox { const AABB_traits_2& m_traits; public: Compute_bbox(const AABB_traits_2& traits) :m_traits (traits) {} template typename AT::Bounding_box operator()(ConstPrimitiveIterator first, ConstPrimitiveIterator beyond) const { typename AT::Bounding_box bbox = m_traits.compute_bbox(*first,m_traits.bbm); for(++first; first != beyond; ++first) { bbox = bbox + m_traits.compute_bbox(*first,m_traits.bbm); } return bbox; } }; Compute_bbox compute_bbox_object() const {return Compute_bbox(*this);} /// \brief Function object using `GeomTraits::Do_intersect`. /// In the case the query is a `CGAL::AABB_tree`, the `do_intersect()` /// function of this tree is used. class Do_intersect { const AABB_traits_2& m_traits; public: Do_intersect(const AABB_traits_2& traits) :m_traits(traits) {} template bool operator()(const Query& q, const Bounding_box& bbox) const { return GeomTraits().do_intersect_2_object()(q, bbox); } template bool operator()(const Query& q, const Primitive& pr) const { return GeomTraits().do_intersect_2_object()(q, internal::Primitive_helper::get_datum(pr,m_traits)); } // intersection with AABB-tree template bool operator()(const CGAL::AABB_tree& other_tree, const Primitive& pr) const { return other_tree.do_intersect( internal::Primitive_helper::get_datum(pr,m_traits) ); } template bool operator()(const CGAL::AABB_tree& other_tree, const Bounding_box& bbox) const { return other_tree.do_intersect(bbox); } }; Do_intersect do_intersect_object() const {return Do_intersect(*this);} class Intersection { const AABB_traits_2& m_traits; public: Intersection(const AABB_traits_2& traits) :m_traits(traits) {} template std::optional< typename Intersection_and_primitive_id::Type > operator()(const Query& query, const typename AT::Primitive& primitive) const { auto inter_res = GeomTraits().intersect_2_object()(query, internal::Primitive_helper::get_datum(primitive,m_traits)); if (!inter_res) return std::nullopt; return std::make_optional( std::make_pair(*inter_res, primitive.id()) ); } }; Intersection intersection_object() const {return Intersection(*this);} // This should go down to the GeomTraits, i.e. the kernel class Closest_point { typedef typename AT::Point Point; typedef typename AT::Primitive Primitive; const AABB_traits_2& m_traits; public: Closest_point(const AABB_traits_2& traits) : m_traits(traits) {} Point operator()(const Point& p, const Primitive& pr, const Point& bound) const { GeomTraits geom_traits; Point closest_point = geom_traits.construct_projected_point_2_object()( internal::Primitive_helper::get_datum(pr,m_traits), p); return (geom_traits.compare_distance_2_object()(p, closest_point, bound) == LARGER) ? bound : closest_point; } }; // This should go down to the GeomTraits, i.e. the kernel // and the internal implementation should change its name from // do_intersect to something like does_contain (this is what we compute, // this is not the same do_intersect as the spherical kernel) class Compare_distance { typedef typename AT::Point Point; typedef typename AT::FT FT; typedef typename AT::Primitive Primitive; public: CGAL::Comparison_result operator()(const Point& p, const Bounding_box& bb, const Point& bound, Tag_true) const { return GeomTraits().do_intersect_2_object() (GeomTraits().construct_circle_2_object() (p, GeomTraits().compute_squared_distance_2_object()(p, bound)), bb,true)? CGAL::SMALLER : CGAL::LARGER; } CGAL::Comparison_result operator()(const Point& p, const Bounding_box& bb, const Point& bound, Tag_false) const { return GeomTraits().do_intersect_2_object() (GeomTraits().construct_circle_2_object() (p, GeomTraits().compute_squared_distance_2_object()(p, bound)), bb)? CGAL::SMALLER : CGAL::LARGER; } CGAL::Comparison_result operator()(const Point& p, const Bounding_box& bb, const Point& bound) const { return (*this)(p, bb, bound, Boolean_tag::value>()); } // The following functions seem unused...? template CGAL::Comparison_result operator()(const Point& p, const Solid& pr, const Point& bound) const { return GeomTraits().do_intersect_2_object() (GeomTraits().construct_circle_2_object() (p, GeomTraits().compute_squared_distance_2_object()(p, bound)), pr)? CGAL::SMALLER : CGAL::LARGER; } template CGAL::Comparison_result operator()(const Point& p, const Solid& pr, const FT& sq_distance) const { return GeomTraits().do_intersect_2_object() (GeomTraits().construct_circle_2_object()(p, sq_distance), pr) ? CGAL::SMALLER : CGAL::LARGER; } }; Closest_point closest_point_object() const {return Closest_point(*this);} Compare_distance compare_distance_object() const {return Compare_distance();} typedef enum { CGAL_AXIS_X = 0, CGAL_AXIS_Y = 1} Axis; static Axis longest_axis(const Bounding_box& bbox); private: /** * @brief Computes bounding box of one primitive * @param pr the primitive * @return the bounding box of the primitive \c pr */ template Bounding_box compute_bbox(const Primitive& pr, const PM&)const { return get(bbm, pr.id()); } Bounding_box compute_bbox(const Primitive& pr, const Default&)const { return GeomTraits().construct_bbox_2_object()(internal::Primitive_helper::get_datum(pr, *this)); } /// Comparison functions static bool less_x(const Primitive& pr1, const Primitive& pr2,const AABB_traits_2& traits) { return GeomTraits().less_x_2_object()( internal::Primitive_helper::get_reference_point(pr1,traits), internal::Primitive_helper::get_reference_point(pr2,traits) ); } static bool less_y(const Primitive& pr1, const Primitive& pr2,const AABB_traits_2& traits) { return GeomTraits().less_y_2_object()( internal::Primitive_helper::get_reference_point(pr1,traits), internal::Primitive_helper::get_reference_point(pr2,traits) ); } }; // end class AABB_traits_2 //------------------------------------------------------- // Private methods //------------------------------------------------------- template typename AABB_traits_2::Axis AABB_traits_2::longest_axis(const Bounding_box& bbox) { const double dx = bbox.xmax() - bbox.xmin(); const double dy = bbox.ymax() - bbox.ymin(); if(dx>=dy) { return CGAL_AXIS_X; } else { return CGAL_AXIS_Y; } } /// @} } // end namespace CGAL #include #endif // CGAL_AABB_TRAITS_2_H_