style cleanup: editors / mesh & object
[blender-staging.git] / source / blender / editors / mesh / editmesh_rip.c
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2004 by Blender Foundation.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Joseph Eagar
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file blender/editors/mesh/editmesh_rip.c
29  *  \ingroup edmesh
30  */
31
32 #include "MEM_guardedalloc.h"
33
34 #include "DNA_scene_types.h"
35 #include "DNA_object_types.h"
36
37 #include "RNA_define.h"
38 #include "RNA_access.h"
39
40 #include "BLI_math.h"
41 #include "BLI_array.h"
42
43 #include "BKE_context.h"
44 #include "BKE_object.h"
45 #include "BKE_report.h"
46 #include "BKE_tessmesh.h"
47
48 #include "WM_api.h"
49 #include "WM_types.h"
50
51 #include "ED_mesh.h"
52 #include "ED_screen.h"
53 #include "ED_transform.h"
54 #include "ED_view3d.h"
55
56 #include "mesh_intern.h"
57
58 /* helper to find edge for edge_rip */
59 static float edbm_rip_rip_edgedist(ARegion *ar, float mat[][4],
60                                    const float co1[3], const float co2[2], const float mvalf[2])
61 {
62         float vec1[3], vec2[3];
63
64         ED_view3d_project_float_v2(ar, co1, vec1, mat);
65         ED_view3d_project_float_v2(ar, co2, vec2, mat);
66
67         return dist_to_line_segment_v2(mvalf, vec1, vec2);
68 }
69
70 static float edbm_rip_edge_side_measure(BMEdge *e, BMLoop *e_l,
71                                         ARegion *ar,
72                                         float projectMat[4][4], const float fmval[2])
73 {
74         float cent[3] = {0, 0, 0}, mid[3];
75
76         float vec[2];
77         float fmval_tweak[2];
78         float e_v1_co[2], e_v2_co[2];
79         float score;
80
81         BMVert *v1_other;
82         BMVert *v2_other;
83
84         BLI_assert(BM_vert_in_edge(e, e_l->v));
85
86         /* method for calculating distance:
87          *
88          * for each edge: calculate face center, then made a vector
89          * from edge midpoint to face center.  offset edge midpoint
90          * by a small amount along this vector. */
91
92         /* rather then the face center, get the middle of
93          * both edge verts connected to this one */
94         v1_other = BM_face_other_vert_loop(e_l->f, e->v2, e->v1)->v;
95         v2_other = BM_face_other_vert_loop(e_l->f, e->v1, e->v2)->v;
96         mid_v3_v3v3(cent, v1_other->co, v2_other->co);
97         mid_v3_v3v3(mid, e->v1->co, e->v2->co);
98
99         ED_view3d_project_float_v2(ar, cent, cent, projectMat);
100         ED_view3d_project_float_v2(ar, mid, mid, projectMat);
101
102         ED_view3d_project_float_v2(ar, e->v1->co, e_v1_co, projectMat);
103         ED_view3d_project_float_v2(ar, e->v2->co, e_v2_co, projectMat);
104
105         sub_v2_v2v2(vec, cent, mid);
106         normalize_v2(vec);
107         mul_v2_fl(vec, 0.01f);
108
109         /* rather then adding to both verts, subtract from the mouse */
110         sub_v2_v2v2(fmval_tweak, fmval, vec);
111
112         score = len_v2v2(e_v1_co, e_v2_co);
113
114         if (dist_to_line_segment_v2(fmval_tweak, e_v1_co, e_v2_co) >
115             dist_to_line_segment_v2(fmval,       e_v1_co, e_v2_co))
116         {
117                 return score;
118         }
119         else {
120                 return -score;
121         }
122 }
123
124
125 /* - Advanced selection handling 'ripsel' functions ----- */
126
127 /**
128  * How rip selection works
129  *
130  * Firstly - rip is basically edge split with side-selection & grab.
131  * Things would be much more simple if we didn't have to worry about side selection
132  *
133  * The method used for checking the side of selection is as follows...
134  * - First tag all rip-able edges.
135  * - Build a contiguous edge list by looping over tagged edges and following each ones tagged siblings in both
136  *   directions.
137  *   - The loops are not stored in an array, Instead both loops on either side of each edge has its index values set
138  *     to count down from the last edge, this way, once we have the 'last' edge its very easy to walk down the
139  *     connected edge loops.
140  *     The reason for using loops like this is because when the edges are split we don't which face user gets the newly
141  *     created edge (its as good as random so we cant assume new edges will be on once side).
142  *     After splittingm, its very simple to walk along boundary loops since each only has one edge from a single side.
143  * - The end loop pairs are stored in an array however to support multiple edge-selection-islands, so you can rip
144  *   multiple selections at once.
145  * - * Execute the split *
146  * - For each #EdgeLoopPair walk down both sides of the split using the loops and measure which is facing the mouse.
147  * - Deselect the edge loop facing away.
148  *
149  * Limitation!
150  * This currently works very poorly with intersecting edge islands (verts with more then 2 tagged edges)
151  * This is nice to but for now not essential.
152  *
153  * - campbell.
154  */
155
156
157 #define IS_VISIT_POSSIBLE(e)   (BM_edge_is_manifold(e) && BM_elem_flag_test(e, BM_ELEM_TAG))
158 #define IS_VISIT_DONE(e) ((e)->l && (BM_elem_index_get((e)->l) != INVALID_UID))
159 #define INVALID_UID INT_MIN
160
161 /* mark, assign uid and step */
162 static BMEdge *edbm_ripsel_edge_mark_step(BMVert *v, const int uid)
163 {
164         BMIter iter;
165         BMEdge *e;
166         BM_ITER_ELEM (e, &iter, v, BM_EDGES_OF_VERT) {
167                 if (IS_VISIT_POSSIBLE(e) && !IS_VISIT_DONE(e)) {
168                         BMLoop *l_a, *l_b;
169
170                         BM_edge_loop_pair(e, &l_a, &l_b); /* no need to check, we know this will be true */
171
172                         /* so (IS_VISIT_DONE == TRUE) */
173                         BM_elem_index_set(l_a, uid);
174                         BM_elem_index_set(l_b, uid);
175
176                         return e;
177                 }
178         }
179         return NULL;
180 }
181
182 typedef struct EdgeLoopPair {
183         BMLoop *l_a;
184         BMLoop *l_b;
185 } EdgeLoopPair;
186
187 static EdgeLoopPair *edbm_ripsel_looptag_helper(BMesh *bm)
188 {
189         BMIter fiter;
190         BMIter liter;
191
192         BMFace *f;
193         BMLoop *l;
194
195         int uid_start;
196         int uid_end;
197         int uid = bm->totedge; /* can start anywhere */
198
199         EdgeLoopPair *eloop_pairs = NULL;
200         BLI_array_declare(eloop_pairs);
201         EdgeLoopPair *lp;
202
203         /* initialize loops with dummy invalid index values */
204         BM_ITER_MESH (f, &fiter, bm, BM_FACES_OF_MESH) {
205                 BM_ITER_ELEM (l, &liter, f, BM_LOOPS_OF_FACE) {
206                         BM_elem_index_set(l, INVALID_UID);
207                 }
208         }
209
210         /* set contiguous loops ordered 'uid' values for walking after split */
211         while (TRUE) {
212                 int tot = 0;
213                 BMIter eiter;
214                 BMEdge *e_step;
215                 BMVert *v_step;
216                 BMEdge *e;
217                 BMEdge *e_first;
218                 BMEdge *e_last;
219
220                 e_first = NULL;
221                 BM_ITER_MESH (e, &eiter, bm, BM_EDGES_OF_MESH) {
222                         if (IS_VISIT_POSSIBLE(e) && !IS_VISIT_DONE(e)) {
223                                 e_first = e;
224                                 break;
225                         }
226                 }
227
228                 if (e_first == NULL) {
229                         break;
230                 }
231
232                 /* initialize  */
233                 e_first = e;
234                 v_step = e_first->v1;
235                 e_step = NULL; /* quiet warning, will never remain this value */
236
237                 uid_start = uid;
238                 while ((e = edbm_ripsel_edge_mark_step(v_step, uid))) {
239                         BM_elem_flag_disable(e, BM_ELEM_SMOOTH);
240                         v_step = BM_edge_other_vert((e_step = e), v_step);
241                         uid++; /* only different line */
242                         tot++;
243                 }
244
245                 /* this edges loops have the highest uid's, store this to walk down later */
246                 e_last = e_step;
247
248                 /* always store the highest 'uid' edge for the stride */
249                 uid_end = uid - 1;
250                 uid = uid_start - 1;
251
252                 /* initialize */
253                 v_step = e_first->v1;
254
255                 while ((e = edbm_ripsel_edge_mark_step(v_step, uid))) {
256                         BM_elem_flag_disable(e, BM_ELEM_SMOOTH);
257                         v_step = BM_edge_other_vert((e_step = e), v_step);
258                         uid--; /* only different line */
259                         tot++;
260                 }
261
262                 /* stride far enough not to _ever_ overlap range */
263                 uid_start = uid;
264                 uid = uid_end + bm->totedge;
265
266                 BLI_array_grow_one(eloop_pairs);
267                 lp = &eloop_pairs[BLI_array_count(eloop_pairs) - 1];
268                 BM_edge_loop_pair(e_last, &lp->l_a, &lp->l_b); /* no need to check, we know this will be true */
269
270
271                 BLI_assert(tot == uid_end - uid_start);
272
273 #if 0
274                 printf("%s: found contiguous edge loop of (%d)\n", __func__, uid_end - uid_start);
275 #endif
276
277         }
278
279         /* null terminate */
280         BLI_array_grow_one(eloop_pairs);
281         lp = &eloop_pairs[BLI_array_count(eloop_pairs) - 1];
282         lp->l_a = lp->l_b = NULL;
283
284         return eloop_pairs;
285 }
286
287
288 /* - De-Select the worst rip-edge side -------------------------------- */
289
290
291 static BMEdge *edbm_ripsel_edge_uid_step(BMEdge *e_orig, BMVert **v_prev)
292 {
293         BMIter eiter;
294         BMEdge *e;
295         BMVert *v = BM_edge_other_vert(e_orig, *v_prev);
296         const int uid_cmp = BM_elem_index_get(e_orig->l) - 1;
297
298         BM_ITER_ELEM (e, &eiter, v, BM_EDGES_OF_VERT) {
299                 if (BM_elem_index_get(e->l) == uid_cmp) {
300                         *v_prev = v;
301                         return e;
302                 }
303         }
304         return NULL;
305 }
306
307 static BMVert *edbm_ripsel_edloop_pair_start_vert(BMEdge *e)
308 {
309         /* try step in a direction, if it fails we know do go the other way */
310         BMVert *v_test = e->v1;
311         return (edbm_ripsel_edge_uid_step(e, &v_test)) ? e->v1 : e->v2;
312 }
313
314 static void edbm_ripsel_deselect_helper(BMesh *bm, EdgeLoopPair *eloop_pairs,
315                                         ARegion *ar, float projectMat[4][4], float fmval[2])
316 {
317         EdgeLoopPair *lp;
318
319         for (lp = eloop_pairs; lp->l_a; lp++) {
320                 BMEdge *e;
321                 BMVert *v_prev;
322
323                 float score_a = 0.0f;
324                 float score_b = 0.0f;
325
326                 e = lp->l_a->e;
327                 v_prev = edbm_ripsel_edloop_pair_start_vert(e);
328                 for (; e; e = edbm_ripsel_edge_uid_step(e, &v_prev)) {
329                         score_a += edbm_rip_edge_side_measure(e, e->l, ar, projectMat, fmval);
330                 }
331                 e = lp->l_b->e;
332                 v_prev = edbm_ripsel_edloop_pair_start_vert(e);
333                 for (; e; e = edbm_ripsel_edge_uid_step(e, &v_prev)) {
334                         score_b += edbm_rip_edge_side_measure(e, e->l, ar, projectMat, fmval);
335                 }
336
337                 e = (score_a > score_b) ? lp->l_a->e : lp->l_b->e;
338                 v_prev = edbm_ripsel_edloop_pair_start_vert(e);
339                 for (; e; e = edbm_ripsel_edge_uid_step(e, &v_prev)) {
340                         BM_edge_select_set(bm, e, FALSE);
341                 }
342         }
343 }
344 /* --- end 'ripsel' selection handling code --- */
345
346 static int edbm_rip_call_edgesplit(BMEditMesh *em, wmOperator *op)
347 {
348         BMOperator bmop;
349
350         if (!EDBM_op_init(em, &bmop, op, "edgesplit edges=%he verts=%hv use_verts=%b",
351                           BM_ELEM_TAG, BM_ELEM_SELECT, TRUE)) {
352                 return FALSE;
353         }
354         BMO_op_exec(em->bm, &bmop);
355         if (!EDBM_op_finish(em, &bmop, op, TRUE)) {
356                 return FALSE;
357         }
358
359         return TRUE;
360 }
361
362 /**
363  * This is the main vert ripping function (rip when one vertex is selected)
364  */
365 static int edbm_rip_invoke__vert(bContext *C, wmOperator *op, wmEvent *event)
366 {
367         Object *obedit = CTX_data_edit_object(C);
368         ARegion *ar = CTX_wm_region(C);
369         RegionView3D *rv3d = CTX_wm_region_view3d(C);
370         BMEditMesh *em = BMEdit_FromObject(obedit);
371         BMesh *bm = em->bm;
372         BMIter iter, liter;
373         BMLoop *l;
374         BMEdge *e, *e2;
375         BMVert *v, *ripvert = NULL;
376         const int totvert_orig = bm->totvert;
377         int i;
378         float projectMat[4][4], fmval[3] = {event->mval[0], event->mval[1]};
379         float dist = FLT_MAX;
380         float d;
381
382         BMEditSelection ese;
383         int totboundary_edge = 0;
384
385         ED_view3d_ob_project_mat_get(rv3d, obedit, projectMat);
386
387         /* find selected vert - same some time and check history first */
388         if (BM_select_history_active_get(em->bm, &ese) && ese.htype == BM_VERT) {
389                 v = (BMVert *)ese.ele;
390         }
391         else {
392                 ese.ele = NULL;
393
394                 BM_ITER_MESH (v, &iter, bm, BM_VERTS_OF_MESH) {
395                         if (BM_elem_flag_test(v, BM_ELEM_SELECT))
396                                 break;
397                 }
398         }
399
400         /* this should be impossible, but sanity checks are a good thing */
401         if (!v)
402                 return OPERATOR_CANCELLED;
403
404         e2 = NULL;
405
406         if (v->e) {
407                 /* find closest edge to mouse cursor */
408                 BM_ITER_ELEM (e, &iter, v, BM_EDGES_OF_VERT) {
409                         int is_boundary = BM_edge_is_boundary(e);
410                         /* consider wire as boundary for this purpose,
411                          * otherwise we can't a face away from a wire edge */
412                         totboundary_edge += (is_boundary != 0 || BM_edge_is_wire(e));
413                         if (!BM_elem_flag_test(e, BM_ELEM_HIDDEN)) {
414                                 if (is_boundary == FALSE && BM_edge_is_manifold(e)) {
415                                         d = edbm_rip_rip_edgedist(ar, projectMat, e->v1->co, e->v2->co, fmval);
416                                         if (d < dist) {
417                                                 dist = d;
418                                                 e2 = e;
419                                         }
420                                 }
421                         }
422                 }
423
424         }
425
426         /* should we go ahead with edge rip or do we need to do special case, split off vertex?:
427          * split off vertex if...
428          * - we cant find an edge - this means we are ripping a faces vert that is connected to other
429          *   geometry only at the vertex.
430          * - the boundary edge total is greater then 2,
431          *   in this case edge split _can_ work but we get far nicer results if we use this special case. */
432         if (totboundary_edge > 2) {
433                 BMVert **vout;
434                 int vout_len;
435
436                 BM_vert_select_set(bm, v, FALSE);
437
438                 if (bmesh_vert_separate(bm, v, &vout, &vout_len) == FALSE) {
439                         BKE_report(op->reports, RPT_ERROR, "Error ripping vertex from faces");
440                         return OPERATOR_CANCELLED;
441                 }
442                 else if (vout_len < 2) {
443                         MEM_freeN(vout);
444                         /* set selection back to avoid active-unselected vertex */
445                         BM_vert_select_set(bm, v, TRUE);
446                         /* should never happen */
447                         BKE_report(op->reports, RPT_ERROR, "Error ripping vertex from faces");
448                         return OPERATOR_CANCELLED;
449                 }
450                 else {
451                         int vi_best = 0;
452
453                         if (ese.ele) {
454                                 BM_select_history_remove(em->bm, ese.ele);
455                         }
456
457                         dist = FLT_MAX;
458
459                         for (i = 0; i < vout_len; i++) {
460                                 BM_ITER_ELEM (l, &iter, vout[i], BM_LOOPS_OF_VERT) {
461                                         if (!BM_elem_flag_test(l->f, BM_ELEM_HIDDEN)) {
462                                                 float l_mid_co[3];
463                                                 BM_loop_calc_face_tangent(l, l_mid_co);
464
465                                                 /* scale to average of surrounding edge size, only needs to be approx */
466                                                 mul_v3_fl(l_mid_co, (BM_edge_calc_length(l->e) + BM_edge_calc_length(l->prev->e)) / 2.0f);
467                                                 add_v3_v3(l_mid_co, v->co);
468
469                                                 d = edbm_rip_rip_edgedist(ar, projectMat, v->co, l_mid_co, fmval);
470
471                                                 if (d < dist) {
472                                                         dist = d;
473                                                         vi_best = i;
474                                                 }
475                                         }
476                                 }
477                         }
478
479                         /* select the vert from the best region */
480                         v = vout[vi_best];
481                         BM_vert_select_set(bm, v, TRUE);
482
483                         if (ese.ele) {
484                                 BM_select_history_store(em->bm, v);
485                         }
486
487                         /* splice all others back together */
488                         if (vout_len > 2) {
489
490                                 /* vout[0]  == best
491                                  * vout[1]  == glue
492                                  * vout[2+] == splice with glue
493                                  */
494                                 if (vi_best != 0) {
495                                         SWAP(BMVert *, vout[0], vout[vi_best]);
496                                         vi_best = 0;
497                                 }
498
499                                 for (i = 2; i < vout_len; i++) {
500                                         BM_vert_splice(bm, vout[i], vout[1]);
501                                 }
502                         }
503
504                         MEM_freeN(vout);
505
506                         return OPERATOR_FINISHED;
507                 }
508         }
509
510         if (!e2) {
511                 BKE_report(op->reports, RPT_ERROR, "Selected vertex has no edge/face pairs attached");
512                 return OPERATOR_CANCELLED;
513         }
514
515         /* rip two adjacent edges */
516         if (BM_edge_is_boundary(e2) || BM_vert_face_count(v) == 2) {
517                 l = e2->l;
518                 ripvert = BM_face_vert_separate(bm, l->f, v);
519
520                 BLI_assert(ripvert);
521                 if (!ripvert) {
522                         return OPERATOR_CANCELLED;
523                 }
524         }
525         else if (BM_edge_is_manifold(e2)) {
526                 l = e2->l;
527                 e = BM_face_other_edge_loop(l->f, e2, v)->e;
528                 BM_elem_flag_enable(e, BM_ELEM_TAG);
529
530                 l = e2->l->radial_next;
531                 e = BM_face_other_edge_loop(l->f, e2, v)->e;
532                 BM_elem_flag_enable(e, BM_ELEM_TAG);
533         }
534
535         dist = FLT_MAX;
536
537         if (!edbm_rip_call_edgesplit(em, op)) {
538                 return OPERATOR_CANCELLED;
539         }
540         else {
541                 /* --- select which vert --- */
542                 BMVert *v_best = NULL;
543                 float l_prev_co[3], l_next_co[3], l_corner_co[3];
544                 float scale;
545
546                 dist = FLT_MAX;
547                 BM_ITER_MESH (v, &iter, em->bm, BM_VERTS_OF_MESH) {
548                         if (BM_elem_flag_test(v, BM_ELEM_SELECT)) {
549                                 /* disable by default, re-enable winner at end */
550                                 BM_vert_select_set(bm, v, FALSE);
551
552                                 BM_ITER_ELEM (l, &liter, v, BM_LOOPS_OF_VERT) {
553                                         /* calculate a point in the face, rather then calculate the middle,
554                                          * make a vector pointing between the 2 edges attached to this loop */
555                                         sub_v3_v3v3(l_prev_co, l->prev->v->co, l->v->co);
556                                         sub_v3_v3v3(l_next_co, l->next->v->co, l->v->co);
557
558                                         scale = normalize_v3(l_prev_co) + normalize_v3(l_next_co);
559                                         mul_v3_fl(l_prev_co, scale);
560                                         mul_v3_fl(l_next_co, scale);
561
562                                         add_v3_v3v3(l_corner_co, l_prev_co, l_next_co);
563                                         add_v3_v3(l_corner_co, l->v->co);
564
565                                         d = edbm_rip_rip_edgedist(ar, projectMat, l->v->co, l_corner_co, fmval);
566                                         if (d < dist) {
567                                                 v_best = v;
568                                                 dist = d;
569                                         }
570                                 }
571                         }
572                 }
573
574                 if (v_best) {
575                         BM_vert_select_set(bm, v_best, TRUE);
576                         if (ese.ele) {
577                                 BM_select_history_store(em->bm, v_best);
578                         }
579                 }
580         }
581
582         if (totvert_orig == bm->totvert) {
583                 BKE_report(op->reports, RPT_ERROR, "No vertices could be ripped");
584                 return OPERATOR_CANCELLED;
585         }
586
587         return OPERATOR_FINISHED;
588 }
589
590 /**
591  * This is the main edge ripping function
592  */
593 static int edbm_rip_invoke__edge(bContext *C, wmOperator *op, wmEvent *event)
594 {
595         Object *obedit = CTX_data_edit_object(C);
596         ARegion *ar = CTX_wm_region(C);
597         RegionView3D *rv3d = CTX_wm_region_view3d(C);
598         BMEditMesh *em = BMEdit_FromObject(obedit);
599         BMesh *bm = em->bm;
600         BMIter iter, eiter;
601         BMLoop *l;
602         BMEdge *e, *e2;
603         BMVert *v;
604         const int totedge_orig = bm->totedge;
605         int i;
606         float projectMat[4][4], fmval[3] = {event->mval[0], event->mval[1]};
607
608         int totedge;
609         int all_minifold;
610
611         EdgeLoopPair *eloop_pairs;
612
613         ED_view3d_ob_project_mat_get(rv3d, obedit, projectMat);
614
615         /* important this runs on the original selection, before tempering with tagging */
616         eloop_pairs = edbm_ripsel_looptag_helper(bm);
617
618         /* expand edge selection */
619         BM_ITER_MESH (v, &iter, bm, BM_VERTS_OF_MESH) {
620                 e2 = NULL;
621                 i = 0;
622                 totedge = 0;
623                 all_minifold = TRUE;
624                 BM_ITER_ELEM (e, &eiter, v, BM_EDGES_OF_VERT) {
625
626                         if (!BM_edge_is_wire(e) &&
627                             !BM_elem_flag_test(e, BM_ELEM_HIDDEN))
628                         {
629                                 /* important to check selection rather then tag here
630                                  * else we get feedback loop */
631                                 if (BM_elem_flag_test(e, BM_ELEM_SELECT)) {
632                                         e2 = e;
633                                         i++;
634                                 }
635                                 totedge++;
636                         }
637
638                         /** #BM_vert_other_disk_edge has no hidden checks so don't check hidden here */
639                         if ((all_minifold == TRUE) && (BM_edge_is_manifold(e) == FALSE)) {
640                                 all_minifold = FALSE;
641                         }
642                 }
643
644                 /* single edge, extend */
645                 if (i == 1 && e2->l) {
646                         if ((totedge == 4) || (all_minifold == FALSE)) {
647                                 BMLoop *l_a = e2->l;
648                                 BMLoop *l_b = l_a->radial_next;
649
650                                 /* find the best face to follow, this what the edge won't point away from
651                                  * the mouse when there are more then 4 (takes the shortest face fan around) */
652                                 l = (edbm_rip_edge_side_measure(e2, l_a, ar, projectMat, fmval) <
653                                      edbm_rip_edge_side_measure(e2, l_b, ar, projectMat, fmval)) ? l_a : l_b;
654
655                                 l = BM_face_other_edge_loop(l->f, e2, v);
656                                 /* important edge is manifold else we can be attempting to split off a fan that don't budge,
657                                  * not crashing but adds duplicate edge. */
658                                 if (BM_edge_is_manifold(l->e)) {
659                                         l = l->radial_next;
660                                         l = BM_face_other_edge_loop(l->f, l->e, v);
661
662                                         if (l) {
663                                                 BM_elem_flag_enable(l->e, BM_ELEM_TAG);
664                                         }
665                                 }
666                         }
667                         else {
668                                 e = BM_vert_other_disk_edge(v, e2);
669
670                                 if (e) {
671                                         BM_elem_flag_enable(e, BM_ELEM_TAG);
672                                 }
673                         }
674                 }
675         }
676
677         if (!edbm_rip_call_edgesplit(em, op)) {
678                 return OPERATOR_CANCELLED;
679         }
680
681         /* note: the output of the bmesh operator is ignored, since we built
682          * the contiguous loop pairs to split already, its possible that some
683          * edge did not split even though it was tagged which would not work
684          * as expected (but not crash), however there are checks to ensure
685          * tagged edges will split. So far its not been an issue. */
686         edbm_ripsel_deselect_helper(bm, eloop_pairs,
687                                     ar, projectMat, fmval);
688         MEM_freeN(eloop_pairs);
689
690         if (totedge_orig == bm->totedge) {
691                 BKE_report(op->reports, RPT_ERROR, "No edges could be ripped");
692                 return OPERATOR_CANCELLED;
693         }
694
695         EDBM_selectmode_flush(em);
696
697         return OPERATOR_FINISHED;
698 }
699
700 /* based on mouse cursor position, it defines how is being ripped */
701 static int edbm_rip_invoke(bContext *C, wmOperator *op, wmEvent *event)
702 {
703         Object *obedit = CTX_data_edit_object(C);
704         BMEditMesh *em = BMEdit_FromObject(obedit);
705         BMesh *bm = em->bm;
706         BMIter iter;
707         BMEdge *e;
708         int singlesel = (bm->totvertsel == 1 && bm->totedgesel == 0 && bm->totfacesel == 0);
709         int ret;
710
711         /* running in face mode hardly makes sense, so convert to region loop and rip */
712         if (em->bm->totfacesel) {
713                 /* highly nifty but hard to sypport since the operator can fail and we're left
714                  * with modified selection */
715                 // WM_operator_name_call(C, "MESH_OT_region_to_loop", WM_OP_INVOKE_DEFAULT, NULL);
716
717                 BKE_report(op->reports, RPT_ERROR, "Can't rip selected faces");
718                 return OPERATOR_CANCELLED;
719         }
720
721         /* note on selection:
722          * When calling edge split we operate on tagged edges rather then selected
723          * this is important because the edges to operate on are extended by one,
724          * but the selection is left alone.
725          *
726          * After calling edge split - the duplicated edges have the same selection state as the
727          * original, so all we do is de-select the far side from the mouse and we have a
728          * useful selection for grabbing.
729          */
730
731         /* BM_ELEM_SELECT --> BM_ELEM_TAG */
732         BM_ITER_MESH (e, &iter, em->bm, BM_EDGES_OF_MESH) {
733                 BM_elem_flag_set(e, BM_ELEM_TAG, BM_elem_flag_test(e, BM_ELEM_SELECT));
734         }
735
736         /* split 2 main parts of this operator out into vertex and edge ripping */
737         if (singlesel) {
738                 ret = edbm_rip_invoke__vert(C, op, event);
739         }
740         else {
741                 ret = edbm_rip_invoke__edge(C, op, event);
742         }
743
744         if (ret == OPERATOR_CANCELLED) {
745                 return OPERATOR_CANCELLED;
746         }
747
748         BLI_assert(singlesel ? (bm->totvertsel > 0) : (bm->totedgesel > 0));
749
750         if (bm->totvertsel == 0) {
751                 return OPERATOR_CANCELLED;
752         }
753
754         EDBM_update_generic(C, em, TRUE);
755
756         return OPERATOR_FINISHED;
757 }
758
759
760 void MESH_OT_rip(wmOperatorType *ot)
761 {
762         /* identifiers */
763         ot->name = "Rip";
764         ot->idname = "MESH_OT_rip";
765         ot->description = "Disconnect vertex or edges from connected geometry";
766
767         /* api callbacks */
768         ot->invoke = edbm_rip_invoke;
769         ot->poll = EM_view3d_poll;
770
771         /* flags */
772         ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
773
774         /* to give to transform */
775         Transform_Properties(ot, P_PROPORTIONAL);
776         RNA_def_boolean(ot->srna, "mirror", 0, "Mirror Editing", "");
777 }