#include "bmesh_class.h"

Classes
struct	BMeshCreateParams

struct	BMAllocTemplate

Macros
#define	BMALLOC_TEMPLATE_FROM_BM(bm)

#define	_VA_BMALLOC_TEMPLATE_FROM_ME_1(me)

#define	_VA_BMALLOC_TEMPLATE_FROM_ME_2(me_a, me_b)

#define	BMALLOC_TEMPLATE_FROM_ME(...) VA_NARGS_CALL_OVERLOAD(_VA_BMALLOC_TEMPLATE_FROM_ME_, __VA_ARGS__)

Typedefs
typedef struct BMAllocTemplate	BMAllocTemplate

Functions
void	BM_mesh_elem_toolflags_ensure (BMesh *bm)

void	BM_mesh_elem_toolflags_clear (BMesh *bm)

BMesh *	BM_mesh_create (const struct BMAllocTemplate allocsize, const struct BMeshCreateParams params)

void	BM_mesh_free (BMesh *bm)
	BMesh Free Mesh. More...

void	BM_mesh_data_free (BMesh *bm)
	BMesh Free Mesh Data. More...

void	BM_mesh_clear (BMesh *bm)
	BMesh Clear Mesh. More...

void	BM_mesh_normals_update (BMesh *bm)
	BMesh Compute Normals. More...

void	BM_verts_calc_normal_vcos (BMesh bm, const float(fnos)[3], const float(vcos)[3], float(vnos)[3])
	BMesh Compute Normals from/to external data. More...

void	BM_loops_calc_normal_vcos (BMesh bm, const float(vcos)[3], const float(vnos)[3], const float(fnos)[3], const bool use_split_normals, const float split_angle, float(r_lnos)[3], struct MLoopNorSpaceArray r_lnors_spacearr, short(*clnors_data)[2], const int cd_loop_clnors_offset, const bool do_rebuild)
	BMesh Compute Loop Normals from/to external data. More...

bool	BM_loop_check_cyclic_smooth_fan (BMLoop *l_curr)

void	BM_lnorspacearr_store (BMesh bm, float(r_lnors)[3])

void	BM_lnorspace_invalidate (BMesh *bm, const bool do_invalidate_all)

void	BM_lnorspace_rebuild (BMesh *bm, bool preserve_clnor)

void	BM_lnorspace_update (BMesh *bm)

void	BM_normals_loops_edges_tag (BMesh *bm, const bool do_edges)

void	BM_lnorspace_err (BMesh *bm)

struct BMLoopNorEditDataArray *	BM_loop_normal_editdata_array_init (BMesh *bm, const bool do_all_loops_of_vert)

void	BM_loop_normal_editdata_array_free (struct BMLoopNorEditDataArray *lnors_ed_arr)

bool	BM_custom_loop_normals_to_vector_layer (struct BMesh *bm)

void	BM_custom_loop_normals_from_vector_layer (struct BMesh *bm, bool add_sharp_edges)

void	BM_edges_sharp_from_angle_set (BMesh *bm, const float split_angle)

void	bmesh_edit_begin (BMesh *bm, const BMOpTypeFlag type_flag)

void	bmesh_edit_end (BMesh *bm, const BMOpTypeFlag type_flag)
	BMesh End Edit. More...

void	BM_mesh_elem_index_ensure_ex (BMesh *bm, const char htype, int elem_offset[4])

void	BM_mesh_elem_index_ensure (BMesh *bm, const char htype)

void	BM_mesh_elem_index_validate (BMesh bm, const char location, const char func, const char msg_a, const char *msg_b)

void	BM_mesh_toolflags_set (BMesh *bm, bool use_toolflags)

bool	BM_mesh_elem_table_check (BMesh *bm)

void	BM_mesh_elem_table_ensure (BMesh *bm, const char htype)

void	BM_mesh_elem_table_init (BMesh *bm, const char htype)

void	BM_mesh_elem_table_free (BMesh *bm, const char htype)

BLI_INLINE BMVert *	BM_vert_at_index (BMesh *bm, const int index)

BLI_INLINE BMEdge *	BM_edge_at_index (BMesh *bm, const int index)

BLI_INLINE BMFace *	BM_face_at_index (BMesh *bm, const int index)

BMVert *	BM_vert_at_index_find (BMesh *bm, const int index)

BMEdge *	BM_edge_at_index_find (BMesh *bm, const int index)

BMFace *	BM_face_at_index_find (BMesh *bm, const int index)

BMLoop *	BM_loop_at_index_find (BMesh *bm, const int index)

BMVert *	BM_vert_at_index_find_or_table (BMesh *bm, const int index)

BMEdge *	BM_edge_at_index_find_or_table (BMesh *bm, const int index)

BMFace *	BM_face_at_index_find_or_table (BMesh *bm, const int index)

int	BM_mesh_elem_count (BMesh *bm, const char htype)

void	BM_mesh_remap (BMesh bm, const uint vert_idx, const uint edge_idx, const uint face_idx)

