Blender V4.3
BKE_mesh.h File Reference
#include "BLI_array.hh"
#include "BLI_compiler_attrs.h"
#include "BLI_compiler_compat.h"
#include "BLI_utildefines.h"
#include "DNA_mesh_types.h"

Go to the source code of this file.

Classes

struct  MLoopNorSpace
 
struct  MLoopNorSpaceArray
 

Enumerations

enum  eMeshBatchDirtyMode {
  BKE_MESH_BATCH_DIRTY_ALL = 0 , BKE_MESH_BATCH_DIRTY_SELECT , BKE_MESH_BATCH_DIRTY_SELECT_PAINT , BKE_MESH_BATCH_DIRTY_SHADING ,
  BKE_MESH_BATCH_DIRTY_UVEDIT_ALL , BKE_MESH_BATCH_DIRTY_UVEDIT_SELECT
}
 
enum  { MLNOR_SPACE_IS_SINGLE = 1 << 0 }
 
enum  { MLNOR_SPACEARR_LOOP_INDEX = 0 , MLNOR_SPACEARR_BMLOOP_PTR = 1 }
 

Functions

BMeshBKE_mesh_to_bmesh_ex (const Mesh *mesh, const BMeshCreateParams *create_params, const BMeshFromMeshParams *convert_params)
 
BMeshBKE_mesh_to_bmesh (Mesh *mesh, Object *ob, bool add_key_index, const BMeshCreateParams *params)
 
MeshBKE_mesh_from_bmesh_nomain (BMesh *bm, const BMeshToMeshParams *params, const Mesh *me_settings)
 
MeshBKE_mesh_from_bmesh_for_eval_nomain (BMesh *bm, const CustomData_MeshMasks *cd_mask_extra, const Mesh *me_settings)
 
void BKE_mesh_ensure_default_orig_index_customdata (Mesh *mesh)
 
void BKE_mesh_ensure_default_orig_index_customdata_no_check (Mesh *mesh)
 
void BKE_mesh_free_data_for_undo (Mesh *mesh)
 
void BKE_mesh_clear_geometry (Mesh *mesh)
 
void BKE_mesh_clear_geometry_and_metadata (Mesh *mesh)
 
MeshBKE_mesh_add (Main *bmain, const char *name)
 
void BKE_mesh_free_editmesh (Mesh *mesh)
 
void BKE_mesh_copy_parameters_for_eval (Mesh *me_dst, const Mesh *me_src)
 
void BKE_mesh_copy_parameters (Mesh *me_dst, const Mesh *me_src)
 
void BKE_mesh_ensure_skin_customdata (Mesh *mesh)
 
void BKE_mesh_face_offsets_ensure_alloc (Mesh *mesh)
 
MeshBKE_mesh_new_nomain (int verts_num, int edges_num, int faces_num, int corners_num)
 
MeshBKE_mesh_new_nomain_from_template (const Mesh *me_src, int verts_num, int edges_num, int faces_num, int corners_num)
 
MeshBKE_mesh_new_nomain_from_template_ex (const Mesh *me_src, int verts_num, int edges_num, int tessface_num, int faces_num, int corners_num, CustomData_MeshMasks mask)
 
MeshBKE_mesh_copy_for_eval (const Mesh &source)
 
MeshBKE_mesh_new_nomain_from_curve (const Object *ob)
 
MeshBKE_mesh_new_nomain_from_curve_displist (const Object *ob, const ListBase *dispbase)
 
bool BKE_mesh_attribute_required (const char *name)
 
blender::Array< blender::float3BKE_mesh_orco_verts_get (const Object *ob)
 
void BKE_mesh_orco_verts_transform (Mesh *mesh, blender::MutableSpan< blender::float3 > orco, bool invert)
 
void BKE_mesh_orco_verts_transform (Mesh *mesh, float(*orco)[3], int totvert, bool invert)
 
void BKE_mesh_orco_ensure (Object *ob, Mesh *mesh)
 
MeshBKE_mesh_from_object (Object *ob)
 
void BKE_mesh_assign_object (Main *bmain, Object *ob, Mesh *mesh)
 
void BKE_mesh_to_curve_nurblist (const Mesh *mesh, ListBase *nurblist, int edge_users_test)
 
void BKE_mesh_to_curve (Main *bmain, Depsgraph *depsgraph, Scene *scene, Object *ob)
 
void BKE_mesh_to_pointcloud (Main *bmain, Depsgraph *depsgraph, Scene *scene, Object *ob)
 
void BKE_pointcloud_to_mesh (Main *bmain, Depsgraph *depsgraph, Scene *scene, Object *ob)
 
void BKE_mesh_material_index_remove (Mesh *mesh, short index)
 
bool BKE_mesh_material_index_used (Mesh *mesh, short index)
 
void BKE_mesh_material_index_clear (Mesh *mesh)
 
void BKE_mesh_material_remap (Mesh *mesh, const unsigned int *remap, unsigned int remap_len)
 
void BKE_mesh_texspace_calc (Mesh *mesh)
 
void BKE_mesh_texspace_ensure (Mesh *mesh)
 
void BKE_mesh_texspace_get (Mesh *mesh, float r_texspace_location[3], float r_texspace_size[3])
 
void BKE_mesh_texspace_get_reference (Mesh *mesh, char **r_texspace_flag, float **r_texspace_location, float **r_texspace_size)
 
MeshBKE_mesh_new_from_object (Depsgraph *depsgraph, Object *object, bool preserve_all_data_layers, bool preserve_origindex)
 
