// Copyright (c) 2005 Tel-Aviv University (Israel). // All rights reserved. // // This file is part of CGAL (www.cgal.org); you may redistribute it under // the terms of the Q Public License version 1.0. // See the file LICENSE.QPL distributed with CGAL. // // Licensees holding a valid commercial license may use this file in // accordance with the commercial license agreement provided with the software. // // This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE // WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. // // $URL$ // $Id$ // // // Author(s) : Idit Haran #ifndef CGAL_ARR_TRIANGULATION_POINT_LOCATION_H #define CGAL_ARR_TRIANGULATION_POINT_LOCATION_H /*! \file * Definition of the Arr_triangulation_point_location template. */ #include #include #include #include #include #include #include #include CGAL_BEGIN_NAMESPACE /*! \class * A class that answers point-location and queries * on a planar arrangement using the triangulation algorithm. * The Arrangement parameter corresponds to an arrangement instantiation. */ template class Arr_triangulation_point_location : public Arr_observer { public: typedef Arrangement_ Arrangement_2; typedef typename Arrangement_2::Traits_2 Traits_2; typedef typename Traits_2::Kernel Kernel; typedef typename Arrangement_2::Vertex_const_handle Vertex_const_handle; typedef typename Arrangement_2::Halfedge_const_handle Halfedge_const_handle; typedef typename Arrangement_2::Face_const_handle Face_const_handle; typedef typename Arrangement_2::Vertex_handle Vertex_handle; typedef typename Arrangement_2::Halfedge_handle Halfedge_handle; typedef typename Arrangement_2::Face_handle Face_handle; typedef typename Arrangement_2::Vertex_const_iterator Vertex_const_iterator; typedef typename Arrangement_2::Edge_const_iterator Edge_const_iterator; typedef typename Arrangement_2::Hole_const_iterator Hole_const_iterator; typedef typename Arrangement_2::Halfedge_const_iterator Halfedge_const_iterator; typedef typename Arrangement_2::Halfedge_around_vertex_const_circulator Halfedge_around_vertex_const_circulator; typedef typename Arrangement_2::Ccb_halfedge_const_circulator Ccb_halfedge_const_circulator; typedef typename Arrangement_2::Ccb_halfedge_circulator Ccb_halfedge_circulator; typedef typename Arrangement_2::Isolated_vertex_const_iterator Isolated_vertex_const_iterator; typedef typename Traits_2::Point_2 Point_2; typedef typename Traits_2::X_monotone_curve_2 X_monotone_curve_2; typedef std::list Edge_list; typedef typename Edge_list::iterator Std_edge_iterator; //---------------------------------------------------------- // Triangulation Types //---------------------------------------------------------- typedef Triangulation_vertex_base_with_info_2 Vbb; typedef Triangulation_hierarchy_vertex_base_2 Vb; //typedef Triangulation_face_base_with_info_2 Fbt; typedef Constrained_triangulation_face_base_2 Fb; typedef Triangulation_data_structure_2 TDS; typedef Exact_predicates_tag Itag; //typedef Constrained_Delaunay_triangulation_2 CDT; typedef Constrained_Delaunay_triangulation_2 CDT_t; typedef Triangulation_hierarchy_2 CDTH; typedef Constrained_triangulation_plus_2 CDT; typedef typename CDT::Point CDT_Point; typedef typename CDT::Edge CDT_Edge; typedef typename CDT::Face_handle CDT_Face_handle; typedef typename CDT::Vertex_handle CDT_Vertex_handle; typedef typename CDT::Finite_faces_iterator CDT_Finite_faces_iterator; typedef typename CDT::Finite_vertices_iterator CDT_Finite_vertices_iterator; typedef typename CDT::Finite_edges_iterator CDT_Finite_edges_iterator; typedef typename CDT::Locate_type CDT_Locate_type; protected: typedef Arr_traits_basic_adaptor_2 Traits_adaptor_2; // Data members: const Traits_adaptor_2 *traits; // Its associated traits object. bool ignore_notifications; CDT cdt; bool updated_cdt; public: /*! Default constructor. */ Arr_triangulation_point_location () : traits (NULL) { } /*! Constructor given an arrangement. */ Arr_triangulation_point_location (const Arrangement_2& arr) : Arr_observer (const_cast(arr)) { build_triangulation(); } /*! * Locate the arrangement feature containing the given point. * \param p The query point. * \return An object representing the arrangement feature containing the * query point. This object is either a Face_const_handle or a * Halfedge_const_handle or a Vertex_const_handle. */ Object locate (const Point_2& p) const; //Observer functions that are relevant to overload //------------------------------------------------- /*! Attach an arrangement object. */ virtual void before_attach (const Arrangement_2& arr) { traits = static_cast (arr.get_traits()); } virtual void after_attach () { build_triangulation(); } virtual void before_detach () { clear_triangulation(); } /*! * Notification after the arrangement has been assigned with another * arrangement. * \param u A handle to the unbounded face. */ virtual void after_assign () { clear_triangulation(); build_triangulation(); } /*! * Notification after the arrangement is cleared. * \param u A handle to the unbounded face. */ virtual void after_clear (Face_handle /* u */) { clear_triangulation(); build_triangulation(); } /*! Notification before a global operation modifies the arrangement. */ virtual void before_global_change () { clear_triangulation(); ignore_notifications = true; } /*! Notification after a global operation is completed. */ virtual void after_global_change () { build_triangulation(); ignore_notifications = false; } /*! * Notification after the creation of a new vertex. * \param v A handle to the created vertex. */ virtual void after_create_vertex (Vertex_handle /* v */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after the creation of a new edge. * \param e A handle to one of the twin halfedges that were created. */ virtual void after_create_edge (Halfedge_handle /* e */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after an edge was split. * \param e1 A handle to one of the twin halfedges forming the first edge. * \param e2 A handle to one of the twin halfedges forming the second edge. */ virtual void after_split_edge (Halfedge_handle /* e1 */, Halfedge_handle /* e2 */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after a face was split. * \param f A handle to the face we have just split. * \param new_f A handle to the new face that has been created. * \param is_hole Whether the new face forms a hole inside f. */ virtual void after_split_face (Face_handle /* f */, Face_handle /* new_f */, bool /* is_hole */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after a hole was created inside a face. * \param h A circulator representing the boundary of the new hole. */ virtual void after_add_hole (Ccb_halfedge_circulator /* h */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after an edge was merged. * \param e A handle to one of the twin halfedges forming the merged edge. */ virtual void after_merge_edge (Halfedge_handle /* e */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after a face was merged. * \param f A handle to the merged face. */ virtual void after_merge_face (Face_handle /* f */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification after a hole is moved from one face to another. * \param h A circulator representing the boundary of the hole. */ virtual void after_move_hole (Ccb_halfedge_circulator /* h */) { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notificaion before the removal of a vertex. * \param v A handle to the vertex to be deleted. */ virtual void after_remove_vertex () { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification before the removal of an edge. * \param e A handle to one of the twin halfedges to be deleted. */ virtual void after_remove_edge () { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } /*! * Notification before the removal of a hole. * \param h A circulator representing the boundary of the hole. */ virtual void after_remove_hole () { if (! ignore_notifications) { clear_triangulation(); build_triangulation(); } } protected: void clear_triangulation (); void build_triangulation(); }; CGAL_END_NAMESPACE // The member-function definitions can be found under: #include #endif