void	BM_mesh_rebuild (BMesh bm, const struct BMeshCreateParams params, struct BLI_mempool vpool, struct BLI_mempool epool, struct BLI_mempool lpool, struct BLI_mempool fpool)

void	BM_mesh_vert_coords_get (BMesh bm, float(vert_coords)[3])

float(*	BM_mesh_vert_coords_alloc (BMesh bm, int r_vert_len))[3]

void	BM_mesh_vert_coords_apply (BMesh bm, const float(vert_coords)[3])

void	BM_mesh_vert_coords_apply_with_mat4 (BMesh bm, const float(vert_coords)[3], const float mat[4][4])

Variables
const BMAllocTemplate	bm_mesh_allocsize_default

const BMAllocTemplate	bm_mesh_chunksize_default

Macro Definition Documentation

◆ _VA_BMALLOC_TEMPLATE_FROM_ME_1

#define _VA_BMALLOC_TEMPLATE_FROM_ME_1 ( me )

Value:

  { \
    (CHECK_TYPE_INLINE(me, Mesh *), (me)->totvert), (me)->totedge, (me)->totloop, (me)->totpoly, \
  }

Definition at line 151 of file bmesh_mesh.h.

◆ _VA_BMALLOC_TEMPLATE_FROM_ME_2

#define _VA_BMALLOC_TEMPLATE_FROM_ME_2	(	me_a,
		me_b
	)

Value:

  { \
    (CHECK_TYPE_INLINE(me_a, Mesh *), \
     CHECK_TYPE_INLINE(me_b, Mesh *), \
     (me_a)->totvert + (me_b)->totvert), \
        (me_a)->totedge + (me_b)->totedge, (me_a)->totloop + (me_b)->totloop, \
        (me_a)->totpoly + (me_b)->totpoly, \
  }

Definition at line 155 of file bmesh_mesh.h.

◆ BMALLOC_TEMPLATE_FROM_BM

#define BMALLOC_TEMPLATE_FROM_BM ( bm )

Value:

  { \
    (CHECK_TYPE_INLINE(bm, BMesh *), (bm)->totvert), (bm)->totedge, (bm)->totloop, (bm)->totface \
  }

Definition at line 146 of file bmesh_mesh.h.

◆ BMALLOC_TEMPLATE_FROM_ME

#define BMALLOC_TEMPLATE_FROM_ME ( ... ) VA_NARGS_CALL_OVERLOAD(_VA_BMALLOC_TEMPLATE_FROM_ME_, __VA_ARGS__)

Definition at line 163 of file bmesh_mesh.h.

Typedef Documentation

◆ BMAllocTemplate

typedef struct BMAllocTemplate BMAllocTemplate

Function Documentation

◆ BM_custom_loop_normals_from_vector_layer()

void BM_custom_loop_normals_from_vector_layer	(	struct BMesh *	bm,
		bool	add_sharp_edges
	)

◆ BM_custom_loop_normals_to_vector_layer()

bool BM_custom_loop_normals_to_vector_layer ( BMesh * bm )

Warning: This function sets BM_ELEM_TAG on loops & edges via bm_mesh_loops_calc_normals, take care to run this before setting up tags.

Definition at line 1903 of file bmesh_mesh.c.

References BKE_lnor_space_custom_data_to_normal(), bm, BM_data_layer_add(), BM_ELEM_CD_GET_VOID_P, BM_elem_index_get, BM_FACES_OF_MESH, BM_ITER_ELEM, BM_ITER_MESH, BM_lnorspace_update(), BM_LOOP, BM_LOOPS_OF_FACE, BM_mesh_elem_index_ensure(), CD_CUSTOMLOOPNORMAL, CD_FLAG_TEMPORARY, CD_NORMAL, CustomData_get_offset(), CustomData_has_layer(), CustomData_set_layer_flag(), l, BMesh::ldata, BMesh::lnor_spacearr, MLoopNorSpaceArray::lspacearr, and normal.

Referenced by edbm_connect_vert_pair(), edbm_delete_exec(), edbm_dissolve_edges_exec(), edbm_dissolve_faces_exec(), edbm_dissolve_limited_exec(), edbm_dissolve_verts_exec(), edbm_edge_split_selected_edges(), edbm_edge_split_selected_verts(), edbm_knife_cut_exec(), edbm_merge_exec(), edbm_quads_convert_to_tris_exec(), edbm_remove_doubles_exec(), edbm_rip_invoke(), edbm_split_exec(), edbm_tris_convert_to_quads_exec(), edbm_vert_connect_path_exec(), and mesh_separate_loose().

◆ BM_edge_at_index()

BLI_INLINE BMEdge* BM_edge_at_index	(	BMesh *	bm,
		const int	index
	)

Definition at line 104 of file bmesh_mesh.h.

References BLI_assert, bm, BM_EDGE, BMesh::elem_table_dirty, and BMesh::etable.