MeshBKE_mesh_new_from_object_to_bmain (Main *bmain, Depsgraph *depsgraph, Object *object, bool preserve_all_data_layers)
 
void BKE_mesh_nomain_to_mesh (Mesh *mesh_src, Mesh *mesh_dst, Object *ob)
 
void BKE_mesh_nomain_to_meshkey (Mesh *mesh_src, Mesh *mesh_dst, KeyBlock *kb)
 
void BKE_mesh_transform (Mesh *mesh, const float mat[4][4], bool do_keys)
 
void BKE_mesh_translate (Mesh *mesh, const float offset[3], bool do_keys)
 
void BKE_mesh_tessface_clear (Mesh *mesh)
 
void BKE_mesh_mselect_clear (Mesh *mesh)
 
void BKE_mesh_mselect_validate (Mesh *mesh)
 
int BKE_mesh_mselect_find (const Mesh *mesh, int index, int type)
 
int BKE_mesh_mselect_active_get (const Mesh *mesh, int type)
 
void BKE_mesh_mselect_active_set (Mesh *mesh, int index, int type)
 
void BKE_mesh_count_selected_items (const Mesh *mesh, int r_count[3])
 
bool BKE_mesh_vert_normals_are_dirty (const Mesh *mesh)
 
bool BKE_mesh_face_normals_are_dirty (const Mesh *mesh)
 
void BKE_lnor_spacearr_init (MLoopNorSpaceArray *lnors_spacearr, int numLoops, char data_type)
 
void BKE_lnor_spacearr_clear (MLoopNorSpaceArray *lnors_spacearr)
 
void BKE_lnor_spacearr_free (MLoopNorSpaceArray *lnors_spacearr)
 
void BKE_lnor_spacearr_tls_init (MLoopNorSpaceArray *lnors_spacearr, MLoopNorSpaceArray *lnors_spacearr_tls)
 
void BKE_lnor_spacearr_tls_join (MLoopNorSpaceArray *lnors_spacearr, MLoopNorSpaceArray *lnors_spacearr_tls)
 
MLoopNorSpaceBKE_lnor_space_create (MLoopNorSpaceArray *lnors_spacearr)
 
void BKE_lnor_space_define (MLoopNorSpace *lnor_space, const float lnor[3], const float vec_ref[3], const float vec_other[3], blender::Span< blender::float3 > edge_vectors)
 
void BKE_lnor_space_add_loop (MLoopNorSpaceArray *lnors_spacearr, MLoopNorSpace *lnor_space, int corner, void *bm_loop, bool is_single)
 
void BKE_lnor_space_custom_data_to_normal (const MLoopNorSpace *lnor_space, const short clnor_data[2], float r_custom_lnor[3])
 
void BKE_lnor_space_custom_normal_to_data (const MLoopNorSpace *lnor_space, const float custom_lnor[3], short r_clnor_data[2])
 
void BKE_mesh_normals_loop_to_vertex (int numVerts, const int *corner_verts, int numLoops, const float(*clnors)[3], float(*r_vert_clnors)[3])
 
bool BKE_mesh_has_custom_loop_normals (Mesh *mesh)
 
void BKE_mesh_set_custom_normals (Mesh *mesh, float(*r_custom_loop_normals)[3])
 
void BKE_mesh_set_custom_normals_normalized (Mesh *mesh, float(*r_custom_loop_normals)[3])
 
void BKE_mesh_set_custom_normals_from_verts (Mesh *mesh, float(*r_custom_vert_normals)[3])
 
void BKE_mesh_set_custom_normals_from_verts_normalized (Mesh *mesh, float(*r_custom_vert_normals)[3])
 
float BKE_mesh_calc_area (const Mesh *mesh)
 
bool BKE_mesh_center_median (const Mesh *mesh, float r_cent[3])
 
bool BKE_mesh_center_median_from_faces (const Mesh *mesh, float r_cent[3])
 
bool BKE_mesh_center_of_surface (const Mesh *mesh, float r_cent[3])
 
bool BKE_mesh_center_of_volume (const Mesh *mesh, float r_cent[3])
 
void BKE_mesh_calc_volume (const float(*vert_positions)[3], int mverts_num, const blender::int3 *corner_tris, int corner_tris_num, const int *corner_verts, float *r_volume, float r_center[3])
 
void BKE_mesh_mdisp_flip (MDisps *md, bool use_loop_mdisp_flip)
 
void BKE_mesh_merge_customdata_for_apply_modifier (Mesh *mesh)
 
void BKE_mesh_calc_relative_deform (const int *face_offsets, int faces_num, const int *corner_verts, int totvert, const float(*vert_cos_src)[3], const float(*vert_cos_dst)[3], const float(*vert_cos_org)[3], float(*vert_cos_new)[3])
 
bool BKE_mesh_validate (Mesh *mesh, bool do_verbose, bool cddata_check_mask)
 
bool BKE_mesh_is_valid (Mesh *mesh)
 
bool BKE_mesh_validate_material_indices (Mesh *mesh)
 
bool BKE_mesh_validate_arrays (Mesh *mesh, float(*vert_positions)[3], unsigned int verts_num, blender::int2 *edges, unsigned int edges_num, MFace *legacy_faces, unsigned int legacy_faces_num, const int *corner_verts, int *corner_edges, unsigned int corners_num, const int *face_offsets, unsigned int faces_num, MDeformVert *dverts, bool do_verbose, bool do_fixes, bool *r_change)
 
