From d04378bc7a11805d9dd1ae0d4910f36ba466ef4c Mon Sep 17 00:00:00 2001 From: Simon Giraudot Date: Thu, 21 Apr 2016 09:57:16 +0200 Subject: [PATCH] Update doc with latest review --- .../Point_set_shape_detection_3.txt | 4 +--- Point_set_shape_detection_3/include/CGAL/regularize_planes.h | 5 +++-- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt b/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt index f59878aa9ab..ab0618f85f3 100644 --- a/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt +++ b/Point_set_shape_detection_3/doc/Point_set_shape_detection_3/Point_set_shape_detection_3.txt @@ -107,9 +107,7 @@ which is used by the example \ref Point_set_shape_detection_3/efficient_RANSAC_ \section Point_set_shape_detection_3Plane_regularization Plane Regularization -Shape detection is very suited for man-made shapes such as urban scenes or scans of mechanical pieces. Such scenes may contain a wide variety of regularities that user may want to favor: parallelism, orthogonality, concentricity, coaxiality, etc., not to mention orbits and composed relationships. - -Among all these possibilities, \cgal provides a means to regularize four properties of regularity through a function `CGAL::regularize_planes()`. It only postprocesses planes detected by `CGAL::Shape_detection_3` (other primitives are left unchanged): +Shape detection applies to man-made scenes or objects such as urban scenes or scans of mechanical parts. Such scenes often contain a wide range of geometric regularities such as parallelism, orthogonality, or symmetry. This package offers a function to reinforce four types of regularities for planar shapes: `CGAL::regularize_planes()`. It only postprocesses planes detected by `CGAL::Shape_detection_3` (other primitives are left unchanged): - Planes that are near __parallel__ are made parallel: normal vectors of planes that form angles smaller than a user-defined threshold are made equal. diff --git a/Point_set_shape_detection_3/include/CGAL/regularize_planes.h b/Point_set_shape_detection_3/include/CGAL/regularize_planes.h index 09b406200e3..78d8f531934 100644 --- a/Point_set_shape_detection_3/include/CGAL/regularize_planes.h +++ b/Point_set_shape_detection_3/include/CGAL/regularize_planes.h @@ -547,8 +547,9 @@ void subgraph_mutually_orthogonal_clusters (PlaneClusterContainer& clusters, \tparam Traits a model of `EfficientRANSACTraits` \param shape_detection Shape detection object used to detect - shapes from the input data. This engine may handle any types of - primitive shapes but only planes will be regularized. + shapes from the input data. While the shape detection algorithm + deals with several types of primitive shapes only planes can be + regularized. \warning The `shape_detection` parameter must have already detected shapes. If no plane exists in it, the regularization