Referenced by bm_edgexedge_isect_cb(), bm_edgexvert_isect_cb(), bm_original_edge_get(), cb_bedge_verts_get(), construct_param_handle_subsurfed(), lineart_geometry_object_load(), loopcut_init(), mesh_foreachScreenEdge__mapFunc(), and mesh_foreachScreenEdge_clip_bb_segment__mapFunc().

◆ BM_edge_at_index_find()

BMEdge* BM_edge_at_index_find	(	BMesh *	bm,
		const int	index
	)

Definition at line 2381 of file bmesh_mesh.c.

References BLI_mempool_findelem(), bm, and BMesh::epool.

Referenced by BM_edge_at_index_find_or_table(), and ED_view3d_gizmo_mesh_preselect_get_active().

◆ BM_edge_at_index_find_or_table()

BMEdge* BM_edge_at_index_find_or_table	(	BMesh *	bm,
		const int	index
	)

Definition at line 2425 of file bmesh_mesh.c.

References bm, BM_EDGE, BM_edge_at_index_find(), BMesh::elem_table_dirty, BMesh::etable, and NULL.

Referenced by EDBM_edge_find_nearest_ex(), EDBM_elem_from_index_any(), and edbm_select_id_bm_elem_get().

◆ BM_edges_sharp_from_angle_set()

void BM_edges_sharp_from_angle_set	(	BMesh *	bm,
		const float	split_angle
	)

Define sharp edges as needed to mimic 'autosmooth' from angle threshold.

Used when defining an empty custom loop normals data layer, to keep same shading as with autosmooth!

Definition at line 1382 of file bmesh_mesh.c.

References bm, bm_mesh_edges_sharp_tag(), M_PI, and NULL.

Referenced by bevel_harden_normals(), BKE_editmesh_lnorspace_update(), and mesh_customdata_custom_splitnormals_add_exec().

◆ BM_face_at_index()

BLI_INLINE BMFace* BM_face_at_index	(	BMesh *	bm,
		const int	index
	)

◆ BM_face_at_index_find()

BMFace* BM_face_at_index_find	(	BMesh *	bm,
		const int	index
	)

Definition at line 2386 of file bmesh_mesh.c.

References BLI_mempool_findelem(), bm, and BMesh::fpool.

Referenced by BM_face_at_index_find_or_table(), and ED_view3d_gizmo_mesh_preselect_get_active().

◆ BM_face_at_index_find_or_table()

BMFace* BM_face_at_index_find_or_table	(	BMesh *	bm,
		const int	index
	)

Definition at line 2433 of file bmesh_mesh.c.

References bm, BM_FACE, BM_face_at_index_find(), BMesh::elem_table_dirty, BMesh::ftable, and NULL.

Referenced by EDBM_elem_from_index_any(), EDBM_face_find_nearest_ex(), edbm_select_id_bm_elem_get(), and uv_shortest_path_pick_exec().

◆ BM_lnorspace_err()

void BM_lnorspace_err ( BMesh * bm )

Auxiliary function only used by rebuild to detect if any spaces were not marked as invalid. Reports error if any of the lnor spaces change after rebuilding, meaning that all the possible lnor spaces to be rebuilt were not correctly marked.

Definition at line 1623 of file bmesh_mesh.c.

References BKE_lnor_spacearr_free(), BKE_lnor_spacearr_init(), BLI_assert, bm, BM_loops_calc_normal_vcos(), BM_SPACEARR_DIRTY_ALL, CD_CUSTOMLOOPNORMAL, clear(), compare_ff(), compare_v3v3(), CustomData_get_offset(), float(), BMesh::ldata, BMesh::lnor_spacearr, MLoopNorSpaceArray::lspacearr, M_PI, MEM_callocN, MEM_freeN, MLNOR_SPACEARR_BMLOOP_PTR, NULL, MLoopNorSpace::ref_alpha, MLoopNorSpace::ref_beta, BMesh::spacearr_dirty, BMesh::totloop, MLoopNorSpace::vec_lnor, MLoopNorSpace::vec_ortho, and MLoopNorSpace::vec_ref.

Referenced by BM_lnorspace_rebuild().

◆ BM_lnorspace_invalidate()

void BM_lnorspace_invalidate	(	BMesh *	bm,
		const bool	do_invalidate_all
	)

Definition at line 1418 of file bmesh_mesh.c.

References BLI_BITMAP_ENABLE, BLI_BITMAP_NEW, BLI_BITMAP_TEST, bm, BM_ELEM_API_FLAG_ENABLE, BM_elem_flag_test, BM_elem_index_get, BM_ELEM_SELECT, BM_ITER_ELEM, BM_ITER_MESH, BM_LNORSPACE_UPDATE, BM_LOOPS_OF_VERT, BM_mesh_elem_index_ensure(), BM_SPACEARR_DIRTY, BM_SPACEARR_DIRTY_ALL, BM_VERT, BM_VERTS_OF_MESH, CLEAR_SPACEARRAY_THRESHOLD, l, BMesh::lnor_spacearr, MEM_freeN, BMLoop::next, NULL, BMLoop::prev, BMesh::spacearr_dirty, BMesh::totvert, BMesh::totvertsel, BMLoop::v, and v.

