// Boost.Geometry (aka GGL, Generic Geometry Library) // Copyright (c) 2007-2014 Barend Gehrels, Amsterdam, the Netherlands. // Copyright (c) 2008-2014 Bruno Lalande, Paris, France. // Copyright (c) 2009-2014 Mateusz Loskot, London, UK. // This file was modified by Oracle on 2014-2023. // Modifications copyright (c) 2014-2023, Oracle and/or its affiliates. // Contributed and/or modified by Vissarion Fysikopoulos, on behalf of Oracle // Contributed and/or modified by Menelaos Karavelas, on behalf of Oracle // Contributed and/or modified by Adam Wulkiewicz, on behalf of Oracle // Parts of Boost.Geometry are redesigned from Geodan's Geographic Library // (geolib/GGL), copyright (c) 1995-2010 Geodan, Amsterdam, the Netherlands. // Use, modification and distribution is subject to the Boost Software License, // Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at // http://www.boost.org/LICENSE_1_0.txt) #ifndef BOOST_GEOMETRY_ALGORITHMS_PERIMETER_HPP #define BOOST_GEOMETRY_ALGORITHMS_PERIMETER_HPP #include <boost/range/value_type.hpp> #include <boost/geometry/algorithms/length.hpp> #include <boost/geometry/algorithms/detail/calculate_null.hpp> #include <boost/geometry/algorithms/detail/calculate_sum.hpp> #include <boost/geometry/algorithms/detail/multi_sum.hpp> // #include <boost/geometry/algorithms/detail/throw_on_empty_input.hpp> #include <boost/geometry/algorithms/detail/visit.hpp> #include <boost/geometry/core/closure.hpp> #include <boost/geometry/core/tags.hpp> #include <boost/geometry/core/visit.hpp> #include <boost/geometry/geometries/adapted/boost_variant.hpp> // For backward compatibility #include <boost/geometry/geometries/concepts/check.hpp> #include <boost/geometry/strategies/default_length_result.hpp> #include <boost/geometry/strategies/default_strategy.hpp> #include <boost/geometry/strategies/detail.hpp> #include <boost/geometry/strategies/length/cartesian.hpp> #include <boost/geometry/strategies/length/geographic.hpp> #include <boost/geometry/strategies/length/spherical.hpp> namespace boost { namespace geometry { #ifndef DOXYGEN_NO_DISPATCH namespace dispatch { // Default perimeter is 0.0, specializations implement calculated values template <typename Geometry, typename Tag = typename tag<Geometry>::type> struct perimeter : detail::calculate_null { typedef typename default_length_result<Geometry>::type return_type; template <typename Strategy> static inline return_type apply(Geometry const& geometry, Strategy const& strategy) { return calculate_null::apply<return_type>(geometry, strategy); } }; template <typename Geometry> struct perimeter<Geometry, ring_tag> : detail::length::range_length < Geometry, closure<Geometry>::value > {}; template <typename Polygon> struct perimeter<Polygon, polygon_tag> : detail::calculate_polygon_sum { typedef typename default_length_result<Polygon>::type return_type; typedef detail::length::range_length < typename ring_type<Polygon>::type, closure<Polygon>::value > policy; template <typename Strategy> static inline return_type apply(Polygon const& polygon, Strategy const& strategy) { return calculate_polygon_sum::apply<return_type, policy>(polygon, strategy); } }; template <typename MultiPolygon> struct perimeter<MultiPolygon, multi_polygon_tag> : detail::multi_sum { typedef typename default_length_result<MultiPolygon>::type return_type; template <typename Strategy> static inline return_type apply(MultiPolygon const& multi, Strategy const& strategy) { return multi_sum::apply < return_type, perimeter<typename boost::range_value<MultiPolygon>::type> >(multi, strategy); } }; // box,n-sphere: to be implemented } // namespace dispatch #endif // DOXYGEN_NO_DISPATCH namespace resolve_strategy { template < typename Strategies, bool IsUmbrella = strategies::detail::is_umbrella_strategy<Strategies>::value > struct perimeter { template <typename Geometry> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, Strategies const& strategies) { return dispatch::perimeter<Geometry>::apply(geometry, strategies); } }; template <typename Strategy> struct perimeter<Strategy, false> { template <typename Geometry> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, Strategy const& strategy) { using strategies::length::services::strategy_converter; return dispatch::perimeter<Geometry>::apply( geometry, strategy_converter<Strategy>::get(strategy)); } }; template <> struct perimeter<default_strategy, false> { template <typename Geometry> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, default_strategy const&) { typedef typename strategies::length::services::default_strategy < Geometry >::type strategies_type; return dispatch::perimeter<Geometry>::apply(geometry, strategies_type()); } }; } // namespace resolve_strategy namespace resolve_dynamic { template <typename Geometry, typename Tag = typename geometry::tag<Geometry>::type> struct perimeter { template <typename Strategy> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, Strategy const& strategy) { concepts::check<Geometry const>(); return resolve_strategy::perimeter<Strategy>::apply(geometry, strategy); } }; template <typename Geometry> struct perimeter<Geometry, dynamic_geometry_tag> { template <typename Strategy> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, Strategy const& strategy) { typename default_length_result<Geometry>::type result = 0; traits::visit<Geometry>::apply([&](auto const& g) { result = perimeter<util::remove_cref_t<decltype(g)>>::apply(g, strategy); }, geometry); return result; } }; template <typename Geometry> struct perimeter<Geometry, geometry_collection_tag> { template <typename Strategy> static inline typename default_length_result<Geometry>::type apply(Geometry const& geometry, Strategy const& strategy) { typename default_length_result<Geometry>::type result = 0; detail::visit_breadth_first([&](auto const& g) { result += perimeter<util::remove_cref_t<decltype(g)>>::apply(g, strategy); return true; }, geometry); return result; } }; } // namespace resolve_dynamic /*! \brief \brief_calc{perimeter} \ingroup perimeter \details The function perimeter returns the perimeter of a geometry, using the default distance-calculation-strategy \tparam Geometry \tparam_geometry \param geometry \param_geometry \return \return_calc{perimeter} \qbk{[include reference/algorithms/perimeter.qbk]} \qbk{ [heading Example] [perimeter] [perimeter_output] } */ template<typename Geometry> inline typename default_length_result<Geometry>::type perimeter( Geometry const& geometry) { // detail::throw_on_empty_input(geometry); return resolve_dynamic::perimeter<Geometry>::apply(geometry, default_strategy()); } /*! \brief \brief_calc{perimeter} \brief_strategy \ingroup perimeter \details The function perimeter returns the perimeter of a geometry, using specified strategy \tparam Geometry \tparam_geometry \tparam Strategy \tparam_strategy{distance} \param geometry \param_geometry \param strategy strategy to be used for distance calculations. \return \return_calc{perimeter} \qbk{distinguish,with strategy} \qbk{[include reference/algorithms/perimeter.qbk]} */ template<typename Geometry, typename Strategy> inline typename default_length_result<Geometry>::type perimeter( Geometry const& geometry, Strategy const& strategy) { // detail::throw_on_empty_input(geometry); return resolve_dynamic::perimeter<Geometry>::apply(geometry, strategy); } }} // namespace boost::geometry #endif // BOOST_GEOMETRY_ALGORITHMS_PERIMETER_HPP