bool BKE_mesh_validate_all_customdata (CustomData *vert_data, uint verts_num, CustomData *edge_data, uint edges_num, CustomData *corner_data, uint corners_num, CustomData *face_data, uint faces_num, bool check_meshmask, bool do_verbose, bool do_fixes, bool *r_change)
 
void BKE_mesh_strip_loose_faces (Mesh *mesh)
 
void BKE_mesh_eval_geometry (Depsgraph *depsgraph, Mesh *mesh)
 
void BKE_mesh_batch_cache_dirty_tag (Mesh *mesh, eMeshBatchDirtyMode mode)
 
void BKE_mesh_batch_cache_free (void *batch_cache)
 
char * BKE_mesh_debug_info (const Mesh *mesh) ATTR_NONNULL(1) ATTR_MALLOC ATTR_WARN_UNUSED_RESULT
 
void BKE_mesh_debug_print (const Mesh *mesh) ATTR_NONNULL(1)
 

Variables

void(* BKE_mesh_batch_cache_dirty_tag_cb )(Mesh *mesh, eMeshBatchDirtyMode mode)
 
void(* BKE_mesh_batch_cache_free_cb )(void *batch_cache)
 

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

MLoopNorSpace.flags

Enumerator
MLNOR_SPACE_IS_SINGLE 

Definition at line 257 of file BKE_mesh.h.

◆ anonymous enum

anonymous enum

MLoopNorSpaceArray.data_type

Enumerator
MLNOR_SPACEARR_LOOP_INDEX 
MLNOR_SPACEARR_BMLOOP_PTR 

Definition at line 275 of file BKE_mesh.h.

◆ eMeshBatchDirtyMode

Enumerator
BKE_MESH_BATCH_DIRTY_ALL 
BKE_MESH_BATCH_DIRTY_SELECT 
BKE_MESH_BATCH_DIRTY_SELECT_PAINT 
BKE_MESH_BATCH_DIRTY_SHADING 
BKE_MESH_BATCH_DIRTY_UVEDIT_ALL 
BKE_MESH_BATCH_DIRTY_UVEDIT_SELECT 

Definition at line 37 of file BKE_mesh.h.

Function Documentation

◆ BKE_lnor_space_add_loop()

void BKE_lnor_space_add_loop ( MLoopNorSpaceArray * lnors_spacearr,
MLoopNorSpace * lnor_space,
int corner,
void * bm_loop,
bool is_single )

Add a new given loop to given lnor_space. Depending on lnor_space->data_type, we expect bm_loop to be a pointer to BMLoop struct (in case of BMLOOP_PTR), or nullptr (in case of LOOP_INDEX), loop index is then stored in pointer. If is_single is set, the BMLoop or loop index is directly stored in lnor_space->loops pointer (since there is only one loop in this fan), else it is added to the linked list of loops in the fan.

Definition at line 469 of file mesh_normals.cc.

References BLI_assert, BLI_linklist_prepend_nlink(), MLoopNorSpaceArray::data_type, MLoopNorSpace::flags, MLoopNorSpace::loops, MLoopNorSpaceArray::loops_pool, MLoopNorSpaceArray::lspacearr, MLNOR_SPACE_IS_SINGLE, MLNOR_SPACEARR_BMLOOP_PTR, MLNOR_SPACEARR_LOOP_INDEX, and POINTER_FROM_INT.

Referenced by bm_mesh_loops_calc_normals_for_loop().

◆ BKE_lnor_space_create()

MLoopNorSpace * BKE_lnor_space_create ( MLoopNorSpaceArray * lnors_spacearr)

◆ BKE_lnor_space_custom_data_to_normal()

◆ BKE_lnor_space_custom_normal_to_data()

◆ BKE_lnor_space_define()

void BKE_lnor_space_define ( MLoopNorSpace * lnor_space,
const float lnor[3],
const float vec_ref[3],
const float vec_other[3],
blender::Span< blender::float3 > edge_vectors )

Should only be called once. Beware, this modifies ref_vec and other_vec in place! In case no valid space can be generated, ref_alpha and ref_beta are set to zero (which means 'use auto lnors').

Definition at line 454 of file mesh_normals.cc.

References copy_v3_v3(), MLoopNorSpace::ref_alpha, MLoopNorSpace::ref_beta, MLoopNorSpace::vec_lnor, MLoopNorSpace::vec_ortho, and MLoopNorSpace::vec_ref.

Referenced by bm_mesh_loops_calc_normals_for_loop().

◆ BKE_lnor_spacearr_clear()

◆ BKE_lnor_spacearr_free()

◆ BKE_lnor_spacearr_init()

◆ BKE_lnor_spacearr_tls_init()

void BKE_lnor_spacearr_tls_init ( MLoopNorSpaceArray * lnors_spacearr,
MLoopNorSpaceArray * lnors_spacearr_tls )

Utility for multi-threaded calculation that ensures lnors_spacearr_tls doesn't share memory with lnors_spacearr that would cause it not to be thread safe.

Note
This works as long as threads never operate on the same loops at once.

Definition at line 341 of file mesh_normals.cc.

References BLI_memarena_new(), BLI_MEMARENA_STD_BUFSIZE, and MLoopNorSpaceArray::mem.

Referenced by bm_mesh_loops_calc_normals_for_vert_init_fn().

◆ BKE_lnor_spacearr_tls_join()