Referenced by EDBM_update_generic(), and initTransform().

◆ BM_lnorspace_rebuild()

void BM_lnorspace_rebuild	(	BMesh *	bm,
		bool	preserve_clnor
	)

◆ BM_lnorspace_update()

void BM_lnorspace_update ( BMesh * bm )

Warning: This function sets BM_ELEM_TAG on loops & edges via bm_mesh_loops_calc_normals, take care to run this before setting up tags.

Definition at line 1565 of file bmesh_mesh.c.

References bm, BM_lnorspace_rebuild(), BM_lnorspacearr_store(), BM_SPACEARR_DIRTY, BM_SPACEARR_DIRTY_ALL, float(), BMesh::lnor_spacearr, MLoopNorSpaceArray::lspacearr, MEM_callocN, MEM_freeN, NULL, BMesh::spacearr_dirty, and BMesh::totloop.

Referenced by bevel_harden_normals(), BKE_editmesh_lnorspace_update(), BM_custom_loop_normals_to_vector_layer(), edbm_flip_normals_exec(), flip_custom_normals(), and flip_custom_normals_init_data().

◆ BM_lnorspacearr_store()

void BM_lnorspacearr_store	(	BMesh *	bm,
		float(*)	r_lnors[3]
	)

Definition at line 1392 of file bmesh_mesh.c.

References BLI_assert, bm, BM_data_layer_add(), BM_loops_calc_normal_vcos(), BM_SPACEARR_DIRTY, BM_SPACEARR_DIRTY_ALL, CD_CUSTOMLOOPNORMAL, CustomData_get_offset(), CustomData_has_layer(), BMesh::ldata, BMesh::lnor_spacearr, M_PI, NULL, and BMesh::spacearr_dirty.

Referenced by BM_lnorspace_update().

◆ BM_loop_at_index_find()

BMLoop* BM_loop_at_index_find	(	BMesh *	bm,
		const int	index
	)

Definition at line 2391 of file bmesh_mesh.c.

References bm, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BMFace::len, len, BMLoop::next, and NULL.

Referenced by uv_shortest_path_pick_exec().

◆ BM_loop_check_cyclic_smooth_fan()

bool BM_loop_check_cyclic_smooth_fan ( BMLoop * l_curr )

Check whether given loop is part of an unknown-so-far cyclic smooth fan, or not. Needed because cyclic smooth fans have no obvious 'entry point', and yet we need to walk them once, and only once.

Definition at line 636 of file bmesh_mesh.c.

References BLI_assert, BM_elem_flag_enable, BM_elem_flag_test, BM_ELEM_TAG, BM_vert_step_fan_loop(), and BMLoop::e.

Referenced by bm_mesh_loops_calc_normals(), edbm_average_normals_exec(), and normals_split().

◆ BM_loop_normal_editdata_array_free()

void BM_loop_normal_editdata_array_free ( struct BMLoopNorEditDataArray * lnors_ed_arr )

Definition at line 1892 of file bmesh_mesh.c.

References BMLoopNorEditDataArray::lidx_to_lnor_editdata, BMLoopNorEditDataArray::lnor_editdata, MEM_freeN, and MEM_SAFE_FREE.

Referenced by edbm_flip_normals_exec(), edbm_normals_make_consistent_exec(), edbm_normals_tools_exec(), edbm_smooth_normals_exec(), flip_custom_normals(), freeCustomNormalArray(), normals_split_merge(), and point_normals_free().

◆ BM_loop_normal_editdata_array_init()

struct BMLoopNorEditDataArray* BM_loop_normal_editdata_array_init	(	BMesh *	bm,
		const bool	do_all_loops_of_vert
	)

Definition at line 1844 of file bmesh_mesh.c.

References BLI_assert, BLI_BITMAP_NEW, BLI_BITMAP_TEST, bm, BM_data_layer_add(), BM_elem_index_get, BM_ITER_ELEM, BM_ITER_MESH, BM_LOOP, bm_loop_normal_mark_indiv(), BM_LOOPS_OF_VERT, BM_mesh_elem_index_ensure(), BM_VERTS_OF_MESH, BMLoopNorEditDataArray::cd_custom_normal_offset, CD_CUSTOMLOOPNORMAL, CustomData_get_offset(), CustomData_has_layer(), l, BMesh::ldata, BMLoopNorEditDataArray::lidx_to_lnor_editdata, BMLoopNorEditDataArray::lnor_editdata, loop_normal_editdata_init(), MEM_callocN, MEM_freeN, MEM_mallocN, BMesh::spacearr_dirty, BMesh::totloop, BMLoopNorEditDataArray::totloop, and v.

