cgal/Surface_mesher/include/CGAL/Complex_2_in_triangulation_3.h

595 lines
16 KiB
C++

// Copyright (c) 2003-2006 INRIA Sophia-Antipolis (France).
// 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) : Steve Oudot, David Rey, Mariette Yvinec, Laurent Rineau, Andreas Fabri
#ifndef CGAL_COMPLEX_2_IN_TRIANGULATION_3_H
#define CGAL_COMPLEX_2_IN_TRIANGULATION_3_H
// TODO: add the iterators
// TODO: document the output/input function of C2T3?
#include <CGAL/circulator.h>
#include <CGAL/iterator.h>
#include <CGAL/Union_find.h>
#include <set>
#include <map>
#include <list>
#include <vector>
namespace CGAL {
template < class Tr >
class Complex_2_in_triangulation_3 {
public:
typedef Complex_2_in_triangulation_3 < Tr > Self;
typedef Tr Triangulation;
typedef typename Triangulation::Vertex_handle Vertex_handle;
typedef typename Triangulation::Cell_handle Cell_handle;
typedef typename Triangulation::Facet Facet;
typedef typename Triangulation::Edge Edge;
typedef std::list<Facet> Facets;
typedef std::list<Cell_handle> Cells;
typedef typename Facets::iterator Facet_list_iterator;
typedef std::size_t size_type;
typedef Const_circulator_from_container<Facets> Facet_circulator;
typedef std::map <std::pair <Vertex_handle, Vertex_handle>,
std::pair<int, std::list<Facet> > >
Edge_facet_counter;
enum Face_status{ NOT_IN_COMPLEX, ISOLATED, BOUNDARY, REGULAR, SINGULAR};
class Not_in_complex {
Self* self;
public:
Not_in_complex(Self* self) : self(self)
{
}
bool operator()(const Facet& f) const {
return self->face_status(f) == NOT_IN_COMPLEX;
}
bool operator()(const Edge& e) const {
return self->face_status(e) == NOT_IN_COMPLEX;
}
bool operator()(Vertex_handle v) const {
return ! self->is_in_complex(v);
}
}; // end struct Not_in_complex
class Not_on_boundary_tester {
Self* self;
public:
Not_on_boundary_tester(Self* self) : self(self)
{
}
bool operator()(const Edge& e) const {
return self->face_status(e)!= BOUNDARY;
}
};
typedef Filter_iterator<typename Triangulation::Finite_facets_iterator,
Not_in_complex> Facet_iterator;
typedef Filter_iterator<typename Triangulation::Finite_edges_iterator,
Not_in_complex> Edge_iterator;
typedef Filter_iterator<typename Triangulation::Finite_vertices_iterator,
Not_in_complex> Vertex_iterator;
typedef Filter_iterator<typename Triangulation::Finite_edges_iterator,
Not_on_boundary_tester> Boundary_edges_iterator;
protected:
Triangulation& tr;
Edge_facet_counter edge_facet_counter;
size_type m_number_of_facets;
private:
// computes and return an ordered pair of Vertex
std::pair<Vertex_handle, Vertex_handle>
make_ordered_pair(const Vertex_handle vh1, const Vertex_handle vh2) const {
if (vh1 < vh2) {
return std::make_pair(vh1, vh2);
}
else {
return std::make_pair(vh2, vh1);
}
}
Facet canonical_facet(Cell_handle c, int i) const {
Cell_handle c2 = c->neighbor(i);
return (c2 < c) ? std::make_pair(c2,c2->index(c)) : std::make_pair(c,i);
}
public:
// Constructors
Complex_2_in_triangulation_3 (Triangulation& t)
: tr(t), m_number_of_facets(0)
{
}
// Access functions
Triangulation& triangulation()
{
return tr;
}
const Triangulation& triangulation() const
{
return tr;
}
Face_status face_status (const Facet& f) const {
return face_status (f.first, f.second);
}
Face_status face_status (const Cell_handle c, const int i) const {
return (c->is_facet_on_surface(i)) ? REGULAR : NOT_IN_COMPLEX;
}
Face_status face_status (const Edge& e) const {
return face_status(e.first->vertex(e.second), e.first->vertex(e.third));
}
Face_status face_status (const Vertex_handle& va,
const Vertex_handle& vb) const
{
typename Edge_facet_counter::const_iterator it =
edge_facet_counter.find(make_ordered_pair(va, vb));
if (it == edge_facet_counter.end())
return NOT_IN_COMPLEX;
switch (it->second.first)
{
case 0 : return ISOLATED;
case 1 : return BOUNDARY;
case 2 : return REGULAR;
default : return SINGULAR;
}
} // end face_status(const Vertex_handle&, const Vertex_handle&)
Face_status face_status (Vertex_handle v)
{
if(v->is_c2t3_cache_valid() && v->cached_number_of_incident_facets() == 0)
return NOT_IN_COMPLEX;
//test incident edges for REUGALIRITY and count BOUNDARY edges
typename std::vector<Vertex_handle> vertices;
vertices.reserve(64);
tr.incident_vertices(v, std::back_inserter(vertices));
int number_of_boundary_incident_edges = 0; //COULD BE a Bool
for (typename std::vector<Vertex_handle>::iterator vit=vertices.begin();
vit != vertices.end();
vit++ )
{
switch( face_status(v, *vit) )
{
case NOT_IN_COMPLEX: case REGULAR: break;
case BOUNDARY: ++number_of_boundary_incident_edges; break;
default : return SINGULAR;
}
}
// from now on incident edges (in complex) are REGULAR or BOUNDARY
int i,j;
union_find_of_incident_facets(v,i,j);
if ( i == 0 )
return NOT_IN_COMPLEX;
else if ( j > 1 )
return SINGULAR;
else // REGULAR OR BOUNDARY
{
if (number_of_boundary_incident_edges != 0)
return BOUNDARY;
else
return REGULAR;
}
} //end of face_status(Vertex_handle)
// This function should be called only when incident edges
// are known to be REGULAR OR BOUNDARY
bool is_regular_or_boundary_for_vertices(Vertex_handle v) {
int i,j;
union_find_of_incident_facets(v,i,j);
return (j == 1);
}
bool is_in_complex (Vertex_handle v) {
int i,j;
union_find_of_incident_facets(v,i,j);
return ( i != 0);
}
// auxiliary function for
// union_find_of_incident_facets(const Vertex_handle v, int&, int&)
void profile_union_find_of_incident_facets_cache_valid()
{
CGAL_PROFILER("number of c2t3 cache success");
}
// extract the subset F of facets of the complex incident to v
// set i to the number of facets in F
// set j to the number of connected component of the adjacency graph
// of F
void union_find_of_incident_facets(const Vertex_handle v, int& i, int& j) {
if( v->is_c2t3_cache_valid() )
{
i = v->cached_number_of_incident_facets();
j = v->cached_number_of_components();
profile_union_find_of_incident_facets_cache_valid();
return;
}
CGAL_PROFILER("number of c2t3 cache failure");
Union_find<Facet> facets;
tr.incident_facets( v,
filter_output_iterator(
std::back_inserter(facets),
Not_in_complex(this)));
typedef std::map<Vertex_handle,
typename Union_find<Facet>::handle> Vertex_Set_map;
typedef typename Vertex_Set_map::iterator Vertex_Set_map_iterator;
Vertex_Set_map vsmap;
for(typename Union_find<Facet>::iterator it = facets.begin();
it != facets.end();
++it){
const Cell_handle& ch = (*it).first;
const int& i = (*it).second;
for(int j=0; j < 3; ++j){
const Vertex_handle w = ch->vertex(tr.vertex_triple_index(i,j));
if(w != v){
Vertex_Set_map_iterator vsm_it = vsmap.find(w);
if(vsm_it != vsmap.end()){
facets.unify_sets(vsm_it->second, it);
} else {
vsmap.insert(std::make_pair(w, it));
}
}
}
}
i = facets.size();
j = facets.number_of_sets();
v->set_c2t3_cache(i, j);
return;
}
bool is_in_complex (const Facet& f) const {
return is_in_complex (f.first, f.second);
}
bool is_in_complex (const Cell_handle c, const int i) const {
return face_status(c,i) != NOT_IN_COMPLEX;
}
bool is_in_complex (const Edge& e) const {
return face_status(e) != NOT_IN_COMPLEX;
}
size_type number_of_facets() const
{
return m_number_of_facets;
}
Facet_circulator incident_facets (const Edge& e) {
typename Edge_facet_counter::iterator it =
edge_facet_counter.find(make_ordered_pair(e.first->vertex(e.second),
e.first->vertex(e.third)));
if( it == edge_facet_counter.end() )
return Facet_circulator();
else
{
// position the circulator on the first element of the facets list
Facets& lof = it->second.second;
return Facet_circulator(&lof);
}
}
// MY TODO : turn this function into an internal function and rename it
// because it is not conform to what the doc says.
// The doc says that incident_facets should return a circulator
template <typename OutputIterator>
OutputIterator incident_facets(const Vertex_handle v, OutputIterator it)
{
// TODO: review this function (Laurent Rineau)
// We assume that for the generated facets the Cell_handle is smaller than the opposite one
tr.incident_facets(v, filter_output_iterator(it, Not_in_complex(this)));
return it;
}
// computes and returns the list of adjacent facets of f
// with the common Vertex_handle v
Facets adjacent_facets (const Facet& f, const Vertex_handle v) {
// TODO: review this function (Laurent Rineau)
Cell_handle c = f.first;
int i = f.second;
int iv = c->index(v);
Edge e[2];
// search for the two other vertices than v in f
int k = 0;
for (int j = 0; j < 4; j++) {
if ( (j != i) && (j != iv) ){
e[k] = make_triple(c, iv, j);
k++;
}
}
Facets& lof1 =
(edge_facet_counter[make_ordered_pair(e[0].first->
vertex(e[0].second),
e[0].first->
vertex(e[0].third))]).second;
Facets& lof2 =
(edge_facet_counter[make_ordered_pair(e[1].first->
vertex(e[1].second),
e[1].first->
vertex(e[1].third))]).second;
Facets lof = typename Facets::list();
for (Facet_list_iterator it = lof1.begin();
it != lof1.end();
it++) {
lof.push_back(*it);
}
for (Facet_list_iterator it = lof2.begin();
it != lof2.end();
it++) {
lof.push_back(*it);
}
assert(!lof.empty());
lof.remove(f);
return lof;
}
// Setting functions
void set_in_complex (const Facet& f) {
set_in_complex (f.first, f.second);
}
void set_in_complex (const Cell_handle c, const int i) {
++m_number_of_facets;
Cell_handle c2 = c->neighbor(i);
int i2 = c2->index(c);
Facet f = canonical_facet(c, i);
// TODO the folowing code should be simplified
// unifying cases dim == 2 ou 3
if (tr.dimension() == 3) {
// if not already in the complex
if ( face_status (c, i) == NOT_IN_COMPLEX ) {
c->set_facet_on_surface(i,true);
c2->set_facet_on_surface(i2,true);
// update c2t3 for edges of f
// We consider only pairs made by vertices without i
for (int j = 0; j < 4; j++) {
for (int k = j + 1; k < 4; k++) {
if ( (i != j) && (i != k) ){
const std::pair<Vertex_handle, Vertex_handle> e =
make_ordered_pair(c->vertex(j),
c->vertex(k));
(edge_facet_counter[e]).first++;
(edge_facet_counter[e]).second.push_back(f); // @TODO: beurk.
// Recode this!
}
}
}
// update c2t3 for vertices of f
for (int j = 0; j < 4; j++) {
if (j != i)
c->vertex(j)->invalidate_c2t3_cache();
}
}
}
else if (tr.dimension() == 2) {
// if not already in the complex
if ( face_status (c, i) == NOT_IN_COMPLEX ) {
c->set_facet_on_surface(i,true);
for (int j = 0; j < 3; j++) {
for (int k = j + 1; k < 3; k++) {
if ( (i != j) && (i != k) ){
const std::pair<Vertex_handle, Vertex_handle> e =
make_ordered_pair(c->vertex(j),
c->vertex(k));
(edge_facet_counter[e]).first++;
(edge_facet_counter[e]).second.push_back(f);
}
}
}
//for each vertex of f
for (int j = 0; j < 3; j++) {
if (j != i)
c->vertex(j)->invalidate_c2t3_cache();
}
}
}
}
void remove_from_complex (const Facet& f) {
remove_from_complex (f.first, f.second);
}
void remove_from_complex (const Cell_handle c, const int i) {
--m_number_of_facets;
Cell_handle c2 = c->neighbor(i);
int i2 = c2->index(c);
Facet f = canonical_facet(c, i);
// TODO the folowing code should be simplified
// unifying cases dim == 2 ou 3
if (tr.dimension() == 3) {
// if in the complex
if ( face_status (c, i) != NOT_IN_COMPLEX ) {
c->set_facet_on_surface(i,false);
c2->set_facet_on_surface(i2,false);
// update the edge counter
for (int j = 0; j < 4; j++) {
for (int k = j + 1; k < 4; k++) {
if ( (i != j) && (i != k) ){
const std::pair<Vertex_handle, Vertex_handle> e =
make_ordered_pair(c->vertex(j),
c->vertex(k));
typename Edge_facet_counter::iterator it =
edge_facet_counter.find(e);
CGAL_assertion( it != edge_facet_counter.end() );
if(--(it->second.first) > 0)
it->second.second.remove(f);
else
edge_facet_counter.erase(it);
}
}
}
// remove f in graph of each of its vertex
for (int j = 0; j < 4; j++) {
if (j != i)
c->vertex(j)->invalidate_c2t3_cache();
}
}
}
else if (tr.dimension() == 2){
// if in the complex
if ( face_status (c, i) != NOT_IN_COMPLEX ) {
c->set_facet_on_surface(i,false);
for (int j = 0; j < 3; j++) {
for (int k = j + 1; k < 3; k++) {
if ( (i != j) && (i != k) ){
const std::pair<Vertex_handle, Vertex_handle> e =
make_ordered_pair(c->vertex(j),
c->vertex(k));
typename Edge_facet_counter::iterator it =
edge_facet_counter.find(e);
CGAL_assertion( it != edge_facet_counter.end() );
if(--(it->second.first) > 0)
it->second.second.remove(f);
else
edge_facet_counter.erase(it);
}
}
}
for (int j = 0; j < 3; j++) {
if (j != i)
c->vertex(j)->invalidate_c2t3_cache();
}
}
}
}
Facet_iterator facets_begin(){
return filter_iterator(tr.finite_facets_begin(),
Not_in_complex(this));
}
Facet_iterator facets_end(){
return filter_iterator(tr.finite_facets_end(),
Not_in_complex(this));
}
Edge_iterator edges_begin(){
return filter_iterator(tr.finite_edges_begin(),
Not_in_complex(this));
}
Edge_iterator edges_end(){
return filter_iterator(tr.finite_edges_end(),
Not_in_complex(this));
}
Vertex_iterator vertices_begin(){
return filter_iterator(tr.finite_vertices_begin(),
Not_in_complex(this));
}
Vertex_iterator vertices_end(){
return filter_iterator(tr.finite_vertices_end(),
Not_in_complex(this));
}
Boundary_edges_iterator boundary_edges_begin() {
return filter_iterator(tr.finite_edges_begin(),
Not_on_boundary_tester(this));
}
Boundary_edges_iterator boundary_edges_end() {
return filter_iterator(tr.finite_edges_end(),
Not_on_boundary_tester(this));
}
}; // end Complex_2_in_triangulation_3
} // end namespace CGAL
#endif // CGAL_COMPLEX_2_IN_TRIANGULATION_3_H