void BKE_lnor_spacearr_tls_join ( MLoopNorSpaceArray * lnors_spacearr,
MLoopNorSpaceArray * lnors_spacearr_tls )

Utility for multi-threaded calculation that merges lnors_spacearr_tls into lnors_spacearr.

Definition at line 348 of file mesh_normals.cc.

References BKE_lnor_spacearr_clear(), BLI_assert, BLI_memarena_free(), BLI_memarena_merge(), MLoopNorSpaceArray::data_type, MLoopNorSpaceArray::mem, and MLoopNorSpaceArray::spaces_num.

Referenced by bm_mesh_loops_calc_normals_for_vert_reduce_fn().

◆ BKE_mesh_add()

◆ BKE_mesh_assign_object()

◆ BKE_mesh_attribute_required()

bool BKE_mesh_attribute_required ( const char * name)

Definition at line 421 of file blenkernel/intern/mesh.cc.

References ELEM.

Referenced by BKE_attribute_required().

◆ BKE_mesh_batch_cache_dirty_tag()

◆ BKE_mesh_batch_cache_free()

void BKE_mesh_batch_cache_free ( void * batch_cache)

Definition at line 430 of file mesh_runtime.cc.

References BKE_mesh_batch_cache_free_cb.

Referenced by blender::bke::free_batch_cache().

◆ BKE_mesh_calc_area()

float BKE_mesh_calc_area ( const Mesh * mesh)

◆ BKE_mesh_calc_relative_deform()

void BKE_mesh_calc_relative_deform ( const int * face_offsets,
int faces_num,
const int * corner_verts,
int totvert,
const float(*) vert_cos_src[3],
const float(*) vert_cos_dst[3],
const float(*) vert_cos_org[3],
float(*) vert_cos_new[3] )

This function takes the difference between 2 vertex-coord-arrays (vert_cos_src, vert_cos_dst), and applies the difference to vert_cos_new relative to vert_cos_org.

Parameters
vert_cos_srcreference deform source.
vert_cos_dstreference deform destination.
vert_cos_orgreference for the output location.
vert_cos_newresulting coords.

Definition at line 715 of file mesh_evaluate.cc.

References add_v3_v3(), copy_v3_v3(), faces, MEM_calloc_arrayN, MEM_freeN(), mul_v3_fl(), and transform_point_by_tri_v3().

Referenced by meshcache_do().

◆ BKE_mesh_calc_volume()

void BKE_mesh_calc_volume ( const float(*) vert_positions[3],
int mverts_num,
const blender::int3 * corner_tris,
int corner_tris_num,
const int * corner_verts,
float * r_volume,
float r_center[3] )

Calculate the volume and center.

Parameters
r_volumeVolume (unsigned).
r_centerCenter of mass.

Definition at line 392 of file mesh_evaluate.cc.

References fabsf, madd_v3_v3fl(), mesh_calc_center_centroid_ex(), mul_v3_fl(), v2, volume_tetrahedron_signed_v3(), and zero_v3().

◆ BKE_mesh_center_median()

bool BKE_mesh_center_median ( const Mesh * mesh,
float r_cent[3] )

◆ BKE_mesh_center_median_from_faces()

bool BKE_mesh_center_median_from_faces ( const Mesh * mesh,
float r_cent[3] )

Calculate the center from faces, use when we want to ignore vertex locations that don't have connected faces.

Definition at line 256 of file mesh_evaluate.cc.

References add_v3_v3(), mul_v3_fl(), blender::Span< T >::slice(), and zero_v3().

Referenced by BKE_mesh_center_of_volume().

◆ BKE_mesh_center_of_surface()

◆ BKE_mesh_center_of_volume()

bool BKE_mesh_center_of_volume ( const Mesh * mesh,
float r_cent[3] )

◆ BKE_mesh_clear_geometry()

void BKE_mesh_clear_geometry ( Mesh * mesh)

◆ BKE_mesh_clear_geometry_and_metadata()

void BKE_mesh_clear_geometry_and_metadata ( Mesh * mesh)

Same as BKE_mesh_clear_geometry, but also clears attribute meta-data like active attribute names and vertex group names. Used when the geometry is entirely replaced.

Definition at line 555 of file blenkernel/intern/mesh.cc.

References BKE_mesh_runtime_clear_cache(), clear_attribute_names(), and mesh_clear_geometry().

Referenced by BKE_mesh_nomain_to_mesh(), and mesh_free_data().

◆ BKE_mesh_copy_for_eval()

◆ BKE_mesh_copy_parameters()

◆ BKE_mesh_copy_parameters_for_eval()

◆ BKE_mesh_count_selected_items()

void BKE_mesh_count_selected_items ( const Mesh * mesh,
int r_count[3] )

◆ BKE_mesh_debug_info()

char * BKE_mesh_debug_info ( const Mesh * mesh)

◆ BKE_mesh_debug_print()

void BKE_mesh_debug_print ( const Mesh * mesh)

Definition at line 76 of file mesh_debug.cc.

References BKE_mesh_debug_info(), MEM_freeN(), and str.

◆ BKE_mesh_ensure_default_orig_index_customdata()

void BKE_mesh_ensure_default_orig_index_customdata ( Mesh * mesh)

Add original index (CD_ORIGINDEX) layers if they don't already exist. This is meant to be used when creating an evaluated mesh from an original edit mode mesh, to allow mapping from the evaluated vertices to the originals.

The mesh is expected to of a ME_WRAPPER_TYPE_MDATA wrapper type. This is asserted.

Definition at line 921 of file blenkernel/intern/mesh.cc.

References BKE_mesh_ensure_default_orig_index_customdata_no_check(), BLI_assert, and ME_WRAPPER_TYPE_MDATA.

Referenced by blender::bke::create_orco_mesh(), and subdivide_edit_mesh().

◆ BKE_mesh_ensure_default_orig_index_customdata_no_check()

void BKE_mesh_ensure_default_orig_index_customdata_no_check ( Mesh * mesh)

Same as BKE_mesh_ensure_default_orig_index_customdata but does not perform any checks: they must be done by the caller.

Definition at line 927 of file blenkernel/intern/mesh.cc.

References ensure_orig_index_layer().

Referenced by BKE_mesh_ensure_default_orig_index_customdata(), and BKE_mesh_wrapper_ensure_mdata().

◆ BKE_mesh_ensure_skin_customdata()

◆ BKE_mesh_eval_geometry()

◆ BKE_mesh_face_normals_are_dirty()

bool BKE_mesh_face_normals_are_dirty ( const Mesh * mesh)

Return true if the mesh face normals either are not stored or are dirty.

Definition at line 68 of file mesh_normals.cc.

Referenced by C_BVHTree_FromObject(), and mesh_calc_tri_tessface().

◆ BKE_mesh_face_offsets_ensure_alloc()

◆ BKE_mesh_free_data_for_undo()

void BKE_mesh_free_data_for_undo ( Mesh * mesh)

Free (or release) any data used by this mesh (does not free the mesh itself). Only use for undo, in most cases BKE_id_free(nullptr, me) should be used.

Definition at line 503 of file blenkernel/intern/mesh.cc.

References mesh_free_data().

Referenced by undomesh_free_data().

◆ BKE_mesh_free_editmesh()

void BKE_mesh_free_editmesh ( Mesh * mesh)

◆ BKE_mesh_from_bmesh_for_eval_nomain()

◆ BKE_mesh_from_bmesh_nomain()

◆ BKE_mesh_from_object()

Mesh * BKE_mesh_from_object ( Object * ob)

Definition at line 1061 of file blenkernel/intern/mesh.cc.

References Object::data, OB_MESH, and Object::type.

Referenced by blender::ed::sculpt_paint::trim::apply_trim(), blender::bke::build_pbvh_from_ccg(), do_paintface_box_select(), ED_mesh_join_objects_exec(), ED_object_texture_paint_mode_enter_ex(), ED_object_texture_paint_mode_exit_ex(), ED_paint_proj_mesh_data_check(), ED_wpaint_ensure_data(), blender::ed::sculpt_paint::boundary::ensure_boundary_info(), blender::ed::sculpt_paint::fill_active_color(), blender::ed::sculpt_paint::vwpaint::mode_enter_generic(), blender::ed::sculpt_paint::vwpaint::mode_exit_generic(), multires_force_external_reload(), multiresModifier_del_levels(), blender::ed::sculpt_paint::object_sculpt_mode_enter(), blender::ed::sculpt_paint::object_sculpt_mode_exit(), paint_proj_new_stroke(), paint_select_less_exec(), paint_select_more_exec(), paintface_deselect_all_visible(), paintface_flush_flags(), paintface_hide(), paintface_minmax(), paintface_mouse_select(), paintface_reveal(), paintface_select_linked(), paintface_select_loop(), paintvert_deselect_all_visible(), paintvert_flush_flags(), paintvert_hide(), paintvert_reveal(), paintvert_select_less_exec(), paintvert_select_linked(), paintvert_select_linked_vertices(), paintvert_select_more_exec(), paintvert_select_ungrouped(), blender::ed::object::quadriflow_remesh_exec(), vertex_color_brightness_contrast_exec(), vertex_color_hsv_exec(), vertex_color_invert_exec(), vertex_color_levels_exec(), vertex_color_set_exec(), vertex_color_smooth(), vertex_paint_from_weight(), vertex_weight_paint_mode_poll(), blender::ed::object::vgroup_selected_get(), vpaint_mode_toggle_exec(), vpaint_stroke_test_start(), weight_sample_group_invoke(), weight_sample_invoke(), wpaint_mode_toggle_exec(), and wpaint_stroke_test_start().

◆ BKE_mesh_has_custom_loop_normals()

bool BKE_mesh_has_custom_loop_normals ( Mesh * mesh)

High-level custom normals functions.

Definition at line 459 of file blenkernel/intern/mesh.cc.

References CD_CUSTOMLOOPNORMAL, and CustomData_has_layer().

Referenced by mesh_customdata_custom_splitnormals_add_exec().

◆ BKE_mesh_is_valid()

bool BKE_mesh_is_valid ( Mesh * mesh)

Checks if a Mesh is valid without any modification. This is always verbose.

Returns
True if the mesh is valid.

Definition at line 1081 of file mesh_validate.cc.

References BKE_mesh_validate_all_customdata(), BKE_mesh_validate_arrays(), BLI_assert, CD_MDEFORMVERT, CD_MFACE, CustomData_get_layer_for_write(), blender::MutableSpan< T >::data(), blender::Span< T >::data(), is_valid, and blender::Span< T >::size().

◆ BKE_mesh_material_index_clear()

void BKE_mesh_material_index_clear ( Mesh * mesh)

◆ BKE_mesh_material_index_remove()

◆ BKE_mesh_material_index_used()

bool BKE_mesh_material_index_used ( Mesh * mesh,
short index )

◆ BKE_mesh_material_remap()

