Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r71423 - in trunk/boost/geometry: core geometries/adapted
From: barend.gehrels_at_[hidden]
Date: 2011-04-22 18:27:35


Author: barendgehrels
Date: 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
New Revision: 71423
URL: http://svn.boost.org/trac/boost/changeset/71423

Log:
Doc update;
Added boost_polygon.hpp header including the other adaption headers
Added:
   trunk/boost/geometry/geometries/adapted/boost_polygon.hpp (contents, props changed)
Text files modified:
   trunk/boost/geometry/core/closure.hpp | 24 ++++++++++++++++--------
   trunk/boost/geometry/core/interior_type.hpp | 17 ++++++++++-------
   trunk/boost/geometry/core/point_order.hpp | 19 +++++++++++--------
   trunk/boost/geometry/core/ring_type.hpp | 11 +++++++----
   trunk/boost/geometry/core/tag.hpp | 2 ++
   5 files changed, 46 insertions(+), 27 deletions(-)

Modified: trunk/boost/geometry/core/closure.hpp
==============================================================================
--- trunk/boost/geometry/core/closure.hpp (original)
+++ trunk/boost/geometry/core/closure.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -32,11 +32,11 @@
 \brief Enumerates options for defining if polygons are open or closed
 \ingroup enum
 \details The enumeration closure_selector describes options for if a polygon is
