diff options
Diffstat (limited to 'source/blender/bmesh/intern/bmesh_interp.h')
-rw-r--r-- | source/blender/bmesh/intern/bmesh_interp.h | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/source/blender/bmesh/intern/bmesh_interp.h b/source/blender/bmesh/intern/bmesh_interp.h index c77281bd798..d1a73509a4a 100644 --- a/source/blender/bmesh/intern/bmesh_interp.h +++ b/source/blender/bmesh/intern/bmesh_interp.h @@ -29,6 +29,9 @@ void BM_loop_interp_multires_ex(BMesh *bm, const float f_dst_center[3], const float f_src_center[3], const int cd_loop_mdisp_offset); +/** + * Project the multi-resolution grid in target onto f_src's set of multi-resolution grids. + */ void BM_loop_interp_multires(BMesh *bm, BMLoop *l_dst, const BMFace *f_src); void BM_face_interp_multires_ex(BMesh *bm, @@ -41,10 +44,30 @@ void BM_face_interp_multires(BMesh *bm, BMFace *f_dst, const BMFace *f_src); void BM_vert_interp_from_face(BMesh *bm, BMVert *v_dst, const BMFace *f_src); +/** + * \brief Data, Interpolate From Verts + * + * Interpolates per-vertex data from two sources to \a v_dst + * + * \note This is an exact match to #BM_data_interp_from_edges. + */ void BM_data_interp_from_verts( BMesh *bm, const BMVert *v_src_1, const BMVert *v_src_2, BMVert *v_dst, const float fac); +/** + * \brief Data, Interpolate From Edges + * + * Interpolates per-edge data from two sources to \a e_dst. + * + * \note This is an exact match to #BM_data_interp_from_verts. + */ void BM_data_interp_from_edges( BMesh *bm, const BMEdge *e_src_1, const BMEdge *e_src_2, BMEdge *e_dst, const float fac); +/** + * \brief Data Face-Vert Edge Interpolate + * + * Walks around the faces of \a e and interpolates + * the loop data between two sources. + */ void BM_data_interp_face_vert_edge(BMesh *bm, const BMVert *v_src_1, const BMVert *v_src_2, @@ -60,6 +83,13 @@ void BM_data_layer_copy(BMesh *bm, CustomData *data, int type, int src_n, int ds float BM_elem_float_data_get(CustomData *cd, void *element, int type); void BM_elem_float_data_set(CustomData *cd, void *element, int type, const float val); +/** + * \brief Data Interpolate From Face + * + * Projects target onto source, and pulls interpolated custom-data from source. + * + * \note Only handles loop custom-data. multi-res is handled. + */ void BM_face_interp_from_face_ex(BMesh *bm, BMFace *f_dst, const BMFace *f_src, @@ -69,14 +99,30 @@ void BM_face_interp_from_face_ex(BMesh *bm, float (*cos_2d)[2], float axis_mat[3][3]); void BM_face_interp_from_face(BMesh *bm, BMFace *f_dst, const BMFace *f_src, const bool do_vertex); +/** + * Projects a single loop, target, onto f_src for custom-data interpolation. + * multi-resolution is handled. + * \param do_vertex: When true the target's vert data will also get interpolated. + */ void BM_loop_interp_from_face( BMesh *bm, BMLoop *l_dst, const BMFace *f_src, const bool do_vertex, const bool do_multires); +/** + * Smooths boundaries between multi-res grids, + * including some borders in adjacent faces. + */ void BM_face_multires_bounds_smooth(BMesh *bm, BMFace *f); struct LinkNode *BM_vert_loop_groups_data_layer_create( BMesh *bm, BMVert *v, const int layer_n, const float *loop_weights, struct MemArena *arena); +/** + * Take existing custom data and merge each fan's data. + */ void BM_vert_loop_groups_data_layer_merge(BMesh *bm, struct LinkNode *groups, const int layer_n); +/** + * A version of #BM_vert_loop_groups_data_layer_merge + * that takes an array of loop-weights (aligned with #BM_LOOPS_OF_VERT iterator). + */ void BM_vert_loop_groups_data_layer_merge_weights(BMesh *bm, struct LinkNode *groups, const int layer_n, |