void BKE_mesh_material_remap ( Mesh * mesh,
const unsigned int * remap,
unsigned int remap_len )

◆ BKE_mesh_mdisp_flip()

void BKE_mesh_mdisp_flip ( MDisps * md,
bool use_loop_mdisp_flip )

Flip a single corner's MDisps structure, low level function to be called from face-flipping code which re-arranged the mdisps themselves.

Definition at line 464 of file mesh_evaluate.cc.

References MDisps::disps, float, int, sqrt(), swap_v3_v3(), MDisps::totdisp, UNLIKELY, x, and y.

Referenced by bmesh_kernel_loop_reverse(), and blender::bke::mesh_flip_faces().

◆ BKE_mesh_merge_customdata_for_apply_modifier()

void BKE_mesh_merge_customdata_for_apply_modifier ( Mesh * mesh)

Account for custom-data such as UVs becoming detached because of imprecision in custom-data interpolation. Without running this operation subdivision surface can cause UVs to be disconnected, see: #81065.

Definition at line 102 of file mesh_merge_customdata.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append_unchecked(), blender::Vector< T, InlineBufferCapacity, Allocator >::as_span(), CD_PROP_FLOAT2, CustomData_get_layer_n_for_write(), CustomData_number_of_layers(), blender::threading::parallel_for(), and blender::Vector< T, InlineBufferCapacity, Allocator >::reserve().

Referenced by blender::ed::object::modifier_apply_exec_ex(), and blender::ed::object::object_convert_exec().

◆ BKE_mesh_mselect_active_get()

int BKE_mesh_mselect_active_get ( const Mesh * mesh,
int type )
Returns
The index of the active element.

Definition at line 1410 of file blenkernel/intern/mesh.cc.

References BLI_assert, ELEM, ME_ESEL, ME_FSEL, and ME_VSEL.

Referenced by ED_mesh_active_dvert_get_ob().

◆ BKE_mesh_mselect_active_set()

void BKE_mesh_mselect_active_set ( Mesh * mesh,
int index,
int type )

◆ BKE_mesh_mselect_clear()

void BKE_mesh_mselect_clear ( Mesh * mesh)

◆ BKE_mesh_mselect_find()

int BKE_mesh_mselect_find ( const Mesh * mesh,
int index,
int type )
Returns
the index within me->mselect, or -1

Definition at line 1397 of file blenkernel/intern/mesh.cc.

References BLI_assert, ELEM, ME_ESEL, ME_FSEL, and ME_VSEL.

Referenced by BKE_mesh_mselect_active_set().

◆ BKE_mesh_mselect_validate()

◆ BKE_mesh_new_from_object()

Mesh * BKE_mesh_new_from_object ( Depsgraph * depsgraph,
Object * object,
bool preserve_all_data_layers,
bool preserve_origindex )

Create new mesh from the given object at its current state. The caller owns the result mesh.

If preserve_all_data_layers is true then the modifier stack is re-evaluated to ensure it preserves all possible custom data layers.

Note
Dependency graph argument is required when preserve_all_data_layers is true, and is ignored otherwise.

Definition at line 845 of file mesh_convert.cc.

References BLI_assert, depsgraph, Mesh::id, mesh_new_from_curve_type_object(), mesh_new_from_mball_object(), mesh_new_from_mesh_object(), OB_CURVES_LEGACY, OB_FONT, OB_MBALL, OB_MESH, OB_SURF, Mesh::runtime, and ID::us.

Referenced by blender::ed::object::bake(), blender::ed::object::bake_mesh_new_from_object(), BKE_mesh_new_from_object_to_bmain(), BKE_object_to_mesh(), bpy_bmesh_from_object(), blender::io::alembic::ABCMetaballWriter::get_export_mesh(), blender::io::usd::USDMetaballWriter::get_export_mesh(), lineart_object_load_single_instance(), and blender::io::obj::OBJMesh::OBJMesh().

◆ BKE_mesh_new_from_object_to_bmain()

Mesh * BKE_mesh_new_from_object_to_bmain ( Main * bmain,
Depsgraph * depsgraph,
Object * object,
bool preserve_all_data_layers )

◆ BKE_mesh_new_nomain()

Mesh * BKE_mesh_new_nomain ( int verts_num,
int edges_num,
int faces_num,
int corners_num )

Definition at line 704 of file blenkernel/intern/mesh.cc.

References BKE_idtype_idcode_to_name(), BKE_libblock_alloc(), BKE_libblock_init_empty(), BKE_mesh_face_offsets_ensure_alloc(), ID_ME, LIB_ID_CREATE_LOCALIZE, mesh, and blender::bke::mesh_ensure_required_data_layers().