- open or closed. In a closed polygon the very first point (per ring) should be
- equal to the very last point.
- The specific closing property of a polygon type is defined by the closure metafunction.
- The closure metafunction defines a value, which is one of the values enumerated
- in the closure_selector
+ open or closed. In a closed polygon the very first point (per ring) should
+ be equal to the very last point.
+ The specific closing property of a polygon type is defined by the closure
+ metafunction. The closure metafunction defines a value, which is one of the
+ values enumerated in the closure_selector
 
 \qbk{
 [heading See also]
@@ -45,8 +45,13 @@
 */
 enum closure_selector
 {
+ /// Rings are open: first point and last point are different, algorithms
+ /// close them explicitly on the fly
     open = 0,
+ /// Rings are closed: first point and last point must be the same
     closed = 1,
+ /// (Not yet implemented): algorithms first figure out if ring must be
+ /// closed on the fly
     closure_undertermined = -1
 };
 
@@ -123,13 +128,15 @@
 struct closure<segment_tag, Box> : public core_detail::closure::closed {};
 
 template <typename LineString>
-struct closure<linestring_tag, LineString> : public core_detail::closure::closed {};
+struct closure<linestring_tag, LineString>
+ : public core_detail::closure::closed {};
 
 
 template <typename Ring>
 struct closure<ring_tag, Ring>
 {
- static const closure_selector value = geometry::traits::closure<Ring>::value;
+ static const closure_selector value
+ = geometry::traits::closure<Ring>::value;
 };
 
 // Specialization for polygon: the closure is the closure of its rings
@@ -149,7 +156,8 @@
 
 
 /*!
-\brief \brief_meta{value, closure (clockwise\, counterclockwise), \meta_geometry_type}
+\brief \brief_meta{value, closure (clockwise\, counterclockwise),
+ \meta_geometry_type}
 \tparam Geometry \tparam_geometry
 \ingroup core
 

Modified: trunk/boost/geometry/core/interior_type.hpp
==============================================================================
--- trunk/boost/geometry/core/interior_type.hpp (original)
+++ trunk/boost/geometry/core/interior_type.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -123,13 +123,16 @@
 
 
 /*!
- \brief Meta-function defining container type
- of inner rings of (multi)polygon geometriy
- \details the interior rings should be organized as a container
- (std::vector, std::deque, boost::array) with
- boost range support. This meta function defines the type
- of that container.
- \ingroup core
+\brief \brief_meta{type, interior_type (container type
+ of inner rings), \meta_geometry_type}
+\details Interior rings should be organized as a container
+ (std::vector, std::deque, boost::array) with
+ Boost.Range support. This metafunction defines the type
+ of the container.
+\tparam Geometry A type fullfilling the Polygon or MultiPolygon concept.
+\ingroup core
+
+\qbk{[include reference/core/interior_type.qbk]}
 */
 template <typename Geometry>
 struct interior_type

Modified: trunk/boost/geometry/core/point_order.hpp
==============================================================================
--- trunk/boost/geometry/core/point_order.hpp (original)
+++ trunk/boost/geometry/core/point_order.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -29,11 +29,11 @@
 /*!
 \brief Enumerates options for the order of points within polygons
 \ingroup enum
-\details The enumeration order_selector describes options for the order of points
- within a polygon. Polygons can be ordered either clockwise or counterclockwise.
- The specific order of a polygon type is defined by the point_order metafunction.
- The point_order metafunction defines a value, which is one of the values enumerated
- in the order_selector
+\details The enumeration order_selector describes options for the order of
+ points within a polygon. Polygons can be ordered either clockwise or
+ counterclockwise. The specific order of a polygon type is defined by the
+ point_order metafunction. The point_order metafunction defines a value,
+ which is one of the values enumerated in the order_selector
 
 \qbk{
 [heading See also]
@@ -46,7 +46,8 @@
     clockwise = 1,
     /// Points are ordered counter clockwise
     counterclockwise = 2,
- /// Points might be stored in any order, the algorithm will find out (not yet supported)
+ /// Points might be stored in any order, algorithms will determine it on the
+ /// fly (not yet supported)
     order_undetermined = 0
 };
 
@@ -119,7 +120,8 @@
 template <typename Ring>
 struct point_order<ring_tag, Ring>
 {
- static const order_selector value = geometry::traits::point_order<Ring>::value;
+ static const order_selector value
+ = geometry::traits::point_order<Ring>::value;
 };
 
 // Specialization for polygon: the order is the order of its rings
@@ -138,7 +140,8 @@
 
 
 /*!
-\brief \brief_meta{value, point order (clockwise\, counterclockwise), \meta_geometry_type}
+\brief \brief_meta{value, point order (clockwise\, counterclockwise),
+ \meta_geometry_type}
 \tparam Geometry \tparam_geometry
 \ingroup core
 

Modified: trunk/boost/geometry/core/ring_type.hpp
==============================================================================
--- trunk/boost/geometry/core/ring_type.hpp (original)
+++ trunk/boost/geometry/core/ring_type.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -132,12 +132,15 @@
 
 
 /*!
-\brief Meta-function which defines ring type of (multi)polygon geometry
-\details a polygon contains one exterior ring
+\brief \brief_meta{type, ring_type, \meta_geometry_type}
+\details A polygon contains one exterior ring
     and zero or more interior rings (holes).
- This meta function retrieves the type of the rings
-\note Exterior ring and interior rings must have the same ring-type.
+ This metafunction retrieves the type of the rings.
+ Exterior ring and each of the interior rings all have the same ring_type.
+\tparam Geometry A type fullfilling the Ring, Polygon or MultiPolygon concept.
 \ingroup core
+
+\qbk{[include reference/core/ring_type.qbk]}
 */
 template <typename Geometry>
 struct ring_type

Modified: trunk/boost/geometry/core/tag.hpp
==============================================================================
--- trunk/boost/geometry/core/tag.hpp (original)
+++ trunk/boost/geometry/core/tag.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -49,6 +49,8 @@
 
 /*!
 \brief \brief_meta{type, tag, \meta_geometry_type}
+\details With Boost.Geometry, tags are the driving force of the tag dispatching
+ mechanism. The tag metafunction is therefore used in every free function.
 \tparam Geometry \tparam_geometry
 \ingroup core
 

Added: trunk/boost/geometry/geometries/adapted/boost_polygon.hpp
==============================================================================
--- (empty file)
+++ trunk/boost/geometry/geometries/adapted/boost_polygon.hpp 2011-04-22 18:27:34 EDT (Fri, 22 Apr 2011)
@@ -0,0 +1,18 @@
+// Boost.Geometry (aka GGL, Generic Geometry Library)
+
+// Copyright (c) 2010-2011 Barend Gehrels, 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_GEOMETRIES_ADAPTED_BOOST_POLYGON_HPP
+#define BOOST_GEOMETRY_GEOMETRIES_ADAPTED_BOOST_POLYGON_HPP
+
+#include <boost/geometry/geometries/adapted/boost_polygon/point.hpp>
+#include <boost/geometry/geometries/adapted/boost_polygon/box.hpp>
+#include <boost/geometry/geometries/adapted/boost_polygon/ring.hpp>
+#include <boost/geometry/geometries/adapted/boost_polygon/polygon.hpp>
+
+#endif // BOOST_GEOMETRY_GEOMETRIES_ADAPTED_BOOST_POLYGON_HPP
+


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk