BMesh: add ability not to delete vertex when collapsing
[blender.git] / source / blender / bmesh / intern / bmesh_mods.h
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  * Contributor(s): Joseph Eagar.
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 #ifndef __BMESH_MODS_H__
24 #define __BMESH_MODS_H__
25
26 /** \file blender/bmesh/intern/bmesh_mods.h
27  *  \ingroup bmesh
28  */
29
30 #include <stdio.h>
31
32 bool BM_vert_dissolve(BMesh *bm, BMVert *v);
33
34 bool BM_disk_dissolve(BMesh *bm, BMVert *v);
35
36 BMFace *BM_faces_join_pair(BMesh *bm, BMFace *f1, BMFace *f2, BMEdge *e, const bool do_del);
37
38 BMFace *BM_face_split(BMesh *bm, BMFace *f,
39                       BMLoop *l_a, BMLoop *l_b,
40                       BMLoop **r_l,
41                       BMEdge *example, const bool no_double);
42
43 BMFace *BM_face_split_n(BMesh *bm, BMFace *f,
44                         BMLoop *l_a, BMLoop *l_b,
45                         float cos[][3], int n,
46                         BMLoop **r_l, BMEdge *example);
47
48 BMEdge *BM_vert_collapse_faces(BMesh *bm, BMEdge *e_kill, BMVert *v_kill, float fac,
49                                const bool do_del, const bool join_faces, const bool kill_degenerate_faces);
50 BMEdge *BM_vert_collapse_edge(BMesh *bm, BMEdge *e_kill, BMVert *v_kill,
51                               const bool do_del, const bool kill_degenerate_faces);
52
53
54 BMVert *BM_edge_split(BMesh *bm, BMEdge *e, BMVert *v, BMEdge **r_e, float percent);
55
56 BMVert *BM_edge_split_n(BMesh *bm, BMEdge *e, int numcuts, BMVert **r_varr);
57
58 bool    BM_face_validate(BMFace *face, FILE *err);
59
60 void    BM_edge_calc_rotate(BMEdge *e, const bool ccw,
61                             BMLoop **r_l1, BMLoop **r_l2);
62 bool    BM_edge_rotate_check(BMEdge *e);
63 bool    BM_edge_rotate_check_degenerate(BMEdge *e,
64                                         BMLoop *l1, BMLoop *l2);
65 bool    BM_edge_rotate_check_beauty(BMEdge *e,
66                                     BMLoop *l1, BMLoop *l2);
67 BMEdge *BM_edge_rotate(BMesh *bm, BMEdge *e, const bool ccw, const short check_flag);
68
69 /* flags for BM_edge_rotate */
70 enum {
71         BM_EDGEROT_CHECK_EXISTS     = (1 << 0), /* disallow to rotate when the new edge matches an existing one */
72         BM_EDGEROT_CHECK_SPLICE     = (1 << 1), /* overrides existing check, if the edge already, rotate and merge them */
73         BM_EDGEROT_CHECK_DEGENERATE = (1 << 2), /* disallow creating bow-tie, concave or zero area faces */
74         BM_EDGEROT_CHECK_BEAUTY     = (1 << 3)  /* disallow to rotate into ugly topology */
75 };
76
77
78 BMVert *BM_face_vert_separate(BMesh *bm, BMFace *sf, BMVert *sv);
79 BMVert *BM_face_loop_separate(BMesh *bm, BMLoop *sl);
80
81 #endif /* __BMESH_MODS_H__ */