Referenced by BKE_mball_polygonize(), blender::io::ply::convert_ply_to_mesh(), blender::nodes::node_geo_mesh_primitive_circle_cc::create_circle_mesh(), blender::geometry::create_cuboid_mesh(), blender::geometry::create_cylinder_or_cone_mesh(), create_empty_mesh(), blender::geometry::create_grid_mesh(), blender::geometry::create_line_mesh(), blender::io::obj::MeshFromGeometry::create_mesh(), blender::geometry::create_uv_sphere_mesh(), blender::geometry::create_vertex_mesh(), curve_calc_modifiers_post(), blender::bke::curve_to_mesh_sweep(), do_multires_bake(), blender::nodes::node_geo_duplicate_elements_cc::duplicate_edges(), blender::nodes::node_geo_duplicate_elements_cc::duplicate_faces(), blender::nodes::node_geo_duplicate_elements_cc::duplicate_points_mesh(), evaluate_surface_object(), blender::geometry::execute_realize_mesh_tasks(), blender::geometry::extract_mesh_edges(), blender::geometry::extract_mesh_faces(), blender::geometry::extract_mesh_vertices(), blender::ed::sculpt_paint::trim::generate_geometry(), blender::nodes::node_geo_points_to_vertices_cc::geometry_set_points_to_vertices(), get_quick_mesh(), hair_create_input_mesh(), blender::bke::mesh_new_no_attributes(), mesh_nurbs_displist_to_mesh(), blender::bke::modifier_modify_mesh_and_geometry_set(), blender::modify_mesh(), blender::ed::object::object_convert_exec(), blender::io::stl::read_stl_binary(), blender::io::stl::STLMeshHelper::to_mesh(), and blender::bke::bake::try_load_mesh().

◆ BKE_mesh_new_nomain_from_curve()

Mesh * BKE_mesh_new_nomain_from_curve ( const Object * ob)

These functions construct a new Mesh, contrary to BKE_mesh_to_curve_nurblist which modifies ob itself.

Definition at line 339 of file mesh_convert.cc.

References BKE_mesh_new_nomain_from_curve_displist(), and Object::runtime.

Referenced by blender::io::alembic::ABCCurveMeshWriter::get_export_mesh(), and knifeproject_poly_from_object().

◆ BKE_mesh_new_nomain_from_curve_displist()

Mesh * BKE_mesh_new_nomain_from_curve_displist ( const Object * ob,
const ListBase * dispbase )

◆ BKE_mesh_new_nomain_from_template()

◆ BKE_mesh_new_nomain_from_template_ex()

◆ BKE_mesh_nomain_to_mesh()

void BKE_mesh_nomain_to_mesh ( Mesh * mesh_src,
Mesh * mesh_dst,
Object * ob )

Move data from a mesh outside of the main data-base into a mesh in the data-base. Takes ownership of the source mesh.

Definition at line 1055 of file mesh_convert.cc.

References Mesh::active_color_attribute, BKE_id_free(), BKE_mesh_clear_geometry_and_metadata(), BKE_mesh_copy_parameters(), BLI_assert, CD_MASK_MESH, CD_SHAPEKEY, CLOG_WARN, copy_loose_edge_hint(), copy_loose_vert_hint(), copy_overlapping_hint(), Mesh::corner_data, Mesh::corners_num, CustomData_has_layer(), CustomData_init_from(), Object::data, Mesh::default_color_attribute, Mesh::edge_data, Mesh::edges_num, Mesh::face_data, Mesh::face_offset_indices, Mesh::faces_num, find_object_active_key_uid(), Key::id, Mesh::id, ID_TAG_NO_MAIN, id_us_min(), Mesh::key, LOG, move_shapekey_layers_to_keyblocks(), ID::name, Mesh::runtime, ID::tag, Mesh::vert_data, Mesh::vertex_group_names, and Mesh::verts_num.

Referenced by blender::ed::sculpt_paint::trim::apply_trim(), BKE_mesh_new_from_object_to_bmain(), blender::io::obj::MeshFromGeometry::create_mesh_object(), geometry_extract_apply(), blender::io::ply::importer_main(), blender::io::stl::importer_main(), blender::ed::object::modifier_apply_obdata(), multiresModifier_rebuild_subdiv(), blender::ed::object::object_convert_exec(), paint_mask_slice_exec(), blender::ed::object::quadriflow_start_job(), blender::io::usd::USDMeshReader::read_object_data(), blender::io::usd::USDShapeReader::read_object_data(), blender::io::alembic::AbcMeshReader::readObjectData(), blender::io::alembic::AbcSubDReader::readObjectData(), blender::ed::geometry::store_result_geometry(), and blender::ed::object::voxel_remesh_exec().

◆ BKE_mesh_nomain_to_meshkey()

◆ BKE_mesh_normals_loop_to_vertex()

void BKE_mesh_normals_loop_to_vertex ( int numVerts,
const int * corner_verts,
int numLoops,
const float(*) clnors[3],
float(*) r_vert_clnors[3] )

Computes average per-vertex normals from given custom loop normals.

Parameters
clnorsThe computed custom loop normals.
r_vert_clnorsThe (already allocated) array where to store averaged per-vertex normals.

Definition at line 1602 of file mesh_normals.cc.

References add_v3_v3(), copy_vn_fl(), MEM_calloc_arrayN, MEM_freeN(), and mul_v3_fl().

Referenced by displaceModifier_do().

◆ BKE_mesh_orco_ensure()

void BKE_mesh_orco_ensure ( Object * ob,
Mesh * mesh )

◆ BKE_mesh_orco_verts_get()

blender::Array< blender::float3 > BKE_mesh_orco_verts_get ( const Object * ob)

◆ BKE_mesh_orco_verts_transform() [1/2]

◆ BKE_mesh_orco_verts_transform() [2/2]

void BKE_mesh_orco_verts_transform ( Mesh * mesh,
float(*) orco[3],
int totvert,
bool invert )

Definition at line 1042 of file blenkernel/intern/mesh.cc.

References BKE_mesh_orco_verts_transform(), and invert().

◆ BKE_mesh_set_custom_normals()

void BKE_mesh_set_custom_normals ( Mesh * mesh,
float(*) r_custom_loop_normals[3] )