Referenced by edbm_flip_normals_exec(), edbm_normals_tools_exec(), edbm_smooth_normals_exec(), flip_custom_normals(), flip_custom_normals_init_data(), normals_split_merge(), point_normals_init(), and storeCustomLNorValue().

◆ BM_loops_calc_normal_vcos()

void BM_loops_calc_normal_vcos	(	BMesh *	bm,
		const float(*)	vcos[3],
		const float(*)	vnos[3],
		const float(*)	fnos[3],
		const bool	use_split_normals,
		const float	split_angle,
		float(*)	r_lnos[3],
		MLoopNorSpaceArray *	r_lnors_spacearr,
		short(*)	clnors_data[2],
		const int	cd_loop_clnors_offset,
		const bool	do_rebuild
	)

BMesh Compute Loop Normals from/to external data.

Compute split normals, i.e. vertex normals associated with each poly (hence 'loop normals'). Useful to materialize sharp edges (or non-smooth faces) without actually modifying the geometry (splitting edges).

Definition at line 1346 of file bmesh_mesh.c.

References BLI_assert, bm, bm_mesh_edges_sharp_tag(), bm_mesh_loops_calc_normals(), bm_mesh_loops_calc_normals_no_autosmooth(), and M_PI.

Referenced by BM_lnorspace_err(), BM_lnorspace_rebuild(), BM_lnorspacearr_store(), and mesh_render_data_update_normals().

◆ BM_mesh_clear()

void BM_mesh_clear ( BMesh * bm )

BMesh Clear Mesh.

Clear all data in bm

Definition at line 281 of file bmesh_mesh.c.

References bm, bm_mempool_init(), bm_mesh_allocsize_default, BM_mesh_data_free(), CustomData_reset(), BMesh::edata, BMesh::ldata, BMesh::pdata, BMesh::toolflag_index, BMesh::totflags, BMesh::use_toolflags, and BMesh::vdata.

Referenced by bpy_bmesh_clear(), and EDBM_mesh_clear().

◆ BM_mesh_create()

BMesh* BM_mesh_create	(	const struct BMAllocTemplate *	allocsize,
		const struct BMeshCreateParams *	params
	)

◆ BM_mesh_data_free()

void BM_mesh_data_free ( BMesh * bm )

BMesh Free Mesh Data.

Frees a BMesh structure.

Note: frees mesh, but not actual BMesh struct

Definition at line 185 of file bmesh_mesh.c.

References BKE_lnor_spacearr_free(), BLI_freelistN(), BLI_mempool_destroy(), bm, BM_EDGES_OF_MESH, BM_FACES_OF_MESH, BM_ITER_ELEM, BM_ITER_MESH, BM_LOOPS_OF_FACE, BM_mesh_elem_toolflags_clear(), BM_VERTS_OF_MESH, BMO_error_clear(), CustomData_bmesh_free_block(), CustomData_bmesh_has_free(), CustomData_free(), BMHeader::data, e, BMesh::edata, BMesh::epool, BMesh::etable, BMesh::fpool, BMesh::ftable, BMVert::head, BMLoop::head, BMFace::head, l, BMesh::ldata, BMesh::lnor_spacearr, BMesh::lpool, MEM_freeN, BMesh::pdata, CustomData::pool, BMesh::selected, CustomData::totlayer, v, BMesh::vdata, BMesh::vpool, and BMesh::vtable.

Referenced by BM_mesh_clear(), BM_mesh_free(), EDBM_redo_state_free(), and EDBM_redo_state_restore().

◆ BM_mesh_elem_count()

int BM_mesh_elem_count	(	BMesh *	bm,
		const char	htype
	)

Return the amount of element of type 'type' in a given bmesh.

Definition at line 2444 of file bmesh_mesh.c.

References BLI_assert, bm, BM_ALL_NOLOOP, BM_EDGE, BM_FACE, BM_VERT, BMesh::totedge, BMesh::totface, and BMesh::totvert.

Referenced by SCULPT_vertex_count_get(), and TEST().

◆ BM_mesh_elem_index_ensure()

void BM_mesh_elem_index_ensure	(	BMesh *	bm,
		const char	htype
	)

Definition at line 2152 of file bmesh_mesh.c.

References bm, BM_mesh_elem_index_ensure_ex(), and NULL.

