cgal/Operations_on_polyhedra/include/CGAL/orient_polyhedron_3.h

88 lines
2.7 KiB
C++

// Copyright (c) 2013 GeometryFactory (France).
// All rights reserved.
//
// This file is part of CGAL (www.cgal.org).
// You can redistribute it and/or modify it under the terms of the GNU
// General Public License as published by the Free Software Foundation,
// either version 3 of the License, or (at your option) any later version.
//
// 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) : Ilker O. Yaz
#ifndef CGAL_ORIENT_POLYHEDRON_3
#define CGAL_ORIENT_POLYHEDRON_3
#include <algorithm>
#include <CGAL/internal/Operations_on_polyhedra/compute_normal.h>
namespace CGAL{
namespace internal{
template <class Less_xyz>
struct Compare_vertex_points_xyz_3{
Less_xyz less;
typedef bool result_type;
template <class Vertex>
bool operator()(const Vertex& v1, const Vertex& v2) const
{
return less(v1.point(), v2.point());
}
};
} // end of namespace internal
/**
* Tests whether a closed polyhedron has a positive orientation.
* A polyhedron is considered to have positive orientation if the normal vectors
* of the facets point outside of the polyhedron. For each facet, its normal vector
* is considered to point on the side of the facet where the sequence of vertices of
* the facet is seen counterclockwise.
* @pre @a `polyhedron`.is_closed()
* @pre @a `polyhedron` is consistently oriented
*
* @tparam Polyhedron a %CGAL polyhedron
*
* @param polyhedron a closed polyhedron to be tested
*
* \todo The following only handle polyhedron with one connected component
* the code, the sample example and the plugin must be updated.
* @code
* // use inside out to fix orientation
* if(!is_oriented(polyhedron)) {
* polyhedron.inside_out();
* }
* @endcode
*/
template<class Polyhedron>
bool is_oriented(const Polyhedron& polyhedron)
{
typedef typename Polyhedron::Traits K;
internal::Compare_vertex_points_xyz_3< typename K::Less_xyz_3 > less_xyz;
typename Polyhedron::Vertex_const_iterator v_min
= std::min_element(polyhedron.vertices_begin(), polyhedron.vertices_end(), less_xyz);
const typename K::Vector_3& normal_v_min = compute_vertex_normal<typename Polyhedron::Vertex, K>(*v_min);
return normal_v_min[0] < 0 || (
normal_v_min[0] == 0 && (
normal_v_min[1] < 0 ||
( normal_v_min[1]==0 && normal_v_min[2] < 0 )
)
);
}
} // namespace CGAL
#endif // CGAL_ORIENT_POLYHEDRON_3