Higher level functions hiding most of the code needed around call to #normals_corner_custom_set().

Parameters
r_custom_loop_normalsis not const, since code will replace zero_v3 normals there with automatically computed vectors.

Definition at line 1576 of file mesh_normals.cc.

References blender::bke::mesh::mesh_set_custom_normals(), and normalize_vecs().

Referenced by mesh_wrapper_ensure_subdivision(), blender::io::alembic::process_loop_normals(), blender::io::stl::STLMeshHelper::to_mesh(), and MeshImporter::write_geometry().

◆ BKE_mesh_set_custom_normals_from_verts()

void BKE_mesh_set_custom_normals_from_verts ( Mesh * mesh,
float(*) r_custom_vert_normals[3] )

Higher level functions hiding most of the code needed around call to #normals_corner_custom_set_from_verts().

Parameters
r_custom_vert_normalsis not const, since code will replace zero_v3 normals there with automatically computed vectors.

Definition at line 1589 of file mesh_normals.cc.

References blender::bke::mesh::mesh_set_custom_normals(), and normalize_vecs().

Referenced by blender::io::ply::convert_ply_to_mesh(), and blender::io::alembic::process_vertex_normals().

◆ BKE_mesh_set_custom_normals_from_verts_normalized()

void BKE_mesh_set_custom_normals_from_verts_normalized ( Mesh * mesh,
float(*) r_custom_vert_normals[3] )

Definition at line 1596 of file mesh_normals.cc.

References blender::bke::mesh::mesh_set_custom_normals().

◆ BKE_mesh_set_custom_normals_normalized()

void BKE_mesh_set_custom_normals_normalized ( Mesh * mesh,
float(*) r_custom_loop_normals[3] )

◆ BKE_mesh_strip_loose_faces()

void BKE_mesh_strip_loose_faces ( Mesh * mesh)

◆ BKE_mesh_tessface_clear()

◆ BKE_mesh_texspace_calc()

◆ BKE_mesh_texspace_ensure()

◆ BKE_mesh_texspace_get()

void BKE_mesh_texspace_get ( Mesh * mesh,
float r_texspace_location[3],
float r_texspace_size[3] )

◆ BKE_mesh_texspace_get_reference()

void BKE_mesh_texspace_get_reference ( Mesh * mesh,
char ** r_texspace_flag,
float ** r_texspace_location,
float ** r_texspace_size )

◆ BKE_mesh_to_bmesh()

BMesh * BKE_mesh_to_bmesh ( Mesh * mesh,
Object * ob,
bool add_key_index,
const BMeshCreateParams * params )

◆ BKE_mesh_to_bmesh_ex()

◆ BKE_mesh_to_curve()

◆ BKE_mesh_to_curve_nurblist()

◆ BKE_mesh_to_pointcloud()

◆ BKE_mesh_transform()

void BKE_mesh_transform ( Mesh * mesh,
const float mat[4][4],
bool do_keys )

◆ BKE_mesh_translate()

◆ BKE_mesh_validate()

◆ BKE_mesh_validate_all_customdata()

bool BKE_mesh_validate_all_customdata ( CustomData * vert_data,
uint verts_num,
CustomData * edge_data,
uint edges_num,
CustomData * corner_data,
uint corners_num,
CustomData * face_data,
uint faces_num,
bool check_meshmask,
bool do_verbose,
bool do_fixes,
bool * r_change )

◆ BKE_mesh_validate_arrays()

bool BKE_mesh_validate_arrays ( Mesh * mesh,
float(*) vert_positions[3],
unsigned int verts_num,
blender::int2 * edges,
unsigned int edges_num,
MFace * legacy_faces,
unsigned int legacy_faces_num,
const int * corner_verts,
int * corner_edges,
unsigned int corners_num,
const int * face_offsets,
unsigned int faces_num,
MDeformVert * dverts,
bool do_verbose,
bool do_fixes,
bool * r_change )

◆ BKE_mesh_validate_material_indices()

bool BKE_mesh_validate_material_indices ( Mesh * mesh)

Check all material indices of faces are valid, invalid ones are set to 0.

Returns
True if the material indices are valid.

Definition at line 1134 of file mesh_validate.cc.

References DEG_id_tag_update(), blender::bke::AttributeWriter< T >::finish(), ID_RECALC_GEOMETRY_ALL_MODES, is_valid, max_ii(), and blender::bke::AttributeWriter< T >::varray.

◆ BKE_mesh_vert_normals_are_dirty()

bool BKE_mesh_vert_normals_are_dirty ( const Mesh * mesh)

Return true if the mesh vertex normals either are not stored or are dirty.

Definition at line 63 of file mesh_normals.cc.

Referenced by arrayModifier_doArray().

◆ BKE_pointcloud_to_mesh()

Variable Documentation

◆ BKE_mesh_batch_cache_dirty_tag_cb

void(* BKE_mesh_batch_cache_dirty_tag_cb) (Mesh *mesh, eMeshBatchDirtyMode mode) ( Mesh * mesh,
eMeshBatchDirtyMode mode )
extern

Definition at line 421 of file mesh_runtime.cc.

Referenced by BKE_mesh_batch_cache_dirty_tag(), and DRW_engines_register().

◆ BKE_mesh_batch_cache_free_cb

void(* BKE_mesh_batch_cache_free_cb) (void *batch_cache) ( void * batch_cache)
extern

Definition at line 422 of file mesh_runtime.cc.

Referenced by BKE_mesh_batch_cache_free(), and DRW_engines_register().