Referenced by armature_deform_coords_impl(), BKE_bmbvh_new_ex(), BKE_editmesh_cache_ensure_poly_centers(), BKE_editmesh_cache_ensure_poly_normals(), BKE_editmesh_cache_ensure_vert_normals(), BKE_editmesh_loop_tangent_calc(), BKE_mesh_foreach_mapped_edge(), BKE_mesh_foreach_mapped_loop(), BKE_pbvh_node_raycast(), BM_custom_loop_normals_to_vector_layer(), bm_decim_triangulate_begin(), bm_edge_info_average_length_fallback(), BM_lnorspace_invalidate(), BM_lnorspace_rebuild(), BM_loop_normal_editdata_array_init(), bm_loop_normal_mark_indiv(), BM_mesh_calc_path_edge(), BM_mesh_decimate_dissolve_ex(), BM_mesh_edgenet(), bm_mesh_edges_calc_vectors(), bm_mesh_edges_sharp_tag(), BM_mesh_intersect(), bm_mesh_loops_calc_normals(), bm_mesh_loops_calc_normals_no_autosmooth(), BM_mesh_normals_update(), BM_mesh_region_match(), bm_mesh_verts_calc_normals(), BM_uv_element_map_create(), BM_uv_vert_map_create(), BMeshFairingContext::BMeshFairingContext(), bmo_offset_edgeloops_exec(), bmo_smooth_laplacian_vert_exec(), bpy_bmelemseq_index_update(), calc_solidify_normals(), construct_param_handle(), construct_param_handle_subsurfed(), DRW_text_edit_mesh_measure_stats(), ED_mesh_mirrtopo_init(), edbm_face_split_by_edges_exec(), edbm_mod_weighted_strength_exec(), EDBM_preselect_edgering_update_from_edge(), EDBM_preselect_elem_update_from_single(), edbm_select_linked_pick_invoke(), edbm_shortest_path_pick_invoke(), EDBM_unified_findnearest_from_raycast(), EDBM_verts_mirror_cache_begin_ex(), gizmo_preselect_edgering_test_select(), gizmo_preselect_elem_test_select(), knifetool_init_bmbvh(), lattice_deform_coords_impl(), lineart_geometry_object_load(), loopcut_finish(), math_layer_info_init(), mesh_calc_path_region_elem(), mesh_render_data_create(), SCULPT_stroke_get_location(), SCULPT_vertex_random_access_ensure(), snap_mesh_polygon(), snapEditMesh(), solidify_add_thickness(), statvis_calc_distort(), statvis_calc_intersect(), statvis_calc_thickness(), stitch_process_data(), transform_convert_mesh_islands_calc(), uv_find_nearest_edge(), uv_find_nearest_vert(), uv_select_overlap(), uv_set_connectivity_distance(), uv_shortest_path_pick_invoke(), and vgroup_smooth_subset().

◆ BM_mesh_elem_index_ensure_ex()

void BM_mesh_elem_index_ensure_ex	(	BMesh *	bm,
		const char	htype,
		int	elem_offset[4]
	)

Definition at line 2038 of file bmesh_mesh.c.

References BLI_assert, bm, BM_EDGE, BM_EDGES_OF_MESH, BM_elem_index_set, BM_ELEM_INDEX_VALIDATE, BM_FACE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_LOOP, BM_VERT, BM_VERTS_OF_MESH, BMesh::elem_index_dirty, elem_offset(), BMLoop::next, NULL, BMesh::totedge, BMesh::totface, BMesh::totloop, and BMesh::totvert.

Referenced by BM_mesh_elem_index_ensure(), and EDBM_mesh_elem_index_ensure_multi().

◆ BM_mesh_elem_index_validate()

void BM_mesh_elem_index_validate	(	BMesh *	bm,
		const char *	location,
		const char *	func,
		const char *	msg_a,
		const char *	msg_b
	)

Array checking/setting macros

Currently vert/edge/loop/face index data is being abused, in a few areas of the code.

To avoid correcting them afterwards, set 'bm->elem_index_dirty' however its possible this flag is set incorrectly which could crash blender.

Code that calls this functions may depend on dirty indices on being set. Keep this function read-only.

Definition at line 2169 of file bmesh_mesh.c.

References bm, BM_EDGE, BM_EDGES_OF_MESH, BM_elem_index_get, BM_FACE, BM_FACES_OF_MESH, BM_ITER_MESH, BM_VERT, BM_VERTS_OF_MESH, and BMesh::elem_index_dirty.

◆ BM_mesh_elem_table_check()

bool BM_mesh_elem_table_check ( BMesh * bm )

Definition at line 2242 of file bmesh_mesh.c.

References bm, BM_EDGE, BM_EDGES_OF_MESH, BM_FACE, BM_FACES_OF_MESH, BM_ITER_MESH_INDEX, BM_VERT, BM_VERTS_OF_MESH, BMesh::elem_table_dirty, BMesh::etable, BMesh::ftable, and BMesh::vtable.

Referenced by BM_mesh_elem_table_ensure(), and EDBM_update_generic().

◆ BM_mesh_elem_table_ensure()

void BM_mesh_elem_table_ensure	(	BMesh *	bm,
		const char	htype
	)

Definition at line 2276 of file bmesh_mesh.c.

References BLI_assert, bm, BM_ALL_NOLOOP, BM_EDGE, BM_EDGES_OF_MESH, BM_FACE, BM_FACES_OF_MESH, BM_iter_as_array(), BM_mesh_elem_table_check(), BM_VERT, BM_VERTS_OF_MESH, BMesh::elem_table_dirty, BMesh::etable, BMesh::etable_tot, BMesh::ftable, BMesh::ftable_tot, MEM_freeN, MEM_mallocN, NULL, BMesh::totedge, BMesh::totface, BMesh::totvert, BMesh::vtable, and BMesh::vtable_tot.

