checkpoint
[anneal.git] / src / edu / berkeley / qfat / Mesh.java
1 package edu.berkeley.qfat;
2 import java.awt.*;
3 import java.util.*;
4 import java.awt.event.*;
5 import javax.swing.*;
6 import javax.media.opengl.*;
7 import javax.media.opengl.glu.*;
8 import edu.berkeley.qfat.geom.*;
9 import edu.wlu.cs.levy.CG.KDTree;
10 import edu.berkeley.qfat.geom.Point;
11
12 public class Mesh implements Iterable<Mesh.T> {
13
14     public static final float EPSILON = (float)0.0001;
15     public static final Random random = new Random();
16
17     private RTree<T>         triangles = new RTree<T>();
18     private PointSet<Vertex> vertices  = new PointSet<Vertex>();
19
20     public boolean immutableVertices;
21     public boolean ignorecollision = false;
22     public Mesh    score_against = null;
23     public double  score = 0;
24
25     public Mesh(boolean immutableVertices) { this.immutableVertices = immutableVertices; }
26
27     public void makeVerticesImmutable() { this.immutableVertices = true; }
28     public float score() { return (float)score; }
29
30     public int size() { return vertices.size(); }
31     public Iterable<Vertex> vertices() { return vertices; }
32     public Iterator<T> iterator() { return triangles.iterator(); }
33
34     public void rebindPoints() {
35         // unbind all points
36         for(Mesh.T t : this) {
37             t.v1().unbind();
38             t.v2().unbind();
39             t.v3().unbind();
40         }
41         // ask edges to re-implement their bindings
42         for(Mesh.T t : this) {
43             t.e1().dobind();
44             t.e2().dobind();
45             t.e3().dobind();
46         }
47     }
48
49     public void unApplyQuadricToNeighborAll() {
50         HashSet<Vertex> done = new HashSet<Vertex>();
51         for(T t : this)
52             for(Vertex p : new Vertex[] { t.v1(), t.v2(), t.v3() }) {
53                 if (done.contains(p)) continue;
54                 done.add(p);
55                 p.unApplyQuadricToNeighbor();
56             }
57     }
58     public void recomputeAllFundamentalQuadrics() {
59         HashSet<Vertex> done = new HashSet<Vertex>();
60         for(T t : this)
61             for(Vertex p : new Vertex[] { t.v1(), t.v2(), t.v3() }) {
62                 if (done.contains(p)) continue;
63                 done.add(p);
64                 p.recomputeFundamentalQuadric();
65             }
66     }
67     public float applyQuadricToNeighborAll() {
68         int num = 0;
69         double dist = 0;
70         HashSet<Vertex> done = new HashSet<Vertex>();
71         for(T t : this)
72             for(Vertex p : new Vertex[] { t.v1(), t.v2(), t.v3() }) {
73                 if (done.contains(p)) continue;
74                 done.add(p);
75                 p.applyQuadricToNeighbor();
76                 
77             }
78         return (float)(dist/num);
79     }
80
81     public void transform(Matrix m) {
82         ArrayList<Vertex> set = new ArrayList<Vertex>();
83         for(Vertex v : vertices) set.add(v);
84         for(Vertex v : set) v.transform(m);
85     }
86
87     public void rebuild() { /*vertices.rebuild();*/ }
88     public Vec diagonal() { return vertices.diagonal(); }
89     public Point centroid() { return vertices.centroid(); }
90     public Vertex nearest(Point p) { return vertices.nearest(p); }
91
92     /** compute the volume of the mesh */
93     public float volume() {
94         double total = 0;
95         for(T t : this) {
96             double area = t.area();
97             Vec origin_to_centroid = new Vec(new Point(0, 0, 0), t.centroid());
98             boolean facingAway = t.norm().dot(origin_to_centroid) > 0;
99             double height = Math.abs(t.norm().dot(origin_to_centroid));
100             total += ((facingAway ? 1 : -1) * area * height) / 3.0;
101         }
102         return (float)total;
103     }
104
105
106     // Vertexices //////////////////////////////////////////////////////////////////////////////
107
108     /** a vertex in the mesh */
109     public final class Vertex extends HasPoint implements Visitor<T> {
110         public String toString() { return p.toString(); }
111         public Point p;
112         E e;                // some edge *leaving* this point
113
114         /** the nearest vertex in the "score_against" mesh */
115         Vertex   nearest_in_other_mesh;
116         /** the number of vertices in the other mesh for which this is the nearest_in_other_mesh */
117         int    quadric_count;
118         /** the total error quadric (contributions from all vertices in other mesh for which this is nearest) */
119         Matrix quadric = Matrix.ZERO;
120
121         Vertex bound_to = this;
122         Matrix binding = Matrix.ONE;
123         float oldscore = 0;
124         boolean quadricStale = false;
125
126         public Matrix errorQuadric() { return quadric; }
127         public Point getPoint() { return p; }
128         public float score() { return oldscore; }
129
130         private Matrix fundamentalQuadric = null;
131         public Matrix fundamentalQuadric() {
132             if (fundamentalQuadric == null) recomputeFundamentalQuadric();
133             return fundamentalQuadric;
134         }
135
136         private Vertex(Point p) {
137             this.p = p;
138             if (vertices.get(p) != null) throw new Error();
139             vertices.add(this);
140         }
141
142         private void glNormal(GL gl) {
143             Vec norm = norm();
144             gl.glNormal3f(norm.x, norm.y, norm.z);
145         }
146
147         public void recomputeFundamentalQuadric() {
148             if (!quadricStale && fundamentalQuadric != null) return;
149             quadricStale = false;
150             unApplyQuadricToNeighbor();
151             Matrix m = Matrix.ZERO;
152             E e = this.e;
153             int count = 0;
154             do {
155                 T t = e.t;
156                 m = m.plus(t.norm().fundamentalQuadric(t.centroid()));
157                 count++;
158                 e = e.pair.next;
159             } while(e != this.e);
160             fundamentalQuadric = m.times(1/(float)count);
161             applyQuadricToNeighbor();
162         }
163
164         public void unApplyQuadricToNeighbor() {
165             if (nearest_in_other_mesh == null) return;
166             if (fundamentalQuadric == null) return;
167             nearest_in_other_mesh.unComputeError();
168             nearest_in_other_mesh.quadric = nearest_in_other_mesh.quadric.minus(fundamentalQuadric);
169             nearest_in_other_mesh.quadric_count--;
170             if (nearest_in_other_mesh.quadric_count==0)
171                 nearest_in_other_mesh.quadric = Matrix.ZERO;
172             nearest_in_other_mesh.computeError();
173             nearest_in_other_mesh = null;
174         }
175
176         public void applyQuadricToNeighbor() {
177             if (score_against == null) return;
178
179             Vertex new_nearest = score_against.nearest(p);
180             if (nearest_in_other_mesh != null && new_nearest == nearest_in_other_mesh) return;
181
182             if (nearest_in_other_mesh != null) unApplyQuadricToNeighbor();
183             if (nearest_in_other_mesh != null) throw new Error();
184
185             nearest_in_other_mesh = new_nearest;
186                 
187             // don't attract to vertices that face the other way
188             if (nearest_in_other_mesh.e == null || nearest_in_other_mesh.norm().dot(norm()) < 0) {
189                 nearest_in_other_mesh = null;
190             } else {
191                 nearest_in_other_mesh.unComputeError();
192                 nearest_in_other_mesh.quadric = nearest_in_other_mesh.quadric.plus(fundamentalQuadric());
193                 nearest_in_other_mesh.quadric_count++;
194                 nearest_in_other_mesh.computeError();
195             }
196             reComputeError();
197         }
198
199         public void reComputeErrorAround() {
200             reComputeError();
201             if (nearest_in_other_mesh != null) nearest_in_other_mesh.reComputeError();
202             E e = this.e;
203             do {
204                 e.p2.reComputeError();
205                 e = e.pair.next;
206             } while (e != this.e);
207         }
208         public void reComputeError() {
209             unComputeError();
210             computeError();
211         }
212         public void unComputeError() {
213             score -= oldscore;
214             oldscore = 0;
215         }
216         public void computeError() {
217             if (quadric_count == 0) {
218                 if (immutableVertices) {
219                 } else if (nearest_in_other_mesh == null) {
220                     if (score_against != null) {
221                         Vertex ne = score_against.nearest(p);
222                         oldscore = ne.fundamentalQuadric().preAndPostMultiply(p) * 100 * 10;
223                     } else {
224                         oldscore = 0;
225                     }
226                 } else {
227                     oldscore = nearest_in_other_mesh.fundamentalQuadric().preAndPostMultiply(p) * 100 * 10;
228                 }
229             } else {
230                 oldscore = (quadric.preAndPostMultiply(p) * 100) / quadric_count;
231             }
232
233             oldscore = oldscore;
234
235             int numaspects = 0;
236             float aspects = 0;
237             E e = this.e;
238             do {
239                 //double ang = Math.abs(e.crossAngle());
240                 double ang = Math.abs(e.crossAngle());
241                 if (ang > Math.PI) throw new Error();
242                 /*
243                   if (e.t != null) {
244                   numaspects++;
245                   aspects += e.t.aspect()*e.t.aspect();
246                   }
247                 */
248
249                 float minangle = (float)(Math.PI * 0.8);
250                 if (ang > minangle)
251                     oldscore += (ang - minangle);
252
253                 e = e.pair.next;
254             } while (e != this.e);
255             if (numaspects > 0) oldscore += (aspects / numaspects);
256
257             //System.out.println(oldscore);
258             //oldscore = oldscore*oldscore;
259             score += oldscore;
260         }
261
262         private void removeTrianglesFromRTree() {
263             E e = this.e;
264             do {
265                 if (e.t != null) e.t.removeFromRTree();
266                 e = e.pair.next;
267             } while(e != this.e);
268         }
269         private void addTrianglesToRTree() {
270             E e = this.e;
271             do {
272                 if (e.t != null) e.t.addToRTree();
273                 e = e.pair.next;
274             } while(e != this.e);
275         }
276
277         /** does NOT update bound pairs! */
278         public boolean transform(Matrix m) {
279             if (immutableVertices) throw new Error();
280             unApplyQuadricToNeighbor();
281             Point oldp = this.p;
282             try {
283                 if (vertices.get(this.p)==null) throw new Error();
284                 vertices.remove(this);
285                 removeTrianglesFromRTree();
286                 float newx = m.a*p.x + m.b*p.y + m.c*p.z + m.d;
287                 float newy = m.e*p.x + m.f*p.y + m.g*p.z + m.h;
288                 float newz = m.i*p.x + m.j*p.y + m.k*p.z + m.l;
289                 this.p = new Point(newx, newy, newz);
290                 addTrianglesToRTree();
291                 vertices.add(this);
292             } catch (Exception e) {
293                 throw new RuntimeException(e);
294             }
295             applyQuadricToNeighbor();
296
297             // FIXME: intersection test needed?
298             good = true;
299
300             // should recompute fundamental quadrics of all vertices sharing a face, but we defer...
301             E e = this.e;
302             do {
303                 /*
304                   if (Math.abs(e.crossAngle()) > (Math.PI * 0.9) ||
305                   Math.abs(e.next.crossAngle()) > (Math.PI * 0.9)) {
306                   good = false;
307                   }
308                   if (e.t.aspect() < 0.1) {
309                   good = false;
310                   }
311                 */
312                 e.p2.quadricStale = true;
313                 e = e.pair.next;
314             } while(e != this.e);
315
316             if (!ignorecollision && good) triangles.range(oldp, this.p, (Visitor<T>)this);
317
318             reComputeErrorAround();
319             return good;
320         }
321
322         public void visit(T t) {
323             if (!good) return;
324             E e = Vertex.this.e;
325             do {
326                 if (!t.has(e.p1) && !t.has(e.p2) && e.intersects(t)) { good = false; }
327                 if (e.t != null) {
328                     if (!e.t.has(t.e1().p1) && !e.t.has(t.e1().p2) && t.e1().intersects(e.t)) { good = false; }
329                     if (!e.t.has(t.e2().p1) && !e.t.has(t.e2().p2) && t.e2().intersects(e.t)) { good = false; }
330                     if (!e.t.has(t.e3().p1) && !e.t.has(t.e3().p2) && t.e3().intersects(e.t)) { good = false; }
331                 }
332                 e = e.pair.next;
333             } while(e != Vertex.this.e);
334         }
335         private boolean good;
336
337         public boolean move(Vec v) {
338             Matrix m = Matrix.translate(v);
339             Vertex p = this;
340             boolean good = true;
341             do {
342                 good &= p.transform(m);
343                 p = p.bound_to;
344             } while (p != this);
345             return good;
346         }
347
348         public E getFreeIncident() {
349             E ret = getFreeIncident(e, e);
350             if (ret != null) return ret;
351             ret = getFreeIncident(e.pair.next, e.pair.next);
352             if (ret == null) {
353                 E ex = e;
354                 do {
355                     System.out.println(ex + " " + ex.t);
356                     ex = ex.pair.next;
357                 } while (ex != e);
358                 throw new Error("unable to find free incident to " + this);
359             }
360             return ret;
361         }
362
363         public E getFreeIncident(E start, E before) {
364             E e = start;
365             do {
366                 if (e.pair.p2 == this && e.pair.t == null && e.pair.next.t == null) return e.pair;
367                 e = e.pair.next;
368             } while(e != before);
369             return null;
370         }
371
372         public E getE(Point p2) {
373             Vertex v = vertices.get(p2);
374             if (v==null) return null;
375             return getE(v);
376         }
377         public E getE(Vertex p2) {
378             E e = this.e;
379             do {
380                 if (e==null) return null;
381                 if (e.p1 == this && e.p2 == p2) return e;
382                 e = e.pair.next;
383             } while (e!=this.e);
384             return null;
385         }
386
387         public Vec norm() {
388             Vec norm = new Vec(0, 0, 0);
389             E e = this.e;
390             do {
391                 if (e.t != null) norm = norm.plus(e.t.norm().times((float)e.prev.angle()));
392                 e = e.pair.next;
393             } while(e != this.e);
394             return norm.norm();
395         }
396
397         public boolean isBoundTo(Vertex p) {
398             Vertex px = p;
399             do {
400                 if (px==this) return true;
401                 px = px.bound_to;
402             } while(px != p);
403             return false;
404         }
405         public void unbind() { bound_to = this; binding = Matrix.ONE; }
406         public void bind(Vertex p) { bind(p, Matrix.ONE); }
407         public void bind(Vertex p, Matrix binding) {
408             if (isBoundTo(p)) return;
409             Vertex temp_bound_to = p.bound_to;
410             Matrix temp_binding = p.binding;
411             p.bound_to = this.bound_to;
412             p.binding = binding.times(this.binding); // FIXME: may have order wrong here
413             this.bound_to = temp_bound_to;
414             this.binding = temp_binding.times(temp_binding); // FIXME: may have order wrong here
415         }
416     }
417
418     public class BindingGroup {
419         private HashSet<E> set = new HashSet<E>();
420         public BindingGroup bind_others;
421         public BindingGroup other() { return bind_others; }
422         public BindingGroup(BindingGroup bind_others) { this.bind_others = bind_others; }
423         public BindingGroup() { this.bind_others = new BindingGroup(this); }
424         public BindingGroup(E e) { this(); set.add(e); }
425         public void add(E e) {
426             if (set.contains(e)) return;
427             set.add(e);
428             BindingGroup e_bind_peers = e.bind_peers;
429             BindingGroup e_bind_to    = e.bind_to;
430             e.bind_peers = this;
431             e.bind_to    = bind_others;
432             for (E epeer  : e_bind_peers.set) add(epeer);
433             for (E eother : e_bind_to.set)    bind_others.add(eother);
434
435             for(E eother : bind_others.set) {
436                 if (e.next.bind_to.set.contains(eother.prev)) {
437                     e.next.next.bindEdge(eother.prev.prev);
438                 }
439                 if (e.prev.bind_to.set.contains(eother.next)) {
440                     e.prev.prev.bindEdge(eother.next.next);
441                 }
442             }
443
444         }
445         public void dobind(E e) {
446             for(E ebound : set) {
447                 e.p1.bind(ebound.p2);
448                 e.p2.bind(ebound.p1);
449             }
450         }
451         public void shatter(BindingGroup bg1, BindingGroup bg2) {
452             for(E e : set) {
453                 e.shatter(e.midpoint(), bg1, bg2);
454             }
455         }
456     }
457
458     /** [UNIQUE] an edge */
459     public final class E implements Comparable<E> {
460
461         public final Vertex p1, p2;
462         T t;     // triangle to our "left"
463         E prev;  // previous half-edge
464         E next;  // next half-edge
465         E pair;  // partner half-edge
466         public BindingGroup bind_peers  = new BindingGroup(this);
467         public BindingGroup bind_to     = bind_peers.other();
468         boolean shattered = false;
469
470         public boolean intersects(T t) { return t.intersects(p1.p, p2.p); }
471         public float comparator() {
472             Vertex nearest = score_against.nearest(midpoint());
473             //if (t==null) return length();
474             /*
475               double ang = Math.abs(crossAngle());
476               float minangle = (float)(Math.PI * 0.9);
477               if (ang > minangle)
478               return 300;
479             */
480             /*
481               if ((length() * length()) / t.area() > 10)
482               return (float)(length()*Math.sqrt(t.area()));
483               return length()*t.area();
484             */
485             return (float)Math.max(length(), midpoint().distance(nearest.p));
486             //return length();
487         }
488         public int compareTo(E e) {
489             return e.comparator() > comparator() ? 1 : -1;
490         }
491         public void bindEdge(E e) { bind_to.add(e); }
492         public void dobind() { bind_to.dobind(this); }
493
494         public Point shatter() { return shatter(midpoint(), null, null); }
495         public Point shatter(Point mid, BindingGroup bg1, BindingGroup bg2) {
496             if (shattered || destroyed) return mid;
497             shattered = true;
498
499             Vertex r = next.p2;
500             E next = this.next;
501             E prev = this.prev;
502
503             int old_colorclass = t==null ? 0 : t.colorclass;
504             if (bg1==null) bg1 = new BindingGroup();
505             if (bg2==null) bg2 = new BindingGroup();
506             BindingGroup old_bind_to = bind_to;
507             bind_peers.shatter(bg1, bg2);
508             old_bind_to.shatter(bg2.other(), bg1.other());
509             pair.shatter();
510             destroy();
511
512             newT(r.p, p1.p, mid, null, old_colorclass);
513             newT(r.p, mid, p2.p, null, old_colorclass);
514             bg1.add(p1.getE(mid));
515             bg2.add(p2.getE(mid).pair);
516             return mid;
517         }
518
519         public boolean destroyed = false;
520         public void destroy() {
521             if (destroyed) return;
522             destroyed = true;
523             pair.destroyed = true;
524
525             if (t != null) t.destroy();
526             t = null;
527
528             if (pair.t != null) pair.t.destroy();
529             pair.t = null;
530
531             if (next.t != null) next.t.destroy();
532             if (prev.t != null) prev.t.destroy();
533             next.t = null;
534             prev.t = null;
535
536             if (pair.next.t != null) pair.next.t.destroy();
537             if (pair.prev.t != null) pair.next.t.destroy();
538             pair.next.t = null;
539             pair.prev.t = null;
540
541             this.bind_to = null;
542             pair.bind_to = null;
543             this.bind_peers = null;
544             pair.bind_peers = null;
545             pair.prev.next = next;
546             next.prev = pair.prev;
547             prev.next = pair.next;
548             pair.next = prev;
549             if (p1.e == this) p1.e = prev.next;
550             if (pair.p1.e == pair) pair.p1.e = pair.prev.next;
551         }
552
553         private void sync() {
554             this.prev.next = this;
555             this.next.prev = this;
556             this.pair.pair = this;
557             bind_peers.add(this);
558             if (this.next.p1 != p2) throw new Error();
559             if (this.prev.p2 != p1) throw new Error();
560             if (this.p1.e == null) this.p1.e = this;
561             if (!added) added = true;
562         }
563         private boolean added = false;
564
565         public T makeT(int colorclass) { return t==null ? (t = new T(this, colorclass)) : t; }
566
567         public double crossAngle() {
568             Vec v1 = t.norm().times(-1);
569             Vec v2 = pair.t.norm().times(-1);
570             return Math.acos(v1.norm().dot(v2.norm()));
571         }
572
573         /** angle between this half-edge and the next */
574         public double angle() {
575             Vec v1 = next.p2.p.minus(p2.p);
576             Vec v2 = this.p1.p.minus(p2.p);
577             return Math.acos(v1.norm().dot(v2.norm()));
578         }
579
580         public void makeAdjacent(E e) {
581             if (this.next == e) return;
582             if (p2 != e.p1) throw new Error("cannot make adjacent -- no shared vertex");
583             if (t != null || e.t != null) throw new Error("cannot make adjacent -- edges not both free");
584
585             E freeIncident = p2.getFreeIncident(e, this);
586
587             e.prev.next = freeIncident.next;
588             freeIncident.next.prev = e.prev;
589
590             freeIncident.next = this.next;
591             this.next.prev = freeIncident;
592             
593             this.next = e;
594             e.prev = this;
595
596             sync();
597             freeIncident.sync();
598         }
599
600         /** creates an isolated edge out in the middle of space */
601         public E(Point p1, Point p2) {
602             if (vertices.get(p1) != null) throw new Error();
603             if (vertices.get(p2) != null) throw new Error();
604             this.p1 = new Vertex(p1);
605             this.p2 = new Vertex(p2);
606             this.prev = this.next = this.pair = new E(this, this, this);
607             this.p1.e = this;
608             this.p2.e = this.pair;
609             sync();
610         }
611
612         /** adds a new half-edge from prev.p2 to p2 */
613         public E(E prev, Point p) {
614             Vertex p2;
615             p2 = vertices.get(p);
616             if (p2 == null) p2 = new Vertex(p);
617             this.p1 = prev.p2;
618             this.p2 = p2;
619             this.prev = prev;
620             if (p2.getE(p1) != null) throw new Error();
621             if (p2.e==null) {
622                 this.next = this.pair = new E(this, this, prev.next);
623             } else {
624                 E q = p2.getFreeIncident();
625                 this.next = q.next;
626                 this.next.prev = this;
627                 E z = prev.next;
628                 this.prev.next = this;
629                 this.pair = new E(q, this, z);
630             }
631             if (p2.e==null) p2.e = this.pair;
632             sync();
633         }
634
635         /** adds a new half-edge to the mesh with a given predecessor, successor, and pair */
636         public E(E prev, E pair, E next) {
637             this.p1 = prev.p2;
638             this.p2 = next.p1;
639             this.prev = prev;
640             this.next = next;
641             this.pair = pair;
642             sync();
643         }
644         public Point midpoint() { return new Point((p1.p.x+p2.p.x)/2, (p1.p.y+p2.p.y)/2, (p1.p.z+p2.p.z)/2); }
645         public boolean has(Vertex v) { return v==p1 || v==p2; }
646         public float length() { return p1.p.minus(p2.p).mag(); }
647         public String toString() { return p1+"->"+p2; }
648
649     }
650
651     public E makeE(Point p1, Point p2) {
652         Vertex v1 = vertices.get(p1);
653         Vertex v2 = vertices.get(p2);
654         if (v1 != null && v2 != null) {
655             E e = v1.getE(v2);
656             if (e != null) return e;
657             e = v2.getE(v1);
658             if (e != null) return e;
659         }
660         if (v1 != null) return new E(v1.getFreeIncident(), p2);
661         if (v2 != null) return new E(v2.getFreeIncident(), p1).pair;
662         return new E(p1, p2);
663     }
664     public T newT(Point p1, Point p2, Point p3, Vec norm, int colorclass) {
665         if (norm != null) {
666             Vec norm2 = p3.minus(p1).cross(p2.minus(p1));
667             float dot = norm.dot(norm2);
668             //if (Math.abs(dot) < EPointSILON) throw new Error("dot products within evertsilon of each other: "+norm+" "+norm2);
669             if (dot < 0) { Point p = p1; p1=p2; p2 = p; }
670         }
671         E e12 = makeE(p1, p2);
672         E e23 = makeE(p2, p3);
673         E e31 = makeE(p3, p1);
674         while(e12.next != e23 || e23.next != e31 || e31.next != e12) {
675             e12.makeAdjacent(e23);
676             e23.makeAdjacent(e31);
677             e31.makeAdjacent(e12);
678         }
679         T ret = e12.makeT(colorclass);
680         if (e12.t == null) throw new Error();
681         if (e23.t == null) throw new Error();
682         if (e31.t == null) throw new Error();
683         return ret;
684     }
685
686
687     /** [UNIQUE] a triangle (face) */
688     public final class T extends Triangle {
689         public final E e1;
690         public final int color;
691         public final int colorclass;
692
693         public void removeFromRTree() { triangles.remove(this); }
694         public void addToRTree() { triangles.insert(this); }
695
696         public void destroy() { triangles.remove(this); }
697
698         T(E e1, int colorclass) {
699             this.e1 = e1;
700             E e2 = e1.next;
701             E e3 = e2.next;
702             if (e1==e2 || e1==e3) throw new Error();
703             if (e3.next!=e1) throw new Error();
704             if (e1.t!=null || e2.t!=null || e3.t!=null) throw new Error("non-manifold surface or disagreeing normals");
705             e1.t = this;
706             e1.next.t = this;
707             e1.next.next.t = this;
708
709             // FIXME: check for sealed/watertight surface once construction is complete (and infer normal(s)?)
710
711             int color = Math.abs(random.nextInt());
712             while(true) {
713                 color = color % 4;
714                 if (e1().pair.t != null && color == e1().pair.t.color) { color++; continue; }
715                 if (e2().pair.t != null && color == e2().pair.t.color) { color++; continue; }
716                 if (e3().pair.t != null && color == e3().pair.t.color) { color++; continue; }
717                 break;
718             }
719             this.color = color;
720             this.colorclass = colorclass;
721             triangles.add(this);
722         }
723         public E e1() { return e1; }
724         public E e2() { return e1.next; }
725         public E e3() { return e1.prev; }
726         public Vertex v1() { return e1.p1; }
727         public Vertex v2() { return e1.p2; }
728         public Vertex v3() { return e1.next.p2; }
729         public Point p1() { return e1.p1.p; }
730         public Point p2() { return e1.p2.p; }
731         public Point p3() { return e1.next.p2.p; }
732         public boolean hasE(E e) { return e1==e || e1.next==e || e1.prev==e; }
733         public boolean has(Vertex v) { return v1()==v || v2()==v || v3()==v; }
734
735         public boolean shouldBeDrawn() {
736             if (e1().bind_to.set.size() == 0) return false;
737             if (e2().bind_to.set.size() == 0) return false;
738             if (e3().bind_to.set.size() == 0) return false;
739             return true;
740         }
741
742     }
743 }