Merging r43721 through r43847 from trunk into soc-2011-tomato
[blender.git] / extern / carve / lib / intersect_face_division.cpp
1 // Begin License:
2 // Copyright (C) 2006-2011 Tobias Sargeant (tobias.sargeant@gmail.com).
3 // All rights reserved.
4 //
5 // This file is part of the Carve CSG Library (http://carve-csg.com/)
6 //
7 // This file may be used under the terms of the GNU General Public
8 // License version 2.0 as published by the Free Software Foundation
9 // and appearing in the file LICENSE.GPL2 included in the packaging of
10 // this file.
11 //
12 // This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
13 // INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
14 // A PARTICULAR PURPOSE.
15 // End:
16
17
18 #if defined(HAVE_CONFIG_H)
19 #  include <carve_config.h>
20 #endif
21
22 #include <carve/csg.hpp>
23 #include <carve/polyline.hpp>
24 #include <carve/debug_hooks.hpp>
25 #include <carve/timing.hpp>
26 #include <carve/triangulator.hpp>
27
28 #include <list>
29 #include <set>
30 #include <iostream>
31
32 #include <algorithm>
33
34 #include "csg_detail.hpp"
35 #include "csg_data.hpp"
36
37 #include "intersect_common.hpp"
38
39
40
41 #if defined(CARVE_DEBUG_WRITE_PLY_DATA)
42 void writePLY(const std::string &out_file, const carve::line::PolylineSet *lines, bool ascii);
43 #endif
44
45
46
47 namespace {
48
49
50
51 #if defined(CARVE_DEBUG_WRITE_PLY_DATA)
52   template<typename iter_t>
53   void dumpFacesAndHoles(iter_t f_begin, iter_t f_end,
54                          iter_t h_begin, iter_t h_end,
55                          const std::string &fname) {
56     std::cerr << "dumping " << std::distance(f_begin, f_end) << " faces, " << std::distance(h_begin, h_end) << " holes." << std::endl;
57     std::map<carve::mesh::MeshSet<3>::vertex_t *, size_t> v_included;
58
59     for (iter_t i = f_begin; i != f_end; ++i) {
60       for (size_t j = 0; j < (*i).size(); ++j) {
61         if (v_included.find((*i)[j]) == v_included.end()) {
62           size_t &p = v_included[(*i)[j]];
63           p = v_included.size() - 1;
64         }
65       }
66     }
67
68     for (iter_t i = h_begin; i != h_end; ++i) {
69       for (size_t j = 0; j < (*i).size(); ++j) {
70         if (v_included.find((*i)[j]) == v_included.end()) {
71           size_t &p = v_included[(*i)[j]];
72           p = v_included.size() - 1;
73         }
74       }
75     }
76
77     carve::line::PolylineSet fh;
78     fh.vertices.resize(v_included.size());
79     for (std::map<carve::mesh::MeshSet<3>::vertex_t *, size_t>::const_iterator
80            i = v_included.begin(); i != v_included.end(); ++i) {
81       fh.vertices[(*i).second].v = (*i).first->v;
82     }
83
84     {
85       std::vector<size_t> connected;
86       for (iter_t i = f_begin; i != f_end; ++i) {
87         connected.clear();
88         for (size_t j = 0; j < (*i).size(); ++j) {
89           connected.push_back(v_included[(*i)[j]]);
90         }
91         fh.addPolyline(true, connected.begin(), connected.end());
92       }
93       for (iter_t i = h_begin; i != h_end; ++i) {
94         connected.clear();
95         for (size_t j = 0; j < (*i).size(); ++j) {
96           connected.push_back(v_included[(*i)[j]]);
97         }
98         fh.addPolyline(true, connected.begin(), connected.end());
99       }
100     }
101
102     ::writePLY(fname, &fh, true);
103   }
104 #endif
105
106
107
108   template<typename T>
109   void populateVectorFromList(std::list<T> &l, std::vector<T> &v) {
110     v.clear();
111     v.reserve(l.size());
112     for (typename std::list<T>::iterator i = l.begin(); i != l.end(); ++i) {
113       v.push_back(T());
114       std::swap(*i, v.back());
115     }
116     l.clear();
117   }
118
119   template<typename T>
120   void populateListFromVector(std::vector<T> &v, std::list<T> &l) {
121     l.clear();
122     for (size_t i = 0; i < v.size(); ++i) {
123       l.push_back(T());
124       std::swap(v[i], l.back());
125     }
126     v.clear();
127   }
128
129
130
131   struct GraphEdge {
132     GraphEdge *next;
133     GraphEdge *prev;
134     GraphEdge *loop_next;
135     carve::mesh::MeshSet<3>::vertex_t *src;
136     carve::mesh::MeshSet<3>::vertex_t *tgt;
137     double ang;
138     int visited;
139
140     GraphEdge(carve::mesh::MeshSet<3>::vertex_t *_src, carve::mesh::MeshSet<3>::vertex_t *_tgt) :
141       next(NULL), prev(NULL), loop_next(NULL),
142       src(_src), tgt(_tgt),
143       ang(0.0), visited(-1) {
144     }
145   };
146
147
148
149   struct GraphEdges {
150     GraphEdge *edges;
151     carve::geom2d::P2 proj;
152
153     GraphEdges() : edges(NULL), proj() {
154     }
155   };
156
157
158
159   struct Graph {
160     typedef std::unordered_map<carve::mesh::MeshSet<3>::vertex_t *, GraphEdges> graph_t;
161
162     graph_t graph;
163
164     Graph() : graph() {
165     }
166
167     ~Graph() {
168       int c = 0;
169
170       GraphEdge *edge;
171       for (graph_t::iterator i = graph.begin(), e =  graph.end(); i != e; ++i) {
172         edge = (*i).second.edges;
173         while (edge) {
174           GraphEdge *temp = edge;
175           ++c;
176           edge = edge->next;
177           delete temp;
178         }
179       }
180
181       if (c) {
182         std::cerr << "warning: "
183                   << c
184                   << " edges should have already been removed at graph destruction time"
185                   << std::endl;
186       }
187     }
188
189     const carve::geom2d::P2 &projection(carve::mesh::MeshSet<3>::vertex_t *v) const {
190       graph_t::const_iterator i = graph.find(v);
191       CARVE_ASSERT(i != graph.end());
192       return (*i).second.proj;
193     }
194
195     void computeProjection(carve::mesh::MeshSet<3>::face_t *face) {
196       for (graph_t::iterator i = graph.begin(), e =  graph.end(); i != e; ++i) {
197         (*i).second.proj = face->project((*i).first->v);
198       }
199       for (graph_t::iterator i = graph.begin(), e =  graph.end(); i != e; ++i) {
200         for (GraphEdge *e = (*i).second.edges; e; e = e->next) {
201           e->ang = carve::math::ANG(carve::geom2d::atan2(projection(e->tgt) - projection(e->src)));
202         }
203       }
204     }
205
206     void print(std::ostream &out, const carve::csg::VertexIntersections *vi) const {
207       for (graph_t::const_iterator i = graph.begin(), e =  graph.end(); i != e; ++i) {
208         out << (*i).first << (*i).first->v << '(' << projection((*i).first).x << ',' << projection((*i).first).y << ") :";
209         for (const GraphEdge *e = (*i).second.edges; e; e = e->next) {
210           out << ' ' << e->tgt << e->tgt->v << '(' << projection(e->tgt).x << ',' << projection(e->tgt).y << ')';
211         }
212         out << std::endl;
213         if (vi) {
214           carve::csg::VertexIntersections::const_iterator j = vi->find((*i).first);
215           if (j != vi->end()) {
216             out << "   (int) ";
217             for (carve::csg::IObjPairSet::const_iterator
218                    k = (*j).second.begin(), ke = (*j).second.end(); k != ke; ++k) {
219               if ((*k).first < (*k).second) {
220                 out << (*k).first << ".." << (*k).second << "; ";
221               }
222             }
223             out << std::endl;
224           }
225         }
226       }
227     }
228
229     void addEdge(carve::mesh::MeshSet<3>::vertex_t *v1, carve::mesh::MeshSet<3>::vertex_t *v2) {
230       GraphEdges &edges = graph[v1];
231       GraphEdge *edge = new GraphEdge(v1, v2);
232       if (edges.edges) edges.edges->prev = edge;
233       edge->next = edges.edges;
234       edges.edges = edge;
235     }
236
237     void removeEdge(GraphEdge *edge) {
238       if (edge->prev != NULL) {
239         edge->prev->next = edge->next;
240       } else {
241         if (edge->next != NULL) {
242           GraphEdges &edges = (graph[edge->src]);
243           edges.edges = edge->next;
244         } else {
245           graph.erase(edge->src);
246         }
247       }
248       if (edge->next != NULL) {
249         edge->next->prev = edge->prev;
250       }
251       delete edge;
252     }
253
254     bool empty() const {
255       return graph.size() == 0;
256     }
257
258     GraphEdge *pickStartEdge() {
259       // Try and find a vertex from which there is only one outbound edge. Won't always succeed.
260       for (graph_t::iterator i = graph.begin(); i != graph.end(); ++i) {
261         GraphEdges &ge = i->second;
262         if (ge.edges->next == NULL) {
263           return ge.edges;
264         }
265       }
266       return (*graph.begin()).second.edges;
267     }
268
269     GraphEdge *outboundEdges(carve::mesh::MeshSet<3>::vertex_t *v) {
270       return graph[v].edges;
271     }
272   };
273
274
275
276   /** 
277    * \brief Take a set of new edges and split a face based upon those edges.
278    * 
279    * @param[in] face The face to be split.
280    * @param[in] edges 
281    * @param[out] face_loops Output list of face loops
282    * @param[out] hole_loops Output list of hole loops
283    * @param vi 
284    */
285   static void splitFace(carve::mesh::MeshSet<3>::face_t *face,
286                         const carve::csg::V2Set &edges,
287                         std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &face_loops,
288                         std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &hole_loops,
289                         const carve::csg::VertexIntersections & /* vi */) {
290     Graph graph;
291
292     for (carve::csg::V2Set::const_iterator
293            i = edges.begin(), e = edges.end();
294          i != e;
295          ++i) {
296       carve::mesh::MeshSet<3>::vertex_t *v1 = ((*i).first), *v2 = ((*i).second);
297       if (carve::geom::equal(v1->v, v2->v)) std::cerr << "WARNING! " << v1->v << "==" << v2->v << std::endl;
298       graph.addEdge(v1, v2);
299     }
300
301     graph.computeProjection(face);
302
303     while (!graph.empty()) {
304       GraphEdge *edge;
305       GraphEdge *start;
306       start = edge = graph.pickStartEdge();
307
308       edge->visited = 0;
309
310       int len = 0;
311
312       for (;;) {
313         double in_ang = M_PI + edge->ang;
314         if (in_ang > M_TWOPI) in_ang -= M_TWOPI;
315
316         GraphEdge *opts;
317         GraphEdge *out = NULL;
318         double best = M_TWOPI + 1.0;
319
320         for (opts = graph.outboundEdges(edge->tgt); opts; opts = opts->next) {
321           if (opts->tgt == edge->src) {
322             if (out == NULL && opts->next == NULL) out = opts;
323           } else {
324             double out_ang = carve::math::ANG(in_ang - opts->ang);
325
326             if (out == NULL || out_ang < best) {
327               out = opts;
328               best = out_ang;
329             }
330           }
331         }
332
333         CARVE_ASSERT(out != NULL);
334
335         edge->loop_next = out;
336
337         if (out->visited >= 0) {
338           while (start != out) {
339             GraphEdge *e = start;
340             start = start->loop_next;
341             e->loop_next = NULL;
342             e->visited = -1;
343           }
344           len = edge->visited - out->visited + 1;
345           break;
346         }
347
348         out->visited = edge->visited + 1;
349         edge = out;
350       }
351
352       std::vector<carve::mesh::MeshSet<3>::vertex_t *> loop(len);
353       std::vector<carve::geom2d::P2> projected(len);
354
355       edge = start;
356       for (int i = 0; i < len; ++i) {
357         GraphEdge *next = edge->loop_next;
358         loop[i] = edge->src;
359         projected[i] = graph.projection(edge->src);
360         graph.removeEdge(edge);
361         edge = next;
362       }
363
364       CARVE_ASSERT(edge == start);
365
366       if (carve::geom2d::signedArea(projected) < 0) {
367         face_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
368         face_loops.back().swap(loop);
369       } else {
370         hole_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
371         hole_loops.back().swap(loop);
372       }
373     }
374   }
375
376
377
378   /** 
379    * \brief Determine the relationship between a face loop and a hole loop.
380    * 
381    * Determine whether a face and hole share an edge, or a vertex,
382    * or do not touch. Find a hole vertex that is not part of the
383    * face, and a hole,face vertex pair that are coincident, if such
384    * a pair exists.
385    *
386    * @param[in] f A face loop.
387    * @param[in] f_sort A vector indexing \a f in address order
388    * @param[in] h A hole loop.
389    * @param[in] h_sort A vector indexing \a h in address order
390    * @param[out] f_idx Index of a face vertex that is shared with the hole.
391    * @param[out] h_idx Index of the hole vertex corresponding to \a f_idx.
392    * @param[out] unmatched_h_idx Index of a hole vertex that is not part of the face.
393    * @param[out] shares_vertex Boolean indicating that the face and the hole share a vertex.
394    * @param[out] shares_edge Boolean indicating that the face and the hole share an edge.
395    */
396   static void compareFaceLoopAndHoleLoop(const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &f,
397                                          const std::vector<unsigned> &f_sort,
398                                          const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &h,
399                                          const std::vector<unsigned> &h_sort,
400                                          unsigned &f_idx,
401                                          unsigned &h_idx,
402                                          int &unmatched_h_idx,
403                                          bool &shares_vertex,
404                                          bool &shares_edge) {
405     const size_t F = f.size();
406     const size_t H = h.size();
407
408     shares_vertex = shares_edge = false;
409     unmatched_h_idx = -1;
410
411     unsigned I, J;
412     for (I = J = 0; I < F && J < H;) {
413       unsigned i = f_sort[I], j = h_sort[J];
414       if (f[i] == h[j]) {
415         shares_vertex = true;
416         f_idx = i;
417         h_idx = j;
418         if (f[(i + F - 1) % F] == h[(j + 1) % H]) {
419           shares_edge = true;
420         }
421         carve::mesh::MeshSet<3>::vertex_t *t = f[i];
422         do { ++I; } while (I < F && f[f_sort[I]] == t);
423         do { ++J; } while (J < H && h[h_sort[J]] == t);
424       } else if (f[i] < h[j]) {
425         ++I;
426       } else {
427         unmatched_h_idx = j;
428         ++J;
429       }
430     }
431     if (J < H) {
432       unmatched_h_idx = h_sort[J];
433     }
434   }
435
436
437
438   /** 
439    * \brief Compute an embedding for a set of face loops and hole loops.
440    *
441    * Because face and hole loops may be contained within each other,
442    * it must be determined which hole loops are directly contained
443    * within a face loop.
444    * 
445    * @param[in] face The face from which these face and hole loops derive.
446    * @param[in] face_loops 
447    * @param[in] hole_loops 
448    * @param[out] containing_faces     A vector which for each hole loop
449    *                                  lists the indices of the face
450    *                                  loops it is containined in.
451    * @param[out] hole_shared_vertices A map from a face,hole pair to
452    *                                  a shared vertex pair.
453    */
454   static void computeContainment(carve::mesh::MeshSet<3>::face_t *face,
455                                  std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &face_loops,
456                                  std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &hole_loops,
457                                  std::vector<std::vector<int> > &containing_faces,
458                                  std::map<int, std::map<int, std::pair<unsigned, unsigned> > > &hole_shared_vertices) {
459 #if defined(CARVE_DEBUG)
460     std::cerr << "input: "
461               << face_loops.size() << "faces, "
462               << hole_loops.size() << "holes."
463               << std::endl;
464 #endif
465
466     std::vector<std::vector<carve::geom2d::P2> > face_loops_projected, hole_loops_projected;
467     std::vector<carve::geom::aabb<2> > face_loop_aabb, hole_loop_aabb;
468     std::vector<std::vector<unsigned> > face_loops_sorted, hole_loops_sorted;
469
470     std::vector<double> face_loop_areas, hole_loop_areas;
471
472     face_loops_projected.resize(face_loops.size());
473     face_loops_sorted.resize(face_loops.size());
474     face_loop_aabb.resize(face_loops.size());
475     face_loop_areas.resize(face_loops.size());
476
477     hole_loops_projected.resize(hole_loops.size());
478     hole_loops_sorted.resize(hole_loops.size());
479     hole_loop_aabb.resize(hole_loops.size());
480     hole_loop_areas.resize(hole_loops.size());
481
482     // produce a projection of each face loop onto a 2D plane, and an
483     // index vector which sorts vertices by address.
484     for (size_t m = 0; m < face_loops.size(); ++m) {
485       const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &f_loop = (face_loops[m]);
486       face_loops_projected[m].reserve(f_loop.size());
487       face_loops_sorted[m].reserve(f_loop.size());
488       for (size_t n = 0; n < f_loop.size(); ++n) {
489         face_loops_projected[m].push_back(face->project(f_loop[n]->v));
490         face_loops_sorted[m].push_back(n);
491       }
492       face_loop_areas.push_back(carve::geom2d::signedArea(face_loops_projected[m]));
493
494       std::sort(face_loops_sorted[m].begin(), face_loops_sorted[m].end(), 
495                 carve::make_index_sort(face_loops[m].begin()));
496       face_loop_aabb[m].fit(face_loops_projected[m].begin(), face_loops_projected[m].end());
497     }
498
499     // produce a projection of each hole loop onto a 2D plane, and an
500     // index vector which sorts vertices by address.
501     for (size_t m = 0; m < hole_loops.size(); ++m) {
502       const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &h_loop = (hole_loops[m]);
503       hole_loops_projected[m].reserve(h_loop.size());
504       hole_loops_projected[m].reserve(h_loop.size());
505       for (size_t n = 0; n < h_loop.size(); ++n) {
506         hole_loops_projected[m].push_back(face->project(h_loop[n]->v));
507         hole_loops_sorted[m].push_back(n);
508       }
509       hole_loop_areas.push_back(carve::geom2d::signedArea(hole_loops_projected[m]));
510
511       std::sort(hole_loops_sorted[m].begin(), hole_loops_sorted[m].end(), 
512                 carve::make_index_sort(hole_loops[m].begin()));
513       hole_loop_aabb[m].fit(hole_loops_projected[m].begin(), hole_loops_projected[m].end());
514     }
515
516     containing_faces.resize(hole_loops.size());
517
518     for (unsigned i = 0; i < hole_loops.size(); ++i) {
519
520       for (unsigned j = 0; j < face_loops.size(); ++j) {
521         if (!face_loop_aabb[j].completelyContains(hole_loop_aabb[i])) {
522 #if defined(CARVE_DEBUG)
523           std::cerr << "face: " << j
524                     << " hole: " << i
525                     << " skipped test (aabb fail)"
526                     << std::endl;
527 #endif
528           continue;
529         }
530
531         unsigned f_idx, h_idx;
532         int unmatched_h_idx;
533         bool shares_vertex, shares_edge;
534         compareFaceLoopAndHoleLoop(face_loops[j],
535                                    face_loops_sorted[j],
536                                    hole_loops[i],
537                                    hole_loops_sorted[i],
538                                    f_idx, h_idx,
539                                    unmatched_h_idx,
540                                    shares_vertex,
541                                    shares_edge);
542
543 #if defined(CARVE_DEBUG)
544         std::cerr << "face: " << j
545                   << " hole: " << i
546                   << " shares_vertex: " << shares_vertex
547                   << " shares_edge: " << shares_edge
548                   << std::endl;
549 #endif
550
551         carve::geom3d::Vector test = hole_loops[i][0]->v;
552         carve::geom2d::P2 test_p = face->project(test);
553
554         if (shares_vertex) {
555           hole_shared_vertices[i][j] = std::make_pair(h_idx, f_idx);
556           // Hole touches face. Should be able to connect it up
557           // trivially. Still need to record its containment, so that
558           // the assignment below works.
559           if (unmatched_h_idx != -1) {
560 #if defined(CARVE_DEBUG)
561             std::cerr << "using unmatched vertex: " << unmatched_h_idx << std::endl;
562 #endif
563             test = hole_loops[i][unmatched_h_idx]->v;
564             test_p = face->project(test);
565           } else {
566             // XXX: hole shares ALL vertices with face. Pick a point
567             // internal to the projected poly.
568             if (shares_edge) {
569               // Hole shares edge with face => face can't contain hole.
570               continue;
571             }
572
573             // XXX: how is this possible? Doesn't share an edge, but
574             // also doesn't have any vertices that are not in
575             // common. Degenerate hole?
576
577             // XXX: come up with a test case for this.
578             CARVE_FAIL("implement me");
579           }
580         }
581
582
583         // XXX: use loop area to avoid some point-in-poly tests? Loop
584         // area is faster, but not sure which is more robust.
585         if (carve::geom2d::pointInPolySimple(face_loops_projected[j], test_p)) {
586 #if defined(CARVE_DEBUG)
587           std::cerr << "contains: " << i << " - " << j << std::endl;
588 #endif
589           containing_faces[i].push_back(j);
590         } else {
591 #if defined(CARVE_DEBUG)
592           std::cerr << "does not contain: " << i << " - " << j << std::endl;
593 #endif
594         }
595       }
596
597 #if defined(CARVE_DEBUG)
598       if (containing_faces[i].size() == 0) {
599         //HOOK(drawFaceLoopWireframe(hole_loops[i], face->normal, 1.0, 0.0, 0.0, 1.0););
600         std::cerr << "hole loop: ";
601         for (unsigned j = 0; j < hole_loops[i].size(); ++j) {
602           std::cerr << " " << hole_loops[i][j] << ":" << hole_loops[i][j]->v;
603         }
604         std::cerr << std::endl;
605         for (unsigned j = 0; j < face_loops.size(); ++j) {
606           //HOOK(drawFaceLoopWireframe(face_loops[j], face->normal, 0.0, 1.0, 0.0, 1.0););
607         }
608       }
609 #endif
610
611       // CARVE_ASSERT(containing_faces[i].size() >= 1);
612     }
613   }
614
615
616
617   /** 
618    * \brief Merge face loops and hole loops to produce a set of face loops without holes.
619    * 
620    * @param[in] face The face from which these face loops derive.
621    * @param[in,out] f_loops A list of face loops.
622    * @param[in] h_loops A list of hole loops to be incorporated into face loops.
623    */
624   static void mergeFacesAndHoles(carve::mesh::MeshSet<3>::face_t *face,
625                                  std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &f_loops,
626                                  std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &h_loops,
627                                  carve::csg::CSG::Hooks & /* hooks */) {
628     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > face_loops;
629     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > hole_loops;
630
631     std::vector<std::vector<int> > containing_faces;
632     std::map<int, std::map<int, std::pair<unsigned, unsigned> > > hole_shared_vertices;
633
634 #if defined(CARVE_DEBUG_WRITE_PLY_DATA)
635     dumpFacesAndHoles(f_loops.begin(), f_loops.end(), h_loops.begin(), h_loops.end(), "/tmp/pre_merge.ply");
636 #endif
637
638     {
639       // move input face and hole loops to temp vectors.
640       size_t m;
641       face_loops.resize(f_loops.size());
642       m = 0;
643       for (std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> >::iterator
644              i = f_loops.begin(), ie = f_loops.end();
645            i != ie;
646            ++i, ++m) {
647         face_loops[m].swap((*i));
648       }
649
650       hole_loops.resize(h_loops.size());
651       m = 0;
652       for (std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> >::iterator
653              i = h_loops.begin(), ie = h_loops.end();
654            i != ie;
655            ++i, ++m) {
656         hole_loops[m].swap((*i));
657       }
658       f_loops.clear();
659       h_loops.clear();
660     }
661
662     // work out the embedding of holes and faces.
663     computeContainment(face, face_loops, hole_loops, containing_faces, hole_shared_vertices);
664
665     int unassigned = (int)hole_loops.size();
666
667     std::vector<std::vector<int> > face_holes;
668     face_holes.resize(face_loops.size());
669
670     for (unsigned i = 0; i < containing_faces.size(); ++i) {
671       if (containing_faces[i].size() == 0) {
672         std::map<int, std::map<int, std::pair<unsigned, unsigned> > >::iterator it = hole_shared_vertices.find(i);
673         if (it != hole_shared_vertices.end()) {
674           std::map<int, std::pair<unsigned, unsigned> >::iterator it2 = (*it).second.begin();
675           int f = (*it2).first;
676           unsigned h_idx = (*it2).second.first;
677           unsigned f_idx = (*it2).second.second;
678
679           // patch the hole into the face directly. because
680           // f_loop[f_idx] == h_loop[h_idx], we don't need to
681           // duplicate the f_loop vertex.
682
683           std::vector<carve::mesh::MeshSet<3>::vertex_t *> &f_loop = face_loops[f];
684           std::vector<carve::mesh::MeshSet<3>::vertex_t *> &h_loop = hole_loops[i];
685
686           f_loop.insert(f_loop.begin() + f_idx + 1, h_loop.size(), NULL);
687
688           unsigned p = f_idx + 1;
689           for (unsigned a = h_idx + 1; a < h_loop.size(); ++a, ++p) {
690             f_loop[p] = h_loop[a];
691           }
692           for (unsigned a = 0; a <= h_idx; ++a, ++p) {
693             f_loop[p] = h_loop[a];
694           }
695
696 #if defined(CARVE_DEBUG)
697           std::cerr << "hook face " << f << " to hole " << i << "(vertex)" << std::endl;
698 #endif
699         } else {
700           std::cerr << "uncontained hole loop does not share vertices with any face loop!" << std::endl;
701         }
702         unassigned--;
703       }
704     }
705
706
707     // work out which holes are directly contained within which faces.
708     while (unassigned) {
709       std::set<int> removed;
710
711       for (unsigned i = 0; i < containing_faces.size(); ++i) {
712         if (containing_faces[i].size() == 1) {
713           int f = containing_faces[i][0];
714           face_holes[f].push_back(i);
715 #if defined(CARVE_DEBUG)
716           std::cerr << "hook face " << f << " to hole " << i << std::endl;
717 #endif
718           removed.insert(f);
719           unassigned--;
720         }
721       }
722       for (std::set<int>::iterator f = removed.begin(); f != removed.end(); ++f) {
723         for (unsigned i = 0; i < containing_faces.size(); ++i) {
724           containing_faces[i].erase(std::remove(containing_faces[i].begin(),
725                                                 containing_faces[i].end(),
726                                                 *f),
727                                     containing_faces[i].end());
728         }
729       }
730     }
731
732 #if 0
733     // use old templated projection code to patch holes into faces.
734     for (unsigned i = 0; i < face_loops.size(); ++i) {
735       std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > face_hole_loops;
736       face_hole_loops.resize(face_holes[i].size());
737       for (unsigned j = 0; j < face_holes[i].size(); ++j) {
738         face_hole_loops[j].swap(hole_loops[face_holes[i][j]]);
739       }
740       if (face_hole_loops.size()) {
741
742         f_loops.push_back(carve::triangulate::incorporateHolesIntoPolygon(
743           carve::mesh::MeshSet<3>::face_t::projection_mapping(face->project),
744           face_loops[i],
745           face_hole_loops));
746       } else {
747         f_loops.push_back(face_loops[i]);
748       }
749     }
750
751 #else
752     // use new 2d-only hole patching code.
753     for (size_t i = 0; i < face_loops.size(); ++i) {
754       if (!face_holes[i].size()) {
755         f_loops.push_back(face_loops[i]);
756         continue;
757       }
758
759       std::vector<std::vector<carve::geom2d::P2> > projected_poly;
760       projected_poly.resize(face_holes[i].size() + 1);
761       projected_poly[0].reserve(face_loops[i].size());
762       for (size_t j = 0; j < face_loops[i].size(); ++j) {
763         projected_poly[0].push_back(face->project(face_loops[i][j]->v));
764       }
765       for (size_t j = 0; j < face_holes[i].size(); ++j) {
766         projected_poly[j+1].reserve(hole_loops[face_holes[i][j]].size());
767         for (size_t k = 0; k < hole_loops[face_holes[i][j]].size(); ++k) {
768           projected_poly[j+1].push_back(face->project(hole_loops[face_holes[i][j]][k]->v));
769         }
770       }
771
772       std::vector<std::pair<size_t, size_t> > result = carve::triangulate::incorporateHolesIntoPolygon(projected_poly);
773
774       f_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
775       std::vector<carve::mesh::MeshSet<3>::vertex_t *> &out = f_loops.back();
776       out.reserve(result.size());
777       for (size_t j = 0; j < result.size(); ++j) {
778         if (result[j].first == 0) {
779           out.push_back(face_loops[i][result[j].second]);
780         } else {
781           out.push_back(hole_loops[face_holes[i][result[j].first-1]][result[j].second]);
782         }
783       }
784     }
785 #endif
786 #if defined(CARVE_DEBUG_WRITE_PLY_DATA)
787     dumpFacesAndHoles(f_loops.begin(), f_loops.end(), h_loops.begin(), h_loops.end(), "/tmp/post_merge.ply");
788 #endif
789
790   }
791
792
793
794   /** 
795    * \brief Assemble the base loop for a face.
796    *
797    * The base loop is the original face loop, including vertices
798    * created by intersections crossing any of its edges.
799    * 
800    * @param[in] face The face to process.
801    * @param[in] vmap 
802    * @param[in] face_split_edges 
803    * @param[in] divided_edges A mapping from edge pointer to sets of
804    *            ordered vertices corrsponding to the intersection points
805    *            on that edge.
806    * @param[out] base_loop A vector of the vertices of the base loop.
807    */
808   static bool assembleBaseLoop(carve::mesh::MeshSet<3>::face_t *face,
809                                const carve::csg::detail::Data &data,
810                                std::vector<carve::mesh::MeshSet<3>::vertex_t *> &base_loop) {
811     base_loop.clear();
812
813     // XXX: assumes that face->edges is in the same order as
814     // face->vertices. (Which it is)
815     carve::mesh::MeshSet<3>::edge_t *e = face->edge;
816     bool face_edge_intersected = false;
817     do {
818       base_loop.push_back(carve::csg::map_vertex(data.vmap, e->vert));
819
820       carve::csg::detail::EVVMap::const_iterator ev = data.divided_edges.find(e);
821
822       if (ev != data.divided_edges.end()) {
823         const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &ev_vec = ((*ev).second);
824
825         for (size_t k = 0, ke = ev_vec.size(); k < ke;) {
826           base_loop.push_back(ev_vec[k++]);
827         }
828
829         face_edge_intersected = true;
830       }
831       e = e->next;
832     } while (e != face->edge);
833
834     return face_edge_intersected;
835   }
836
837
838
839   // the crossing_data structure holds temporary information regarding
840   // paths, and their relationship to the loop of edges that forms the
841   // face perimeter.
842   struct crossing_data {
843     std::vector<carve::mesh::MeshSet<3>::vertex_t *> *path;
844     size_t edge_idx[2];
845
846     crossing_data(std::vector<carve::mesh::MeshSet<3>::vertex_t *> *p, size_t e1, size_t e2) : path(p) {
847       edge_idx[0] = e1; edge_idx[1] = e2;
848     }
849
850     bool operator<(const crossing_data &c) const {
851       // the sort order for paths is in order of increasing initial
852       // position on the edge loop, but decreasing final position.
853       return edge_idx[0] < c.edge_idx[0] || (edge_idx[0] == c.edge_idx[0] && edge_idx[1] > c.edge_idx[1]);
854     }
855   };
856
857
858
859   bool processCrossingEdges(carve::mesh::MeshSet<3>::face_t *face,
860                             const carve::csg::VertexIntersections &vertex_intersections,
861                             carve::csg::CSG::Hooks &hooks,
862                             std::vector<carve::mesh::MeshSet<3>::vertex_t *> &base_loop,
863                             std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &paths,
864                             std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &face_loops_out) {
865     const size_t N = base_loop.size();
866     std::vector<crossing_data> endpoint_indices;
867
868     endpoint_indices.reserve(paths.size());
869
870     for (size_t i = 0; i < paths.size(); ++i) {
871       endpoint_indices.push_back(crossing_data(&paths[i], N, N));
872     }
873
874     // Step 1:
875     // locate endpoints of paths on the base loop.
876     for (size_t i = 0; i < N; ++i) {
877       for (size_t j = 0; j < paths.size(); ++j) {
878         // test beginning of path.
879         if (paths[j].front() == base_loop[i]) {
880           if (endpoint_indices[j].edge_idx[0] == N) {
881             endpoint_indices[j].edge_idx[0] = i;
882           } else {
883             // there is a duplicated vertex in the face perimeter. The
884             // path might attach to either of the duplicate instances
885             // so we have to work out which is the right one to attach
886             // to. We assume it's the index currently being examined,
887             // if the path heads in a direction that's internal to the
888             // angle made by the prior and next edges of the face
889             // perimeter. Otherwise, leave it as the currently
890             // selected index (until another duplicate is found, if it
891             // exists, and is tested).
892             const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &p = *endpoint_indices[j].path;
893             const size_t pN = p.size();
894
895             carve::mesh::MeshSet<3>::vertex_t *a, *b, *c;
896             a = base_loop[(i+N-1)%N];
897             b = base_loop[i];
898             c = base_loop[(i+1)%N];
899
900             carve::mesh::MeshSet<3>::vertex_t *adj = (p[0] == base_loop[i]) ? p[1] : p[pN-2];
901
902             if (carve::geom2d::internalToAngle(face->project(c->v),
903                                                face->project(b->v),
904                                                face->project(a->v),
905                                                face->project(adj->v))) {
906               endpoint_indices[j].edge_idx[0] = i;
907             }
908           }
909         }
910
911         // test end of path.
912         if (paths[j].back() == base_loop[i]) {
913           if (endpoint_indices[j].edge_idx[1] == N) {
914             endpoint_indices[j].edge_idx[1] = i;
915           } else {
916             // Work out which of the duplicated vertices is the right
917             // one to attach to, as above.
918             const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &p = *endpoint_indices[j].path;
919             const size_t pN = p.size();
920
921             carve::mesh::MeshSet<3>::vertex_t *a, *b, *c;
922             a = base_loop[(i+N-1)%N];
923             b = base_loop[i];
924             c = base_loop[(i+1)%N];
925
926             carve::mesh::MeshSet<3>::vertex_t *adj = (p[0] == base_loop[i]) ? p[1] : p[pN-2];
927
928             if (carve::geom2d::internalToAngle(face->project(c->v),
929                                                face->project(b->v),
930                                                face->project(a->v),
931                                                face->project(adj->v))) {
932               endpoint_indices[j].edge_idx[1] = i;
933             }
934           }
935         }
936       }
937     }
938
939 #if defined(CARVE_DEBUG)
940     std::cerr << "### N: " << N << std::endl;
941     for (size_t i = 0; i < paths.size(); ++i) {
942       std::cerr << "### path: " << i << " endpoints: " << endpoint_indices[i].edge_idx[0] << " - " << endpoint_indices[i].edge_idx[1] << std::endl;
943     }
944 #endif
945
946
947     // Step 2:
948     // divide paths up into those that connect to the base loop in two
949     // places (cross), and those that do not (noncross).
950     std::vector<crossing_data> cross, noncross;
951     cross.reserve(endpoint_indices.size() + 1);
952     noncross.reserve(endpoint_indices.size());
953
954     for (size_t i = 0; i < endpoint_indices.size(); ++i) {
955 #if defined(CARVE_DEBUG)
956       std::cerr << "### orienting path: " << i << " endpoints: " << endpoint_indices[i].edge_idx[0] << " - " << endpoint_indices[i].edge_idx[1] << std::endl;
957 #endif
958       if (endpoint_indices[i].edge_idx[0] != N && endpoint_indices[i].edge_idx[1] != N) {
959         // Orient each path correctly. Paths should progress from
960         // smaller perimeter index to larger, but if the path starts
961         // and ends at the same perimeter index, then the decision
962         // needs to be made based upon area.
963         if (endpoint_indices[i].edge_idx[0] == endpoint_indices[i].edge_idx[1]) {
964           // The path forms a loop that starts and ends at the same
965           // vertex of the perimeter. In this case, we need to orient
966           // the path so that the constructed loop has the right
967           // signed area.
968           double area = carve::geom2d::signedArea(endpoint_indices[i].path->begin() + 1,
969                                                   endpoint_indices[i].path->end(),
970                                                   carve::mesh::MeshSet<3>::face_t::projection_mapping(face->project));
971           if (area < 0) {
972             // XXX: Create test case to check that this is the correct sign for the area.
973             std::reverse(endpoint_indices[i].path->begin(), endpoint_indices[i].path->end());
974           }
975         } else {
976           if (endpoint_indices[i].edge_idx[0] > endpoint_indices[i].edge_idx[1]) {
977             std::swap(endpoint_indices[i].edge_idx[0], endpoint_indices[i].edge_idx[1]);
978             std::reverse(endpoint_indices[i].path->begin(), endpoint_indices[i].path->end());
979           }
980         }
981       }
982
983       if (endpoint_indices[i].edge_idx[0] != N &&
984           endpoint_indices[i].edge_idx[1] != N &&
985           endpoint_indices[i].edge_idx[0] != endpoint_indices[i].edge_idx[1]) {
986         cross.push_back(endpoint_indices[i]);
987       } else {
988         noncross.push_back(endpoint_indices[i]);
989       }
990     }
991
992     // Step 3:
993     // add a temporary crossing path that connects the beginning and the
994     // end of the base loop. this stops us from needing special case
995     // code to handle the left over loop after all the other crossing
996     // paths are considered.
997     std::vector<carve::mesh::MeshSet<3>::vertex_t *> base_loop_temp_path;
998     base_loop_temp_path.reserve(2);
999     base_loop_temp_path.push_back(base_loop.front());
1000     base_loop_temp_path.push_back(base_loop.back());
1001
1002     cross.push_back(crossing_data(&base_loop_temp_path, 0, base_loop.size() - 1));
1003 #if defined(CARVE_DEBUG)
1004     std::cerr << "### crossing edge count (with sentinel): " << cross.size() << std::endl;
1005 #endif
1006
1007     // Step 4:
1008     // sort paths by increasing beginning point and decreasing ending point.
1009     std::sort(cross.begin(), cross.end());
1010     std::sort(noncross.begin(), noncross.end());
1011
1012     // Step 5:
1013     // divide up the base loop based upon crossing paths.
1014     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > divided_base_loop;
1015     divided_base_loop.reserve(cross.size());
1016     std::vector<carve::mesh::MeshSet<3>::vertex_t *> out;
1017
1018     for (size_t i = 0; i < cross.size(); ++i) {
1019       size_t j;
1020       for (j = i + 1;
1021            j < cross.size() &&
1022              cross[i].edge_idx[0] == cross[j].edge_idx[0] && 
1023              cross[i].edge_idx[1] == cross[j].edge_idx[1];
1024            ++j) {}
1025       if (j - i >= 2) {
1026         // when there are multiple paths that begin and end at the
1027         // same point, they need to be ordered so that the constructed
1028         // loops have the right orientation. this means that the loop
1029         // made by taking path(i+1) forward, then path(i) backward
1030         // needs to have negative area. this combined area is equal to
1031         // the area of path(i+1) minus the area of path(i). in turn
1032         // this means that the loop made by path path(i+1) alone has
1033         // to have smaller signed area than loop made by path(i).
1034         // thus, we sort paths in order of decreasing area.
1035
1036         std::vector<std::pair<double, std::vector<carve::mesh::MeshSet<3>::vertex_t *> *> > order;
1037         order.reserve(j - i);
1038         for (size_t k = i; k < j; ++k) {
1039           double area = carve::geom2d::signedArea(cross[k].path->begin(),
1040                                                   cross[k].path->end(),
1041                                                   carve::mesh::MeshSet<3>::face_t::projection_mapping(face->project));
1042 #if defined(CARVE_DEBUG)
1043           std::cerr << "### k=" << k << " area=" << area << std::endl;
1044 #endif
1045           order.push_back(std::make_pair(-area, cross[k].path));
1046         }
1047         std::sort(order.begin(), order.end());
1048         for (size_t k = i; k < j; ++k) {
1049           cross[k].path = order[k-i].second;
1050 #if defined(CARVE_DEBUG)
1051           std::cerr << "### post-sort k=" << k << " cross[k].path->size()=" << cross[k].path->size() << std::endl;
1052 #endif
1053         }
1054       }
1055     }
1056
1057     // Step 6:
1058     for (size_t i = 0; i < cross.size(); ++i) {
1059 #if defined(CARVE_DEBUG)
1060       std::cerr << "### i=" << i << " working on edge: " << cross[i].edge_idx[0] << " - " << cross[i].edge_idx[1] << std::endl;
1061 #endif
1062       size_t e1_0 = cross[i].edge_idx[0];
1063       size_t e1_1 = cross[i].edge_idx[1];
1064       std::vector<carve::mesh::MeshSet<3>::vertex_t *> &p1 = *cross[i].path;
1065 #if defined(CARVE_DEBUG)
1066       std::cerr << "###     path size = " << p1.size() << std::endl;
1067 #endif
1068
1069       out.clear();
1070
1071       if (i < cross.size() - 1 &&
1072           cross[i+1].edge_idx[1] <= cross[i].edge_idx[1]) {
1073 #if defined(CARVE_DEBUG)
1074         std::cerr << "###     complex case" << std::endl;
1075 #endif
1076         // complex case. crossing path with other crossing paths embedded within.
1077         size_t pos = e1_0;
1078
1079         size_t skip = i+1;
1080
1081         while (pos != e1_1) {
1082
1083           std::vector<carve::mesh::MeshSet<3>::vertex_t *> &p2 = *cross[skip].path;
1084           size_t e2_0 = cross[skip].edge_idx[0];
1085           size_t e2_1 = cross[skip].edge_idx[1];
1086
1087           // copy up to the beginning of the next path.
1088           std::copy(base_loop.begin() + pos, base_loop.begin() + e2_0, std::back_inserter(out));
1089
1090           CARVE_ASSERT(base_loop[e2_0] == p2[0]);
1091           // copy the next path in the right direction.
1092           std::copy(p2.begin(), p2.end() - 1, std::back_inserter(out));
1093
1094           // move to the position of the end of the path.
1095           pos = e2_1;
1096
1097           // advance to the next hit path.
1098           do {
1099             ++skip;
1100           } while(skip != cross.size() && cross[skip].edge_idx[0] < e2_1);
1101
1102           if (skip == cross.size()) break;
1103
1104           // if the next hit path is past the start point of the current path, we're done.
1105           if (cross[skip].edge_idx[0] >= e1_1) break;
1106         }
1107
1108         // copy up to the end of the path.
1109         std::copy(base_loop.begin() + pos, base_loop.begin() + e1_1, std::back_inserter(out));
1110
1111         CARVE_ASSERT(base_loop[e1_1] == p1.back());
1112         std::copy(p1.rbegin(), p1.rend() - 1, std::back_inserter(out));
1113       } else {
1114         size_t loop_size = (e1_1 - e1_0) + (p1.size() - 1);
1115         out.reserve(loop_size);
1116
1117         std::copy(base_loop.begin() + e1_0, base_loop.begin() + e1_1, std::back_inserter(out));
1118         std::copy(p1.rbegin(), p1.rend() - 1, std::back_inserter(out));
1119
1120         CARVE_ASSERT(out.size() == loop_size);
1121       }
1122       divided_base_loop.push_back(out);
1123
1124 #if defined(CARVE_DEBUG)
1125       {
1126         std::vector<carve::geom2d::P2> projected;
1127         projected.reserve(out.size());
1128         for (size_t n = 0; n < out.size(); ++n) {
1129           projected.push_back(face->project(out[n]->v));
1130         }
1131
1132         double A = carve::geom2d::signedArea(projected);
1133         std::cerr << "### out area=" << A << std::endl;
1134         CARVE_ASSERT(A <= 0);
1135       }
1136 #endif
1137     }
1138
1139     if (!noncross.size()) {
1140       // If there are no non-crossing paths then we're done.
1141       populateListFromVector(divided_base_loop, face_loops_out);
1142       return true;
1143     }
1144
1145     // for each divided base loop, work out which noncrossing paths and
1146     // loops are part of it. use the old algorithm to combine these into
1147     // the divided base loop. if none, the divided base loop is just
1148     // output.
1149     std::vector<std::vector<carve::geom2d::P2> > proj;
1150     std::vector<carve::geom::aabb<2> > proj_aabb;
1151     proj.resize(divided_base_loop.size());
1152     proj_aabb.resize(divided_base_loop.size());
1153
1154     // calculate an aabb for each divided base loop, to avoid expensive
1155     // point-in-poly tests.
1156     for (size_t i = 0; i < divided_base_loop.size(); ++i) {
1157       proj[i].reserve(divided_base_loop[i].size());
1158       for (size_t j = 0; j < divided_base_loop[i].size(); ++j) {
1159         proj[i].push_back(face->project(divided_base_loop[i][j]->v));
1160       }
1161       proj_aabb[i].fit(proj[i].begin(), proj[i].end());
1162     }
1163
1164     for (size_t i = 0; i < divided_base_loop.size(); ++i) {
1165       std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> *> inc;
1166       carve::geom2d::P2 test;
1167
1168       // for each noncrossing path, choose an endpoint that isn't on the
1169       // base loop as a test point.
1170       for (size_t j = 0; j < noncross.size(); ++j) {
1171         if (noncross[j].edge_idx[0] < N) {
1172           if (noncross[j].path->front() == base_loop[noncross[j].edge_idx[0]]) {
1173             // noncrossing paths may be loops that run from the edge, back to the same vertex.
1174             if (noncross[j].path->front() == noncross[j].path->back()) {
1175               CARVE_ASSERT(noncross[j].path->size() > 2);
1176               test = face->project((*noncross[j].path)[1]->v);
1177             } else {
1178               test = face->project(noncross[j].path->back()->v);
1179             }
1180           } else {
1181             test = face->project(noncross[j].path->front()->v);
1182           }
1183         } else {
1184           test = face->project(noncross[j].path->front()->v);
1185         }
1186
1187         if (proj_aabb[i].intersects(test) &&
1188             carve::geom2d::pointInPoly(proj[i], test).iclass != carve::POINT_OUT) {
1189           inc.push_back(noncross[j].path);
1190         }
1191       }
1192
1193 #if defined(CARVE_DEBUG)
1194       std::cerr << "### divided base loop:" << i << " inc.size()=" << inc.size() << std::endl;
1195       std::cerr << "### inc = [";
1196       for (size_t j = 0; j < inc.size(); ++j) {
1197         std::cerr << " " << inc[j];
1198       }
1199       std::cerr << " ]" << std::endl;
1200 #endif
1201
1202       if (inc.size()) {
1203         carve::csg::V2Set face_edges;
1204
1205         for (size_t j = 0; j < divided_base_loop[i].size() - 1; ++j) {
1206           face_edges.insert(std::make_pair(divided_base_loop[i][j],
1207                                            divided_base_loop[i][j+1]));
1208         }
1209
1210         face_edges.insert(std::make_pair(divided_base_loop[i].back(),
1211                                          divided_base_loop[i].front()));
1212
1213         for (size_t j = 0; j < inc.size(); ++j) {
1214           std::vector<carve::mesh::MeshSet<3>::vertex_t *> &path = *inc[j];
1215           for (size_t k = 0; k < path.size() - 1; ++k) {
1216             face_edges.insert(std::make_pair(path[k], path[k+1]));
1217             face_edges.insert(std::make_pair(path[k+1], path[k]));
1218           }
1219         }
1220
1221         std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > face_loops;
1222         std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > hole_loops;
1223
1224         splitFace(face, face_edges, face_loops, hole_loops, vertex_intersections);
1225
1226         if (hole_loops.size()) {
1227           mergeFacesAndHoles(face, face_loops, hole_loops, hooks);
1228         }
1229         std::copy(face_loops.begin(), face_loops.end(), std::back_inserter(face_loops_out));
1230       } else {
1231         face_loops_out.push_back(divided_base_loop[i]);
1232       }
1233     }
1234     return true;
1235   }
1236
1237
1238
1239   void composeEdgesIntoPaths(const carve::csg::V2Set &edges,
1240                              const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &extra_endpoints,
1241                              std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &paths,
1242                              std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &cuts,
1243                              std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &loops) {
1244     using namespace carve::csg;
1245
1246     detail::VVSMap vertex_graph;
1247     detail::VSet endpoints;
1248     detail::VSet cut_endpoints;
1249
1250     typedef std::vector<carve::mesh::MeshSet<3>::vertex_t *> vvec_t;
1251     vvec_t path;
1252
1253     std::list<vvec_t> path_list, cut_list, loop_list;
1254
1255     // build graph from edges.
1256     for (V2Set::const_iterator i = edges.begin(); i != edges.end(); ++i) {
1257 #if defined(CARVE_DEBUG)
1258       std::cerr << "###    edge: " << (*i).first << " - " << (*i).second << std::endl;
1259 #endif
1260       vertex_graph[(*i).first].insert((*i).second);
1261       vertex_graph[(*i).second].insert((*i).first);
1262     }
1263
1264     // find the endpoints in the graph.
1265     // every vertex with number of incident edges != 2 is an endpoint.
1266     for (detail::VVSMap::const_iterator i = vertex_graph.begin(); i != vertex_graph.end(); ++i) {
1267       if ((*i).second.size() != 2) {
1268 #if defined(CARVE_DEBUG)
1269         std::cerr << "###    endpoint: " << (*i).first << std::endl;
1270 #endif
1271         endpoints.insert((*i).first);
1272         if ((*i).second.size() == 1) {
1273           cut_endpoints.insert((*i).first);
1274         }
1275       }
1276     }
1277
1278     // every vertex on the perimeter of the face is also an endpoint.
1279     for (size_t i = 0; i < extra_endpoints.size(); ++i) {
1280       if (vertex_graph.find(extra_endpoints[i]) != vertex_graph.end()) {
1281 #if defined(CARVE_DEBUG)
1282         std::cerr << "###    extra endpoint: " << extra_endpoints[i] << std::endl;
1283 #endif
1284         endpoints.insert(extra_endpoints[i]);
1285         cut_endpoints.erase(extra_endpoints[i]);
1286       }
1287     }
1288
1289     while (endpoints.size()) {
1290       carve::mesh::MeshSet<3>::vertex_t *v = *endpoints.begin();
1291       detail::VVSMap::iterator p = vertex_graph.find(v);
1292       if (p == vertex_graph.end()) {
1293         endpoints.erase(endpoints.begin());
1294         continue;
1295       }
1296
1297       path.clear();
1298       path.push_back(v);
1299
1300       for (;;) {
1301         CARVE_ASSERT(p != vertex_graph.end());
1302
1303         // pick a connected vertex to move to.
1304         if ((*p).second.size() == 0) break;
1305
1306         carve::mesh::MeshSet<3>::vertex_t *n = *((*p).second.begin());
1307         detail::VVSMap::iterator q = vertex_graph.find(n);
1308
1309         // remove the link.
1310         (*p).second.erase(n);
1311         (*q).second.erase(v);
1312
1313         // move on.
1314         v = n;
1315         path.push_back(v);
1316
1317         if ((*p).second.size() == 0) vertex_graph.erase(p);
1318         if ((*q).second.size() == 0) {
1319           vertex_graph.erase(q);
1320           q = vertex_graph.end();
1321         }
1322
1323         p = q;
1324
1325         if (v == path[0] || p == vertex_graph.end() || endpoints.find(v) != endpoints.end()) break;
1326       }
1327       CARVE_ASSERT(endpoints.find(path.back()) != endpoints.end());
1328
1329       bool is_cut =
1330         cut_endpoints.find(path.front()) != cut_endpoints.end() &&
1331         cut_endpoints.find(path.back()) != cut_endpoints.end();
1332
1333       if (is_cut) {
1334         cut_list.push_back(vvec_t()); path.swap(cut_list.back());
1335       } else {
1336         path_list.push_back(vvec_t()); path.swap(path_list.back());
1337       }
1338     }
1339
1340     populateVectorFromList(path_list, paths);
1341     populateVectorFromList(cut_list, cuts);
1342
1343     // now only loops should remain in the graph.
1344     while (vertex_graph.size()) {
1345       detail::VVSMap::iterator p = vertex_graph.begin();
1346       carve::mesh::MeshSet<3>::vertex_t *v = (*p).first;
1347       CARVE_ASSERT((*p).second.size() == 2);
1348
1349       std::vector<carve::mesh::MeshSet<3>::vertex_t *> path;
1350       path.clear();
1351       path.push_back(v);
1352
1353       for (;;) {
1354         CARVE_ASSERT(p != vertex_graph.end());
1355         // pick a connected vertex to move to.
1356
1357         carve::mesh::MeshSet<3>::vertex_t *n = *((*p).second.begin());
1358         detail::VVSMap::iterator q = vertex_graph.find(n);
1359
1360         // remove the link.
1361         (*p).second.erase(n);
1362         (*q).second.erase(v);
1363
1364         // move on.
1365         v = n;
1366         path.push_back(v);
1367
1368         if ((*p).second.size() == 0) vertex_graph.erase(p);
1369         if ((*q).second.size() == 0) vertex_graph.erase(q);
1370
1371         p = q;
1372
1373         if (v == path[0]) break;
1374       }
1375
1376       loop_list.push_back(vvec_t()); path.swap(loop_list.back());
1377     }
1378  
1379     populateVectorFromList(loop_list, loops);
1380   }
1381
1382
1383
1384   template<typename T>
1385   std::string ptrstr(const T *ptr) {
1386     std::ostringstream s;
1387     s << ptr;
1388     return s.str().substr(1);
1389   }
1390
1391   void dumpAsGraph(carve::mesh::MeshSet<3>::face_t *face,
1392                    const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &base_loop,
1393                    const carve::csg::V2Set &face_edges,
1394                    const carve::csg::V2Set &split_edges) {
1395     std::map<carve::mesh::MeshSet<3>::vertex_t *, carve::geom2d::P2> proj;
1396
1397     for (size_t i = 0; i < base_loop.size(); ++i) {
1398       proj[base_loop[i]] = face->project(base_loop[i]->v);
1399     }
1400     for (carve::csg::V2Set::const_iterator i = split_edges.begin(); i != split_edges.end(); ++i) {
1401       proj[(*i).first] = face->project((*i).first->v);
1402       proj[(*i).second] = face->project((*i).second->v);
1403     }
1404
1405     {
1406       carve::geom2d::P2 lo, hi;
1407       std::map<carve::mesh::MeshSet<3>::vertex_t *, carve::geom2d::P2>::iterator i;
1408       i = proj.begin();
1409       lo = hi = (*i).second;
1410       for (; i != proj.end(); ++i) {
1411         lo.x = std::min(lo.x, (*i).second.x); lo.y = std::min(lo.y, (*i).second.y);
1412         hi.x = std::max(hi.x, (*i).second.x); hi.y = std::max(hi.y, (*i).second.y);
1413       }
1414       for (i = proj.begin(); i != proj.end(); ++i) {
1415         (*i).second.x = ((*i).second.x - lo.x) / (hi.x - lo.x) * 10;
1416         (*i).second.y = ((*i).second.y - lo.y) / (hi.y - lo.y) * 10;
1417       }
1418     }
1419
1420     std::cerr << "graph G {\nnode [shape=circle,style=filled,fixedsize=true,width=\".1\",height=\".1\"];\nedge [len=4]\n";
1421     for (std::map<carve::mesh::MeshSet<3>::vertex_t *, carve::geom2d::P2>::iterator i = proj.begin(); i != proj.end(); ++i) {
1422       std::cerr << "   " << ptrstr((*i).first) << " [pos=\"" << (*i).second.x << "," << (*i).second.y << "!\"];\n";
1423     }
1424     for (carve::csg::V2Set::const_iterator i = face_edges.begin(); i != face_edges.end(); ++i) {
1425       std::cerr << "   " << ptrstr((*i).first) << " -- " << ptrstr((*i).second) << ";\n";
1426     }
1427     for (carve::csg::V2Set::const_iterator i = split_edges.begin(); i != split_edges.end(); ++i) {
1428       std::cerr << "   " << ptrstr((*i).first) << " -- " << ptrstr((*i).second) << " [color=\"blue\"];\n";
1429     }
1430     std::cerr << "};\n";
1431   }
1432
1433   void generateOneFaceLoop(carve::mesh::MeshSet<3>::face_t *face,
1434                            const carve::csg::detail::Data &data,
1435                            const carve::csg::VertexIntersections &vertex_intersections,
1436                            carve::csg::CSG::Hooks &hooks,
1437                            std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > &face_loops) {
1438     using namespace carve::csg;
1439
1440     std::vector<carve::mesh::MeshSet<3>::vertex_t *> base_loop;
1441     std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > hole_loops;
1442
1443     bool face_edge_intersected = assembleBaseLoop(face, data, base_loop);
1444
1445     detail::FV2SMap::const_iterator fse_iter = data.face_split_edges.find(face);
1446
1447     face_loops.clear();
1448
1449     if (fse_iter == data.face_split_edges.end()) {
1450       // simple case: input face is output face (possibly with the
1451       // addition of vertices at intersections).
1452       face_loops.push_back(base_loop);
1453       return;
1454     }
1455
1456     // complex case: input face is split into multiple output faces.
1457     V2Set face_edges;
1458
1459     for (size_t j = 0, je = base_loop.size() - 1; j < je; ++j) {
1460       face_edges.insert(std::make_pair(base_loop[j], base_loop[j + 1]));
1461     }
1462     face_edges.insert(std::make_pair(base_loop.back(), base_loop[0]));
1463
1464     // collect the split edges (as long as they're not on the perimeter)
1465     const detail::FV2SMap::mapped_type &fse = ((*fse_iter).second);
1466
1467     // split_edges contains all of the edges created by intersections
1468     // that aren't part of the perimeter of the face.
1469     V2Set split_edges;
1470
1471     for (detail::FV2SMap::mapped_type::const_iterator
1472            j = fse.begin(), je =  fse.end();
1473          j != je;
1474          ++j) {
1475       carve::mesh::MeshSet<3>::vertex_t *v1 = ((*j).first), *v2 = ((*j).second);
1476
1477       if (face_edges.find(std::make_pair(v1, v2)) == face_edges.end() &&
1478           face_edges.find(std::make_pair(v2, v1)) == face_edges.end()) {
1479         // If the edge isn't part of the face perimeter, add it to
1480         // split_edges.
1481         split_edges.insert(ordered_edge(v1, v2));
1482       }
1483     }
1484
1485     // face is unsplit.
1486     if (!split_edges.size()) {
1487       face_loops.push_back(base_loop);
1488       return;
1489     }
1490
1491 #if defined(CARVE_DEBUG)
1492     dumpAsGraph(face, base_loop, face_edges, split_edges);
1493 #endif
1494
1495 #if 0
1496     // old face splitting method.
1497     for (V2Set::const_iterator i = split_edges.begin(); i != split_edges.end(); ++i) {
1498       face_edges.insert(std::make_pair((*i).first, (*i).second));
1499       face_edges.insert(std::make_pair((*i).second, (*i).first));
1500     }
1501     splitFace(face, face_edges, face_loops, hole_loops, vertex_intersections);
1502
1503     if (hole_loops.size()) {
1504       mergeFacesAndHoles(face, face_loops, hole_loops, hooks);
1505     }
1506     return;
1507 #endif
1508
1509 #if defined(CARVE_DEBUG)
1510     std::cerr << "### split_edges.size(): " << split_edges.size() << std::endl;
1511 #endif
1512     if (split_edges.size() == 1) {
1513       // handle the common case of a face that's split by a single edge.
1514       carve::mesh::MeshSet<3>::vertex_t *v1 = split_edges.begin()->first;
1515       carve::mesh::MeshSet<3>::vertex_t *v2 = split_edges.begin()->second;
1516
1517       std::vector<carve::mesh::MeshSet<3>::vertex_t *>::iterator vi1 = std::find(base_loop.begin(), base_loop.end(), v1);
1518       std::vector<carve::mesh::MeshSet<3>::vertex_t *>::iterator vi2 = std::find(base_loop.begin(), base_loop.end(), v2);
1519
1520       if (vi1 != base_loop.end() && vi2 != base_loop.end()) {
1521         // this is an inserted edge that connects two points on the base loop. nice and simple.
1522         if (vi2 < vi1) std::swap(vi1, vi2);
1523
1524         size_t loop1_size = vi2 - vi1 + 1;
1525         size_t loop2_size = base_loop.size() + 2 - loop1_size;
1526
1527         std::vector<carve::mesh::MeshSet<3>::vertex_t *> l1;
1528         std::vector<carve::mesh::MeshSet<3>::vertex_t *> l2;
1529
1530         l1.reserve(loop1_size);
1531         l2.reserve(loop2_size);
1532
1533         std::copy(vi1, vi2+1, std::back_inserter(l1));
1534         std::copy(vi2, base_loop.end(), std::back_inserter(l2));
1535         std::copy(base_loop.begin(), vi1+1, std::back_inserter(l2));
1536
1537         CARVE_ASSERT(l1.size() == loop1_size);
1538         CARVE_ASSERT(l2.size() == loop2_size);
1539
1540         face_loops.push_back(l1);
1541         face_loops.push_back(l2);
1542
1543         return;
1544       }
1545
1546       // Consider handling cases where one end of the edge touches the
1547       // perimeter, and where neither end does.
1548     }
1549
1550     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > paths;
1551     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > cuts;
1552     std::vector<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > loops;
1553
1554     // Take the split edges and compose them into a set of paths and
1555     // loops. Loops are edge paths that do not touch the boundary, or
1556     // any other path or loop - they are holes cut out of the centre
1557     // of the face. Paths are made up of all the other edge segments,
1558     // and start and end at the face perimeter, or where they meet
1559     // another path (sometimes both cases will be true).
1560     composeEdgesIntoPaths(split_edges, base_loop, paths, cuts, loops);
1561
1562 #if defined(CARVE_DEBUG)
1563     std::cerr << "###   paths.size(): " << paths.size() << std::endl;
1564     std::cerr << "###   cuts.size():  " << cuts.size() << std::endl;
1565     std::cerr << "###   loops.size(): " << loops.size() << std::endl;
1566 #endif
1567
1568     if (!paths.size()) {
1569       // No complex paths.
1570       face_loops.push_back(base_loop);
1571     } else {
1572       if (processCrossingEdges(face, vertex_intersections, hooks, base_loop, paths, face_loops)) {
1573         // Worked.
1574       } else {
1575         // complex case - fall back to old edge tracing code.
1576 #if defined(CARVE_DEBUG)
1577         std::cerr << "### processCrossingEdges failed. Falling back to edge tracing code" << std::endl;
1578 #endif
1579         for (size_t i = 0; i < paths.size(); ++i) {
1580           for (size_t j = 0; j < paths[i].size() - 1; ++j) {
1581             face_edges.insert(std::make_pair(paths[i][j], paths[i][j+1]));
1582             face_edges.insert(std::make_pair(paths[i][j+1], paths[i][j]));
1583           }
1584         }
1585         splitFace(face, face_edges, face_loops, hole_loops, vertex_intersections);
1586       }
1587     }
1588
1589     // Now merge cuts and loops into face loops.
1590
1591     // every cut creates a hole.
1592     for (size_t i = 0; i < cuts.size(); ++i) {
1593       hole_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
1594       hole_loops.back().reserve(2 * cuts[i].size() - 2);
1595       std::copy(cuts[i].begin(), cuts[i].end(), std::back_inserter(hole_loops.back()));
1596       if (cuts[i].size() > 2) {
1597         std::copy(cuts[i].rbegin() + 1, cuts[i].rend() - 1, std::back_inserter(hole_loops.back()));
1598       }
1599     }
1600
1601     // every loop creates a hole and a corresponding face.
1602     for (size_t i = 0; i < loops.size(); ++i) {
1603       hole_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
1604       hole_loops.back().reserve(loops[i].size()-1);
1605       std::copy(loops[i].begin(), loops[i].end()-1, std::back_inserter(hole_loops.back()));
1606
1607       face_loops.push_back(std::vector<carve::mesh::MeshSet<3>::vertex_t *>());
1608       face_loops.back().reserve(loops[i].size()-1);
1609       std::copy(loops[i].rbegin()+1, loops[i].rend(), std::back_inserter(face_loops.back()));
1610
1611       std::vector<carve::geom2d::P2> projected;
1612       projected.reserve(face_loops.back().size());
1613       for (size_t i = 0; i < face_loops.back().size(); ++i) {
1614         projected.push_back(face->project(face_loops.back()[i]->v));
1615       }
1616
1617       if (carve::geom2d::signedArea(projected) > 0.0) {
1618         std::swap(face_loops.back(), hole_loops.back());
1619       }
1620     }
1621
1622     // if there are holes, then they need to be merged with faces.
1623     if (hole_loops.size()) {
1624       mergeFacesAndHoles(face, face_loops, hole_loops, hooks);
1625     }
1626   }
1627 }
1628
1629
1630
1631 /** 
1632  * \brief Build a set of face loops for all (split) faces of a Polyhedron.
1633  * 
1634  * @param[in] poly The polyhedron to process
1635  * @param vmap 
1636  * @param face_split_edges 
1637  * @param divided_edges 
1638  * @param[out] face_loops_out The resulting face loops
1639  * 
1640  * @return The number of edges generated.
1641  */
1642 size_t carve::csg::CSG::generateFaceLoops(carve::mesh::MeshSet<3> *poly,
1643                                           const detail::Data &data,
1644                                           FaceLoopList &face_loops_out) {
1645   static carve::TimingName FUNC_NAME("CSG::generateFaceLoops()");
1646   carve::TimingBlock block(FUNC_NAME);
1647   size_t generated_edges = 0;
1648   std::vector<carve::mesh::MeshSet<3>::vertex_t *> base_loop;
1649   std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> > face_loops;
1650   
1651   for (carve::mesh::MeshSet<3>::face_iter i = poly->faceBegin(); i != poly->faceEnd(); ++i) {
1652     carve::mesh::MeshSet<3>::face_t *face = (*i);
1653
1654 #if defined(CARVE_DEBUG)
1655     double in_area = 0.0, out_area = 0.0;
1656
1657     {
1658       std::vector<carve::mesh::MeshSet<3>::vertex_t *> base_loop;
1659       assembleBaseLoop(face, data, base_loop);
1660
1661       {
1662         std::vector<carve::geom2d::P2> projected;
1663         projected.reserve(base_loop.size());
1664         for (size_t n = 0; n < base_loop.size(); ++n) {
1665           projected.push_back(face->project(base_loop[n]->v));
1666         }
1667
1668         in_area = carve::geom2d::signedArea(projected);
1669         std::cerr << "### in_area=" << in_area << std::endl;
1670       }
1671     }
1672 #endif
1673
1674     generateOneFaceLoop(face, data, vertex_intersections, hooks, face_loops);
1675
1676 #if defined(CARVE_DEBUG)
1677     {
1678       V2Set face_edges;
1679
1680       std::vector<carve::mesh::MeshSet<3>::vertex_t *> base_loop;
1681       assembleBaseLoop(face, data, base_loop);
1682
1683       for (size_t j = 0, je = base_loop.size() - 1; j < je; ++j) {
1684         face_edges.insert(std::make_pair(base_loop[j+1], base_loop[j]));
1685       }
1686       face_edges.insert(std::make_pair(base_loop[0], base_loop.back()));
1687       for (std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> >::const_iterator fli = face_loops.begin(); fli != face_loops.end(); ++ fli) {
1688
1689         {
1690           std::vector<carve::geom2d::P2> projected;
1691           projected.reserve((*fli).size());
1692           for (size_t n = 0; n < (*fli).size(); ++n) {
1693             projected.push_back(face->project((*fli)[n]->v));
1694           }
1695
1696           double area = carve::geom2d::signedArea(projected);
1697           std::cerr << "### loop_area[" << std::distance((std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> >::const_iterator)face_loops.begin(), fli) << "]=" << area << std::endl;
1698           out_area += area;
1699         }
1700
1701         const std::vector<carve::mesh::MeshSet<3>::vertex_t *> &fl = *fli;
1702         for (size_t j = 0, je = fl.size() - 1; j < je; ++j) {
1703           face_edges.insert(std::make_pair(fl[j], fl[j+1]));
1704         }
1705         face_edges.insert(std::make_pair(fl.back(), fl[0]));
1706       }
1707       for (V2Set::const_iterator j = face_edges.begin(); j != face_edges.end(); ++j) {
1708         if (face_edges.find(std::make_pair((*j).second, (*j).first)) == face_edges.end()) {
1709           std::cerr << "### error: unmatched edge [" << (*j).first << "-" << (*j).second << "]" << std::endl;
1710         }
1711       }
1712       std::cerr << "### out_area=" << out_area << std::endl;
1713       if (out_area != in_area) {
1714         std::cerr << "### error: area does not match. delta = " << (out_area - in_area) << std::endl;
1715         // CARVE_ASSERT(fabs(out_area - in_area) < 1e-5);
1716       }
1717     }
1718 #endif
1719
1720     // now record all the resulting face loops.
1721 #if defined(CARVE_DEBUG)
1722     std::cerr << "### ======" << std::endl;
1723 #endif
1724     for (std::list<std::vector<carve::mesh::MeshSet<3>::vertex_t *> >::const_iterator
1725            f = face_loops.begin(), fe = face_loops.end();
1726          f != fe;
1727          ++f) {
1728 #if defined(CARVE_DEBUG)
1729       std::cerr << "### loop:";
1730       for (size_t i = 0; i < (*f).size(); ++i) {
1731         std::cerr << " " << (*f)[i];
1732       }
1733       std::cerr << std::endl;
1734 #endif
1735
1736       face_loops_out.append(new FaceLoop(face, *f));
1737       generated_edges += (*f).size();
1738     }
1739 #if defined(CARVE_DEBUG)
1740     std::cerr << "### ======" << std::endl;
1741 #endif
1742   }
1743   return generated_edges;
1744 }