Referenced by bm_mesh_calc_uv_islands(), BM_mesh_elem_table_init(), BM_mesh_intersect(), BM_mesh_intersect_edges(), BM_mesh_remap(), BMeshFairingContext::BMeshFairingContext(), bmo_recalc_face_normals_exec(), bpy_bmelemseq_ensure_lookup_table(), bvhtree_from_editmesh_edges_create_tree(), bvhtree_from_editmesh_verts_create_tree(), construct_param_handle_subsurfed(), draw_select_id_edit_mesh(), ED_mesh_mirror_spatial_table_begin(), ED_mesh_mirrtopo_init(), ED_transverts_create_from_obedit(), ED_vgroup_parray_mirror_assign(), ED_vgroup_parray_mirror_sync(), edbm_face_split_by_edges_exec(), EDBM_select_interior_faces(), edbm_select_similar_region_exec(), EDBM_verts_mirror_cache_begin_ex(), blender::ed::spreadsheet::GeometryDataSource::get_selected_element_indices(), get_vert_def_nr(), give_parvert(), lineart_geometry_object_load(), loopcut_init(), math_layer_info_init(), mesh_foreachScreenEdge(), mesh_foreachScreenEdge_clip_bb_segment(), mesh_foreachScreenFace(), mesh_foreachScreenVert(), mesh_render_data_create(), mesh_symmetry_snap_exec(), multires_unsubdivide_extract_grids(), multires_unsubdivide_prepare_original_bmesh_for_extract(), multires_unsubdivide_single_level(), sculpt_face_set_delete_geometry(), sculpt_face_sets_init_flood_fill(), SCULPT_stroke_get_location(), SCULPT_vertex_random_access_ensure(), snap_mesh_polygon(), snapEditMesh(), stitch_init(), transform_convert_mesh_islands_calc(), uv_select_flush_from_tag_face(), uv_select_flush_from_tag_loop(), uv_select_linked_multi(), uv_select_overlap(), and vgroup_smooth_subset().

◆ BM_mesh_elem_table_free()

void BM_mesh_elem_table_free	(	BMesh *	bm,
		const char	htype
	)

Definition at line 2361 of file bmesh_mesh.c.

References bm, BM_EDGE, BM_FACE, BM_VERT, BMesh::etable, BMesh::ftable, MEM_SAFE_FREE, and BMesh::vtable.

Referenced by BM_mesh_elem_table_init().

◆ BM_mesh_elem_table_init()

void BM_mesh_elem_table_init	(	BMesh *	bm,
		const char	htype
	)

Definition at line 2352 of file bmesh_mesh.c.

References BLI_assert, bm, BM_ALL_NOLOOP, BM_mesh_elem_table_ensure(), and BM_mesh_elem_table_free().

Referenced by multires_unsubdivide_single_level(), sculpt_face_set_delete_geometry(), and sculpt_face_sets_init_flood_fill().

◆ BM_mesh_elem_toolflags_clear()

void BM_mesh_elem_toolflags_clear ( BMesh * bm )

Definition at line 132 of file bmesh_mesh.c.

References BLI_mempool_destroy(), bm, BMesh::etoolflagpool, BMesh::ftoolflagpool, NULL, and BMesh::vtoolflagpool.

Referenced by BM_mesh_data_free(), and select_linked_delimit_end().

◆ BM_mesh_elem_toolflags_ensure()

void BM_mesh_elem_toolflags_ensure ( BMesh * bm )

Definition at line 98 of file bmesh_mesh.c.

References BLI_assert, BLI_mempool_calloc(), BLI_mempool_create(), BLI_MEMPOOL_NOP, bm, BM_EDGES_OF_MESH, BM_FACES_OF_MESH, BM_ITER_MESH, BM_VERTS_OF_MESH, BMesh::etoolflagpool, BMesh::ftoolflagpool, BMVert_OFlag::oflags, BMEdge_OFlag::oflags, BMFace_OFlag::oflags, BMesh::totedge, BMesh::totface, BMesh::totflags, BMesh::totvert, BMesh::use_toolflags, and BMesh::vtoolflagpool.

Referenced by BMO_op_exec(), build_skin(), mesh_separate_tagged(), select_linked_delimit_begin(), and walker_deselect_nth().

◆ BM_mesh_free()

void BM_mesh_free ( BMesh * bm )

BMesh Free Mesh.

Frees a BMesh data and its structure.

Definition at line 307 of file bmesh_mesh.c.

References bm, BM_mesh_data_free(), bpy_bm_generic_invalidate(), MEM_freeN, NULL, and BMesh::py_handle.

