Fix T71322: Crash in Audaspace with some video file
[blender.git] / source / blender / bmesh / intern / bmesh_polygon.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 #ifndef __BMESH_POLYGON_H__
18 #define __BMESH_POLYGON_H__
19
20 /** \file
21  * \ingroup bmesh
22  */
23
24 struct Heap;
25
26 #include "BLI_compiler_attrs.h"
27
28 void BM_mesh_calc_tessellation(BMesh *bm, BMLoop *(*looptris)[3], int *r_looptris_tot);
29 void BM_mesh_calc_tessellation_beauty(BMesh *bm, BMLoop *(*looptris)[3], int *r_looptris_tot);
30
31 void BM_face_calc_tessellation(const BMFace *f,
32                                const bool use_fixed_quad,
33                                BMLoop **r_loops,
34                                uint (*r_index)[3]);
35 void BM_face_calc_point_in_face(const BMFace *f, float r_co[3]);
36 float BM_face_calc_normal(const BMFace *f, float r_no[3]) ATTR_NONNULL();
37 float BM_face_calc_normal_vcos(const BMesh *bm,
38                                const BMFace *f,
39                                float r_no[3],
40                                float const (*vertexCos)[3]) ATTR_NONNULL();
41
42 void BM_verts_calc_normal_from_cloud_ex(
43     BMVert **varr, int varr_len, float r_normal[3], float r_center[3], int *r_index_tangent);
44 void BM_verts_calc_normal_from_cloud(BMVert **varr, int varr_len, float r_normal[3]);
45
46 float BM_face_calc_normal_subset(const BMLoop *l_first, const BMLoop *l_last, float r_no[3])
47     ATTR_NONNULL();
48 float BM_face_calc_area(const BMFace *f) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
49 float BM_face_calc_area_with_mat3(const BMFace *f, const float mat3[3][3]) ATTR_WARN_UNUSED_RESULT
50     ATTR_NONNULL();
51 float BM_face_calc_area_uv(const BMFace *f, int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT
52     ATTR_NONNULL();
53 float BM_face_calc_perimeter(const BMFace *f) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
54 float BM_face_calc_perimeter_with_mat3(const BMFace *f,
55                                        const float mat3[3][3]) ATTR_WARN_UNUSED_RESULT
56     ATTR_NONNULL();
57 void BM_face_calc_tangent_edge(const BMFace *f, float r_plane[3]) ATTR_NONNULL();
58 void BM_face_calc_tangent_edge_pair(const BMFace *f, float r_plane[3]) ATTR_NONNULL();
59 void BM_face_calc_tangent_edge_diagonal(const BMFace *f, float r_plane[3]) ATTR_NONNULL();
60 void BM_face_calc_tangent_vert_diagonal(const BMFace *f, float r_plane[3]) ATTR_NONNULL();
61 void BM_face_calc_tangent_auto(const BMFace *f, float r_plane[3]) ATTR_NONNULL();
62 void BM_face_calc_center_bounds(const BMFace *f, float center[3]) ATTR_NONNULL();
63 void BM_face_calc_center_median(const BMFace *f, float center[3]) ATTR_NONNULL();
64 void BM_face_calc_center_median_vcos(const BMesh *bm,
65                                      const BMFace *f,
66                                      float r_cent[3],
67                                      float const (*vertexCos)[3]) ATTR_NONNULL();
68 void BM_face_calc_center_median_weighted(const BMFace *f, float center[3]) ATTR_NONNULL();
69
70 void BM_face_calc_bounds_expand(const BMFace *f, float min[3], float max[3]);
71
72 void BM_face_normal_update(BMFace *f) ATTR_NONNULL();
73
74 void BM_edge_normals_update(BMEdge *e) ATTR_NONNULL();
75
76 bool BM_vert_calc_normal_ex(const BMVert *v, const char hflag, float r_no[3]);
77 bool BM_vert_calc_normal(const BMVert *v, float r_no[3]);
78 void BM_vert_normal_update(BMVert *v) ATTR_NONNULL();
79 void BM_vert_normal_update_all(BMVert *v) ATTR_NONNULL();
80
81 void BM_face_normal_flip_ex(BMesh *bm,
82                             BMFace *f,
83                             const int cd_loop_mdisp_offset,
84                             const bool use_loop_mdisp_flip) ATTR_NONNULL();
85 void BM_face_normal_flip(BMesh *bm, BMFace *f) ATTR_NONNULL();
86 bool BM_face_point_inside_test(const BMFace *f, const float co[3]) ATTR_WARN_UNUSED_RESULT
87     ATTR_NONNULL();
88
89 void BM_face_triangulate(BMesh *bm,
90                          BMFace *f,
91                          BMFace **r_faces_new,
92                          int *r_faces_new_tot,
93                          BMEdge **r_edges_new,
94                          int *r_edges_new_tot,
95                          struct LinkNode **r_faces_double,
96                          const int quad_method,
97                          const int ngon_method,
98                          const bool use_tag,
99                          struct MemArena *pf_arena,
100                          struct Heap *pf_heap) ATTR_NONNULL(1, 2);
101
102 void BM_face_splits_check_legal(BMesh *bm, BMFace *f, BMLoop *(*loops)[2], int len) ATTR_NONNULL();
103 void BM_face_splits_check_optimal(BMFace *f, BMLoop *(*loops)[2], int len) ATTR_NONNULL();
104
105 void BM_face_as_array_vert_tri(BMFace *f, BMVert *r_verts[3]) ATTR_NONNULL();
106 void BM_face_as_array_vert_quad(BMFace *f, BMVert *r_verts[4]) ATTR_NONNULL();
107
108 void BM_face_as_array_loop_tri(BMFace *f, BMLoop *r_loops[3]) ATTR_NONNULL();
109 void BM_face_as_array_loop_quad(BMFace *f, BMLoop *r_loops[4]) ATTR_NONNULL();
110
111 void BM_vert_tri_calc_tangent_edge(BMVert *verts[3], float r_tangent[3]);
112 void BM_vert_tri_calc_tangent_edge_pair(BMVert *verts[3], float r_tangent[3]);
113
114 #endif /* __BMESH_POLYGON_H__ */