Referenced by base_skin(), bc_triangulate_mesh(), BKE_editmesh_free(), BKE_mesh_mirror_apply_mirror_on_axis(), BKE_mesh_mirror_bisect_on_mirror_plane_for_modifier(), BKE_mesh_remesh_voxel_fix_poles(), BKE_sculptsession_free(), bpy_bmesh_dealloc(), bpy_bmesh_free(), blender::nodes::create_cube_mesh(), blender::nodes::create_ico_sphere_mesh(), blender::io::alembic::ABCGenericMeshWriter::do_write(), doEdgeSplit(), ED_uvedit_add_simple_uvs(), EDBM_automerge_and_split(), edbm_separate_exec(), mesh_customdatacorrect_free_cb(), mesh_separate_arrays(), mesh_separate_tagged(), modifyMesh(), multires_unsubdivide_extract_grids(), multires_unsubdivide_private_extract_data_free(), multires_unsubdivide_to_basemesh(), paint_mask_slice_exec(), SCULPT_dynamic_topology_disable_ex(), sculpt_face_set_create_exec(), sculpt_face_set_delete_geometry(), sculpt_face_sets_init_flood_fill(), sculpt_face_sets_init_loop(), sculpt_gesture_apply_trim(), sculpt_gesture_trim_normals_update(), TEST(), triangulate_mesh(), and WireframeModifier_do().

◆ BM_mesh_normals_update()

void BM_mesh_normals_update ( BMesh * bm )

BMesh Compute Normals.

Updates the normals of a mesh.

Definition at line 500 of file bmesh_mesh.c.

References bm, BM_EDGE, BM_elem_index_set, BM_FACE, BM_FACES_OF_MESH, BM_ITER_MESH_INDEX, bm_mesh_edges_calc_vectors(), BM_mesh_elem_index_ensure(), bm_mesh_verts_calc_normals(), BM_OMP_LIMIT, BM_VERT, BM_VERTS_OF_MESH, BMesh::elem_index_dirty, float(), MEM_freeN, MEM_mallocN, mesh_faces_calc_normals_cb(), BMVert::no, NULL, BMesh::totedge, BMesh::totface, v, and zero_v3().

Referenced by bevel_harden_normals(), BKE_mesh_remesh_voxel_fix_poles(), bmesh_edit_begin(), bmesh_edit_end(), bpy_bmesh_normal_update(), ED_transverts_update_obedit(), EDBM_mesh_normals_update(), lineart_geometry_object_load(), mesh_separate_tagged(), modwrap_dependsOnNormals(), SCULPT_dynamic_topology_enable_ex(), and slice_paint_mask().

◆ BM_mesh_rebuild()

void BM_mesh_rebuild	(	BMesh *	bm,
		const struct BMeshCreateParams *	params,
		BLI_mempool *	vpool_dst,
		BLI_mempool *	epool_dst,
		BLI_mempool *	lpool_dst,
		BLI_mempool *	fpool_dst
	)

Use new memory pools for this mesh.

Note: needed for re-sizing elements (adding/removing tool flags) but could also be used for packing fragmented bmeshes.

Definition at line 2762 of file bmesh_mesh.c.

References BMesh::act_face, BLI_mempool_alloc(), BLI_mempool_calloc(), BLI_mempool_destroy(), bm, BM_EDGE, BM_EDGES_OF_MESH, BM_elem_index_set, BM_FACE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH_INDEX, BM_LOOP, BM_VERT, BM_VERTS_OF_MESH, BMVert::e, BMLoop::e, e, BMesh::elem_table_dirty, BMesh::epool, BMesh::etable, BMesh::etable_tot, BMesh::etoolflagpool, BMLoop::f, BMesh::fpool, BMesh::ftable, BMesh::ftable_tot, BMesh::ftoolflagpool, BMFace::l_first, LISTBASE_FOREACH, BMesh::lpool, MAP_EDGE, MAP_FACE, MAP_VERT, MEM_freeN, MEM_mallocN, BMLoop::next, NULL, params, BMLoop::prev, BMLoop::radial_next, BMLoop::radial_prev, REMAP_EDGE, REMAP_FACE, REMAP_LOOP, REMAP_VERT, BMesh::selected, SWAP, BMesh::totedge, BMesh::totface, BMesh::totloop, BMesh::totvert, BMLoop::v, v, BMesh::vpool, BMesh::vtable, BMesh::vtable_tot, and BMesh::vtoolflagpool.

Referenced by BM_mesh_toolflags_set().

◆ BM_mesh_remap()

void BM_mesh_remap	(	BMesh *	bm,
		const uint *	vert_idx,
		const uint *	edge_idx,
		const uint *	face_idx
	)

Remaps the vertices, edges and/or faces of the bmesh as indicated by vert/edge/face_idx arrays (xxx_idx[org_index] = new_index).

A NULL array means no changes.

Note

Does not mess with indices, just sets elem_index_dirty flag.
For verts/edges/faces only (as loops must remain "ordered" and "aligned" on a per-face basis...).