mesh.cc File Reference

#include <optional>
#include "MEM_guardedalloc.h"
#include "DNA_defaults.h"
#include "DNA_key_types.h"
#include "DNA_material_types.h"
#include "DNA_mesh_types.h"
#include "DNA_meshdata_types.h"
#include "DNA_object_types.h"
#include "BLI_array_utils.hh"
#include "BLI_bounds.hh"
#include "BLI_hash.h"
#include "BLI_implicit_sharing.hh"
#include "BLI_index_range.hh"
#include "BLI_listbase.h"
#include "BLI_math_matrix.hh"
#include "BLI_math_vector.h"
#include "BLI_math_vector.hh"
#include "BLI_memory_counter.hh"
#include "BLI_resource_scope.hh"
#include "BLI_set.hh"
#include "BLI_span.hh"
#include "BLI_string.h"
#include "BLI_task.hh"
#include "BLI_time.h"
#include "BLI_utildefines.h"
#include "BLI_vector.hh"
#include "BLI_virtual_array.hh"
#include "BLT_translation.hh"
#include "BKE_anim_data.hh"
#include "BKE_anonymous_attribute_id.hh"
#include "BKE_attribute.hh"
#include "BKE_attribute_legacy_convert.hh"
#include "BKE_attribute_math.hh"
#include "BKE_attribute_storage.hh"
#include "BKE_attribute_storage_blend_write.hh"
#include "BKE_bake_data_block_id.hh"
#include "BKE_bpath.hh"
#include "BKE_deform.hh"
#include "BKE_editmesh.hh"
#include "BKE_editmesh_cache.hh"
#include "BKE_global.hh"
#include "BKE_idtype.hh"
#include "BKE_key.hh"
#include "BKE_lib_id.hh"
#include "BKE_lib_query.hh"
#include "BKE_main.hh"
#include "BKE_material.hh"
#include "BKE_mesh.hh"
#include "BKE_mesh_legacy_convert.hh"
#include "BKE_mesh_runtime.hh"
#include "BKE_mesh_wrapper.hh"
#include "BKE_modifier.hh"
#include "BKE_multires.hh"
#include "BKE_object.hh"
#include "BKE_paint_bvh.hh"
#include "DEG_depsgraph.hh"
#include "DEG_depsgraph_query.hh"
#include "BLO_read_write.hh"

Go to the source code of this file.

Classes
struct	blender::bke::NonContiguousGroup
class	VArray< T >

Namespaces
namespace	blender
namespace	blender::bke

Macros
#define	DNA_DEPRECATED_ALLOW
#define	STACK_FIXED_DEPTH   100
#define	MAT_NR_REMAP(n)

Typedefs
using	float3
using	int2

Functions
static void	mesh_tessface_clear_intern (Mesh *mesh, int free_customdata)
static void	mesh_init_data (ID *id)
static void	mesh_copy_data (Main *bmain, std::optional< Library * > owner_library, ID *id_dst, const ID *id_src, const int flag)
static void	mesh_free_data (ID *id)
static void	mesh_foreach_id (ID *id, LibraryForeachIDData *data)
static void	mesh_foreach_path (ID *id, BPathForeachPathData *bpath_data)
static void	mesh_foreach_working_space_color (ID *id, const IDTypeForeachColorFunctionCallback &fn)
static void	mesh_blend_write (BlendWriter *writer, ID *id, const void *id_address)
static void	mesh_blend_read_data (BlendDataReader *reader, ID *id)
bool	BKE_mesh_attribute_required (const StringRef name)
void	BKE_mesh_ensure_skin_customdata (Mesh *mesh)
bool	BKE_mesh_has_custom_loop_normals (Mesh *mesh)
static bool	blender::bke::meta_data_matches (const std::optional< bke::AttributeMetaData > meta_data, const AttrDomainMask domains, const eCustomDataMask types)
static Bounds< float3 >	blender::bke::merge_bounds (const Bounds< float3 > &a, const Bounds< float3 > &b)
static Bounds< float3 >	blender::bke::negative_bounds ()
static void	blender::bke::partition_faces_recursively (const Span< float3 > face_centers, MutableSpan< int > face_indices, Vector< NonContiguousGroup > &groups, int node_index, int depth, const std::optional< Bounds< float3 > > &bounds_precalc, const Span< int > material_indices, int target_group_size)
static void	blender::bke::build_vertex_groups_for_leaves (const int verts_num, const OffsetIndices< int > faces, const Span< int > corner_verts, Vector< NonContiguousGroup > &groups)
static Vector< NonContiguousGroup >	blender::bke::compute_local_mesh_groups (Mesh &mesh)
static void	mesh_clear_geometry (Mesh &mesh)
static void	clear_attribute_names (Mesh &mesh)
void	BKE_mesh_clear_geometry (Mesh *mesh)
void	BKE_mesh_clear_geometry_and_metadata (Mesh *mesh)
Mesh *	BKE_mesh_add (Main *bmain, const char *name)
void	BKE_mesh_face_offsets_ensure_alloc (Mesh *mesh)
Mesh *	BKE_mesh_new_nomain (const int verts_num, const int edges_num, const int faces_num, const int corners_num)
static void	copy_attribute_names (const Mesh &mesh_src, Mesh &mesh_dst)
void	BKE_mesh_copy_parameters (Mesh *me_dst, const Mesh *me_src)
void	BKE_mesh_copy_parameters_for_eval (Mesh *me_dst, const Mesh *me_src)
Mesh *	BKE_mesh_new_nomain_from_template_ex (const Mesh *me_src, const int verts_num, const int edges_num, const int tessface_num, const int faces_num, const int corners_num, const CustomData_MeshMasks mask)
Mesh *	BKE_mesh_new_nomain_from_template (const Mesh *me_src, const int verts_num, const int edges_num, const int faces_num, const int corners_num)
Mesh *	BKE_mesh_copy_for_eval (const Mesh &source)
BMesh *	BKE_mesh_to_bmesh_ex (const Mesh *mesh, const BMeshCreateParams *create_params, const BMeshFromMeshParams *convert_params)
BMesh *	BKE_mesh_to_bmesh (Mesh *mesh, const int active_shapekey, const bool add_key_index, const BMeshCreateParams *params)
Mesh *	BKE_mesh_from_bmesh_nomain (BMesh *bm, const BMeshToMeshParams *params, const Mesh *me_settings)
Mesh *	BKE_mesh_from_bmesh_for_eval_nomain (BMesh *bm, const CustomData_MeshMasks *cd_mask_extra, const Mesh *me_settings)
static void	ensure_orig_index_layer (CustomData &data, const int size)
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_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)
blender::Array< float3 >	BKE_mesh_orco_verts_get (const Object *ob)
void	BKE_mesh_orco_verts_transform (Mesh *mesh, MutableSpan< float3 > orco, const 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)
Mesh *	BKE_mesh_from_object (Object *ob)
void	BKE_mesh_assign_object (Main *bmain, Object *ob, Mesh *mesh)
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 uint *remap, uint remap_len)
static bool	use_bmesh_material_indices (const Mesh &mesh)
static void	blender::bke::translate_positions (MutableSpan< float3 > positions, const float3 &translation)
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])
void	BKE_mesh_eval_geometry (Depsgraph *depsgraph, Mesh *mesh)
Topology Queries
void	blender::bke::mesh_ensure_default_color_attribute_on_add (Mesh &mesh, StringRef id, AttrDomain domain, bke::AttrType data_type)
void	blender::bke::mesh_ensure_required_data_layers (Mesh &mesh)
void	blender::bke::mesh_remove_invalid_attribute_strings (Mesh &mesh)
void	blender::bke::mesh_apply_spatial_organization (Mesh &mesh)
Mesh *	blender::bke::mesh_new_no_attributes (int verts_num, int edges_num, int faces_num, int corners_num)
void	blender::bke::mesh_smooth_set (Mesh &mesh, bool use_smooth, bool keep_sharp_edges=false)
void	blender::bke::mesh_sharp_edges_set_from_angle (Mesh &mesh, float angle, bool keep_sharp_edges=false)
void	blender::bke::mesh_translate (Mesh &mesh, const float3 &translation, bool do_shape_keys)
void	blender::bke::mesh_transform (Mesh &mesh, const float4x4 &transform, bool do_shape_keys)

Variables
IDTypeInfo	IDType_ID_ME

Macro Definition Documentation

DNA_DEPRECATED_ALLOW

#define DNA_DEPRECATED_ALLOW

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

MAT_NR_REMAP

#define MAT_NR_REMAP

(

n

)

Value:

if (n < remap_len_short) { \
  BLI_assert(n >= 0 && remap[n] < remap_len_short); \
  n = remap[n]; \
} \
((void)0)

Referenced by BKE_mesh_material_remap().

STACK_FIXED_DEPTH

#define STACK_FIXED_DEPTH   100

Using STACK_FIXED_DEPTH to keep the implementation in line with pbvh.cc.

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

Referenced by blender::bke::pbvh::build_nodes_recursive_grids(), blender::bke::pbvh::build_nodes_recursive_mesh(), and blender::bke::partition_faces_recursively().

Typedef Documentation

float3

using blender::float3

Definition at line 619 of file BLI_math_vector_types.hh.

int2

using blender::int2

Definition at line 601 of file BLI_math_vector_types.hh.

Function Documentation

BKE_mesh_add()

Mesh * BKE_mesh_add	(	Main *	bmain,
		const char *	name )

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

References BKE_id_new(), and name.

Referenced by BKE_mesh_new_from_object_to_bmain(), BKE_object_obdata_add_from_type(), BKE_pointcloud_to_mesh(), blender::io::usd::USDMeshReader::create_object(), blender::io::usd::USDShapeReader::create_object(), blender::bke::tests::ArmatureDeformTestBase::create_test_mesh_object(), blender::io::ply::importer_main(), blender::io::stl::importer_main(), blender::bke::tests::MeshTestData::MeshTestData(), Freestyle::BlenderStrokeRenderer::NewMesh(), blender::io::alembic::AbcMeshReader::readObjectData(), blender::io::alembic::AbcSubDReader::readObjectData(), blender::animrig::tests::KeyframingTest::SetUp(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TwoMeshesTestData::TwoMeshesTestData(), and blender::bke::tests::WholeIDTestData::WholeIDTestData().

BKE_mesh_assign_object()

void BKE_mesh_assign_object	(	Main *	bmain,
		Object *	ob,
		Mesh *	mesh )

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

References BKE_modifiers_test_object(), BKE_object_materials_sync_length(), Object::data, Mesh::id, id_us_min(), id_us_plus(), multires_force_sculpt_rebuild(), OB_MESH, and Object::type.

Referenced by blender::animrig::tests::KeyframingTest::SetUp(), and blender::animrig::tests::TEST_F().

BKE_mesh_attribute_required()

bool BKE_mesh_attribute_required

(

const StringRef

name

)

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

References ELEM, and name.

Referenced by BKE_attribute_required().

BKE_mesh_clear_geometry()

void BKE_mesh_clear_geometry

(

Mesh *

mesh

)

Remove all geometry and derived data like caches from the mesh.

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

References BKE_mesh_runtime_clear_cache(), and mesh_clear_geometry().

Referenced by BM_mesh_bm_to_me(), and blender::ed::sculpt_paint::undo::restore_geometry_data().

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 1059 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().

BKE_mesh_copy_for_eval()

Mesh * BKE_mesh_copy_for_eval

(

const Mesh &

source

)

Performs copy for use during evaluation.

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

References BKE_id_copy_ex(), Mesh::id, and LIB_ID_COPY_LOCALIZE.

Referenced by BKE_crazyspace_build_sculpt(), BKE_multires_create_mesh(), BKE_sculpt_get_first_deform_matrices(), BKE_subdiv_to_ccg_mesh(), canvas_copyMesh(), cloth_make_rest_mesh(), blender::ed::object::convert_curves_to_mesh(), blender::ed::object::convert_mesh_to_mesh(), blender::bke::MeshComponent::copy(), blender::bke::create_orco_mesh(), deform_verts(), deform_verts(), dynamicPaint_brushMeshCalculateVelocity(), dynamicPaint_Modifier_apply(), dynamicPaint_paintMesh(), blender::bke::editbmesh_calc_modifiers(), blender::bke::MeshComponent::ensure_owns_direct_data(), blender::geometry::execute_realize_mesh_tasks(), blender::bke::MeshComponent::get_for_write(), blender::ed::geometry::get_original_geometry_eval_copy(), blender::io::usd::get_shape_key_basis_mesh(), blender::geometry::boolean::mesh_boolean_float(), blender::bke::mesh_calc_modifiers(), blender::ed::object::mesh_data_to_grease_pencil(), mesh_new_from_evaluated_curve_type_object(), mesh_new_from_mball_object(), blender::ed::object::quadriflow_start_job(), RE_bake_normal_world_to_tangent(), RE_bake_pixels_populate_from_objects(), and blender::ed::object::remesh_symmetry_bisect().

BKE_mesh_copy_parameters()

void BKE_mesh_copy_parameters	(	Mesh *	me_dst,
		const Mesh *	me_src )

Copy user editable settings that we want to preserve when a new mesh is based on an existing mesh.

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

References Mesh::attributes_active_index, copy_v3_v3(), Mesh::editflag, Mesh::face_sets_color_default, Mesh::face_sets_color_seed, Mesh::flag, Mesh::remesh_mode, Mesh::remesh_voxel_adaptivity, Mesh::remesh_voxel_size, Mesh::symmetry, Mesh::texspace_flag, Mesh::texspace_location, Mesh::texspace_size, and Mesh::vertex_group_active_index.

Referenced by BKE_id_eval_properties_copy(), BKE_mesh_copy_parameters_for_eval(), BKE_mesh_nomain_to_mesh(), BKE_mesh_remesh_voxel(), BKE_mesh_remesh_voxel(), and blender::ed::sculpt_paint::store_mesh_from_eval().

BKE_mesh_copy_parameters_for_eval()

void BKE_mesh_copy_parameters_for_eval	(	Mesh *	me_dst,
		const Mesh *	me_src )

A version of BKE_mesh_copy_parameters that is intended for evaluated output (the modifier stack for example).

Warning

User counts are not handled for ID's.

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

References BKE_defgroup_copy_list(), BKE_mesh_copy_parameters(), BLI_assert, BLI_listbase_is_empty(), copy_attribute_names(), Mesh::id, ID_TAG_COPIED_ON_EVAL, ID_TAG_NO_MAIN, Mesh::mat, MEM_dupallocN(), MEM_freeN(), Mesh::runtime, ID::tag, Mesh::totcol, and Mesh::vertex_group_names.

Referenced by BKE_mesh_from_bmesh_for_eval_nomain(), BKE_mesh_from_bmesh_nomain(), BKE_mesh_new_nomain_from_template_ex(), BKE_mesh_wrapper_from_editmesh(), create_empty_mesh(), blender::geometry::execute_realize_mesh_tasks(), blender::geometry::extract_mesh_edges(), blender::geometry::extract_mesh_faces(), blender::geometry::extract_mesh_vertices(), blender::geometry::mesh_copy_selection(), blender::geometry::mesh_copy_selection_keep_edges(), blender::geometry::mesh_copy_selection_keep_verts(), blender::geometry::mesh_triangulate(), blender::bke::modifier_modify_mesh_and_geometry_set(), modify_mesh(), blender::geometry::reorder_mesh(), and blender::bke::subdiv::subdiv_mesh_topology_info().

BKE_mesh_count_selected_items()

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

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

References bm.

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 1437 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 1443 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()

void BKE_mesh_ensure_skin_customdata

(

Mesh *

mesh

)

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

References bm, BM_data_layer_add(), BM_ITER_MESH, BM_VERTS_OF_MESH, CD_MVERT_SKIN, CD_SET_DEFAULT, CustomData_add_layer(), CustomData_bmesh_get(), CustomData_has_layer(), MVertSkin::flag, MVERT_SKIN_ROOT, and v.

Referenced by BKE_object_copy_modifier(), mesh_customdata_skin_add_exec(), blender::ed::object::modifier_add(), and blender::ed::object::skin_root_mark_exec().

BKE_mesh_eval_geometry()

void BKE_mesh_eval_geometry	(	Depsgraph *	depsgraph,
		Mesh *	mesh )

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

References BKE_id_free(), BKE_mesh_texspace_calc(), copy_v3_v3(), DEG_debug_print_eval(), DEG_get_original(), DEG_is_active(), depsgraph, ME_TEXSPACE_FLAG_AUTO_EVALUATED, Mesh::texspace_flag, Mesh::texspace_location, and Mesh::texspace_size.

Referenced by blender::deg::DepsgraphNodeBuilder::build_object_data_geometry_datablock().

BKE_mesh_face_offsets_ensure_alloc()

void BKE_mesh_face_offsets_ensure_alloc

(

Mesh *

mesh

)

Add face offsets to describe faces to a new mesh.

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

References BLI_assert, blender::implicit_sharing::info_for_mem_free(), and MEM_malloc_arrayN().

Referenced by BKE_mesh_legacy_convert_polys_to_offsets(), BKE_mesh_new_nomain(), BKE_mesh_new_nomain_from_template_ex(), blender::bm_to_mesh_faces(), and Freestyle::BlenderStrokeRenderer::GenerateStrokeMesh().

BKE_mesh_from_bmesh_for_eval_nomain()

Mesh * BKE_mesh_from_bmesh_for_eval_nomain	(	BMesh *	bm,
		const CustomData_MeshMasks *	cd_mask_extra,
		const Mesh *	me_settings )

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

References BKE_id_new_nomain(), BKE_mesh_copy_parameters_for_eval(), bm, and BM_mesh_bm_to_me_for_eval().

Referenced by base_skin(), BKE_mesh_mirror_bisect_on_mirror_plane_for_modifier(), blender::bke::create_orco_mesh(), deform_verts(), blender::io::ply::do_triangulation(), blender::io::alembic::ABCGenericMeshWriter::do_write(), blender::io::usd::USDGenericMeshWriter::do_write(), doEdgeSplit(), blender::geometry::boolean::mesh_boolean_float(), modify_mesh(), modify_mesh(), modify_mesh(), blender::nodes::node_geo_deform_curves_on_surface_cc::node_geo_exec(), subdivide_edit_mesh(), triangulate_mesh(), and WireframeModifier_do().

BKE_mesh_from_bmesh_nomain()

Mesh * BKE_mesh_from_bmesh_nomain	(	BMesh *	bm,
		const BMeshToMeshParams *	params,
		const Mesh *	me_settings )

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

References BKE_id_new_nomain(), BKE_mesh_copy_parameters_for_eval(), BLI_assert, bm, BM_mesh_bm_to_me(), and params.

Referenced by BKE_mesh_remesh_voxel_fix_poles(), geometry_extract_apply(), paint_mask_slice_exec(), and blender::ed::sculpt_paint::trim::update_normals().

BKE_mesh_from_object()

Mesh * BKE_mesh_from_object

(

Object *

ob

)

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

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

Referenced by blender::bke::build_pbvh_from_ccg(), do_paintface_box_select(), 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 568 of file blenkernel/intern/mesh.cc.

References CD_PROP_INT16_2D, and CustomData_has_layer_named().

Referenced by mesh_customdata_custom_splitnormals_add_exec().

BKE_mesh_material_index_clear()

void BKE_mesh_material_index_clear

(

Mesh *

mesh

)

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

References BKE_mesh_tessface_clear(), and blender::bke::MutableAttributeAccessor::remove().

Referenced by material_data_index_clear_id().

BKE_mesh_material_index_remove()

void BKE_mesh_material_index_remove	(	Mesh *	mesh,
		short	index )

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

References BKE_mesh_tessface_clear(), BLI_assert_unreachable, blender::bke::AttributeWriter< T >::domain, blender::bke::Face, blender::bke::AttributeWriter< T >::finish(), i, blender::MutableSpan< T >::index_range(), blender::bke::MutableAttributeAccessor::lookup_for_write(), blender::MutableVArraySpan< T >::save(), and blender::bke::AttributeWriter< T >::varray.

Referenced by material_data_index_remove_id().

BKE_mesh_material_index_used()

bool BKE_mesh_material_index_used	(	Mesh *	mesh,
		short	index )

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

References blender::Span< T >::contains(), blender::bke::Face, blender::VArrayCommon< T >::get_internal_single(), blender::VArrayCommon< T >::is_single(), and blender::bke::AttributeAccessor::lookup_or_default().

Referenced by BKE_object_material_slot_used().

BKE_mesh_material_remap()

void BKE_mesh_material_remap	(	Mesh *	mesh,
		const uint *	remap,
		uint	remap_len )

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

References BM_FACES_OF_MESH, BM_ITER_MESH, blender::bke::Face, blender::bke::SpanAttributeWriter< T >::finish(), i, blender::bke::MutableAttributeAccessor::lookup_or_add_for_write_span(), BMFace::mat_nr, MAT_NR_REMAP, and blender::bke::SpanAttributeWriter< T >::span.

Referenced by BKE_object_material_remap().

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 2013 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 )

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

References BKE_mesh_mselect_find(), BLI_assert, and MEM_reallocN.

Referenced by ed_wpaint_vertex_select_pick().

BKE_mesh_mselect_clear()

void BKE_mesh_mselect_clear

(

Mesh *

mesh

)

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

References MEM_SAFE_FREE.

Referenced by blender::ed::sculpt_paint::dyntopo::enable_ex(), and paintvert_deselect_all_visible().

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 2000 of file blenkernel/intern/mesh.cc.

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

Referenced by BKE_mesh_mselect_active_set().

BKE_mesh_mselect_validate()

void BKE_mesh_mselect_validate

(

Mesh *

mesh

)

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

References BLI_assert_unreachable, blender::bke::Edge, blender::bke::Face, MSelect::index, blender::bke::AttributeAccessor::lookup_or_default(), ME_ESEL, ME_FSEL, ME_VSEL, MEM_freeN(), MEM_malloc_arrayN(), MEM_reallocN, and blender::bke::Point.

Referenced by do_lasso_select_paintvert(), do_paintvert_box_select(), ed_wpaint_vertex_select_pick(), paint_vertsel_circle_select(), and paintvert_deselect_all_visible().

BKE_mesh_new_nomain()

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

Definition at line 1218 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, and blender::bke::mesh_ensure_required_data_layers().

Referenced by BKE_mball_polygonize(), BKE_modifier_deform_verts(), blender::ed::object::convert_curves_to_mesh(), blender::ed::object::convert_grease_pencil_to_mesh(), blender::ed::object::convert_mesh_to_mesh(), blender::io::ply::convert_ply_to_mesh(), blender::ed::object::convert_psys_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::bke::tests::ArmatureDeformTestBase::create_test_mesh(), blender::geometry::create_uv_sphere_mesh(), blender::geometry::create_vertex_mesh(), curve_calc_modifiers_post(), blender::bke::curve_to_mesh_sweep(), 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::io::fbx::import_meshes(), blender::ed::mesh::join_objects_exec(), blender::bke::mesh_new_no_attributes(), mesh_nurbs_displist_to_mesh(), blender::bke::modifier_modify_mesh_and_geometry_set(), blender::modify_mesh(), blender::io::stl::read_stl_binary(), blender::ed::geometry::store_result_geometry(), blender::io::stl::STLMeshHelper::to_mesh(), and blender::bke::bake::try_load_mesh().

BKE_mesh_new_nomain_from_template()

Mesh * BKE_mesh_new_nomain_from_template	(	const Mesh *	me_src,
		const int	verts_num,
		const int	edges_num,
		const int	faces_num,
		const int	corners_num )

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

References BKE_mesh_new_nomain_from_template_ex(), and CD_MASK_EVERYTHING.

Referenced by arrayModifier_doArray(), BKE_mesh_mirror_apply_mirror_on_axis_for_modifier(), blender::geometry::create_merged_mesh(), MOD_solidify_extrude_modifyMesh(), MOD_solidify_nonmanifold_modifyMesh(), modify_mesh(), modify_mesh(), modify_mesh(), modify_mesh(), multires_unsubdivide_to_basemesh(), blender::io::alembic::AbcMeshReader::read_mesh(), and subdivide_base().

BKE_mesh_new_nomain_from_template_ex()

Mesh * BKE_mesh_new_nomain_from_template_ex	(	const Mesh *	me_src,
		const int	verts_num,
		const int	edges_num,
		const int	tessface_num,
		const int	faces_num,
		const int	corners_num,
		const CustomData_MeshMasks	mask )

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

References BKE_id_new_nomain(), BKE_mesh_copy_parameters_for_eval(), BKE_mesh_face_offsets_ensure_alloc(), CD_MFACE, CD_SET_DEFAULT, Mesh::corner_data, Mesh::corners_num, CustomData_add_layer(), CustomData_get_layer(), CustomData_init_layout_from(), Mesh::edge_data, Mesh::edges_num, Mesh::face_data, Mesh::faces_num, Mesh::fdata_legacy, mask(), MEM_dupallocN(), blender::bke::mesh_ensure_required_data_layers(), mesh_tessface_clear_intern(), Mesh::mselect, Mesh::totface_legacy, Mesh::vert_data, and Mesh::verts_num.

Referenced by BKE_mesh_new_nomain_from_template(), cutEdges(), and explodeMesh().

BKE_mesh_orco_ensure()

void BKE_mesh_orco_ensure	(	Object *	ob,
		Mesh *	mesh )

Add a CD_ORCO layer to the Mesh if there is none already.

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

References BKE_mesh_orco_verts_get(), BKE_mesh_orco_verts_transform(), CD_CONSTRUCT, CD_ORCO, blender::MutableSpan< T >::copy_from(), CustomData_add_layer(), CustomData_has_layer(), and data.

Referenced by psys_thread_context_init_distribute().

BKE_mesh_orco_verts_get()

blender::Array< float3 > BKE_mesh_orco_verts_get

(

const Object *

ob

)

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

References Object::data, result, and blender::Span< T >::size().

Referenced by BKE_mesh_orco_ensure(), and blender::bke::get_orco_coords().

BKE_mesh_orco_verts_transform() [1/2]

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

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

References BKE_mesh_orco_verts_transform(), and invert().

BKE_mesh_orco_verts_transform() [2/2]

void BKE_mesh_orco_verts_transform	(	Mesh *	mesh,
		MutableSpan< float3 >	orco,
		const bool	invert )

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

References BKE_mesh_texspace_get(), blender::MutableSpan< T >::index_range(), invert(), and madd_v3_v3v3v3().

Referenced by BKE_mesh_orco_ensure(), and BKE_mesh_orco_verts_transform().

BKE_mesh_tessface_clear()

void BKE_mesh_tessface_clear

(

Mesh *

mesh

)

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

References mesh_tessface_clear_intern().

Referenced by BKE_mesh_material_index_clear(), BKE_mesh_material_index_remove(), BKE_sculpt_color_layer_create_if_needed(), do_versions_after_linking_280(), ED_mesh_color_ensure(), blender::ed::sculpt_paint::fill_mesh_face_or_corner_attribute(), mesh_ensure_tessellation_customdata(), and blender::bke::mesh_init_origspace().

BKE_mesh_texspace_calc()

void BKE_mesh_texspace_calc

(

Mesh *

mesh

)

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

References bounds(), copy_v3_v3(), ME_TEXSPACE_FLAG_AUTO, ME_TEXSPACE_FLAG_AUTO_EVALUATED, and mid_v3_v3v3().

Referenced by BKE_mesh_eval_geometry(), BKE_mesh_texspace_ensure(), and mesh_copy_texture_space_from_curve_type().

BKE_mesh_texspace_ensure()

void BKE_mesh_texspace_ensure

(

Mesh *

mesh

)

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

References BKE_mesh_texspace_calc(), ME_TEXSPACE_FLAG_AUTO, and ME_TEXSPACE_FLAG_AUTO_EVALUATED.

Referenced by BKE_mesh_texspace_get(), BKE_mesh_texspace_get_reference(), blender::draw::overlay::Bounds::object_sync(), psys_get_texture(), and psys_thread_context_init_distribute().

BKE_mesh_texspace_get()

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

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

References BKE_mesh_texspace_ensure(), and copy_v3_v3().

Referenced by BKE_mesh_orco_verts_transform(), create_mesh(), blender::draw::drw_volume_object_mesh_init(), mesh_texture_space(), ObjectInfos::sync(), and blender::io::hydra::VolumeModifierData::write_transform().

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 )

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

References BKE_mesh_texspace_ensure().

Referenced by BKE_object_obdata_texspace_get().

BKE_mesh_to_bmesh()

BMesh * BKE_mesh_to_bmesh	(	Mesh *	mesh,
		int	active_shapekey,
		bool	add_key_index,
		const BMeshCreateParams *	params )

Parameters

active_shapekey	See BMeshFromMeshParams::active_shapekey.
add_key_index	See BMeshFromMeshParams::add_key_index.

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

References BMeshFromMeshParams::active_shapekey, BMeshFromMeshParams::add_key_index, BKE_mesh_to_bmesh_ex(), BMeshFromMeshParams::calc_face_normal, BMeshFromMeshParams::calc_vert_normal, params, and BMeshFromMeshParams::use_shapekey.

Referenced by EDBM_mesh_make_from_mesh(), and blender::bke::tests::ArmatureDeformTestBase::edit_mesh_test().

BKE_mesh_to_bmesh_ex()

BMesh * BKE_mesh_to_bmesh_ex	(	const Mesh *	mesh,
		const BMeshCreateParams *	create_params,
		const BMeshFromMeshParams *	convert_params )

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

References bm, BM_mesh_bm_from_me(), BM_mesh_create(), and BMALLOC_TEMPLATE_FROM_ME.

Referenced by BKE_mesh_mirror_apply_mirror_on_axis(), BKE_mesh_mirror_bisect_on_mirror_plane_for_modifier(), BKE_mesh_to_bmesh(), blender::io::ply::do_triangulation(), blender::io::alembic::ABCGenericMeshWriter::do_write(), blender::io::usd::USDGenericMeshWriter::do_write(), doEdgeSplit(), modify_mesh(), modify_mesh(), triangulate_mesh(), and WireframeModifier_do().

clear_attribute_names()

void clear_attribute_names ( Mesh & mesh )

static

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

References BLI_freelistN(), and MEM_SAFE_FREE.

Referenced by BKE_mesh_clear_geometry_and_metadata().

copy_attribute_names()

void copy_attribute_names ( const Mesh & mesh_src, Mesh & mesh_dst )

static

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

References Mesh::active_color_attribute, BLI_strdup(), Mesh::default_color_attribute, and MEM_SAFE_FREE.

Referenced by BKE_mesh_copy_parameters_for_eval().

ensure_orig_index_layer()

void ensure_orig_index_layer ( CustomData & data, const int size )

static

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

References CD_ORIGINDEX, CD_SET_DEFAULT, CustomData_add_layer(), CustomData_has_layer(), data, indices, range_vn_i(), and size().

Referenced by BKE_mesh_ensure_default_orig_index_customdata_no_check().

mesh_blend_read_data()

void mesh_blend_read_data ( BlendDataReader * reader, ID * id )

static

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

References BKE_defvert_blend_read(), BLO_read_pointer_array(), BLO_read_shared(), BLO_read_string(), BLO_read_struct_array, BLO_read_struct_list, CustomData_blend_read(), ME_TEXSPACE_FLAG_AUTO_EVALUATED, and blender::bke::mesh_convert_storage_to_customdata().

mesh_blend_write()

void mesh_blend_write ( BlendWriter * writer, ID * id, const void * id_address )

static

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

References ResourceScope::allocator(), blender::bke::attribute_storage_blend_write_prepare(), blender::bke::AttributeStorage::BlendWriteData::attributes, BKE_defbase_blend_write(), BKE_id_blend_write(), BLO_write_id_struct, BLO_write_is_undo(), BLO_write_pointer_array(), BLO_write_shared(), BLO_write_shared_tag(), BLO_write_string(), BLO_write_struct_array, CD_MASK_MESH, CD_PROP_FLOAT2, blender::bke::Corner, CustomData_blend_write(), CustomData_blend_write_prepare(), CustomData_get_active_layer_name(), CustomData_get_render_layer_name(), blender::bke::Edge, blender::bke::Face, blender::bke::MeshRuntime::face_offsets_sharing_info, ID_IS_OVERRIDE_LIBRARY, blender::bke::mesh_freestyle_marks_to_legacy(), name, and blender::bke::Point.

mesh_clear_geometry()

void mesh_clear_geometry ( Mesh & mesh )

static

Note

on data that this function intentionally doesn't free:

• Materials and shape keys are not freed here (Mesh.mat & Mesh.key). As freeing shape keys requires tagging the depsgraph for updated relations, which is expensive. Material slots should be kept in sync with the object.
• Edit-Mesh (#Mesh.edit_mesh) Since edit-mesh is tied to the object's mode, which crashes when called in edit-mode. See: #90972.

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

References CustomData_free(), blender::implicit_sharing::free_shared_data(), and MEM_SAFE_FREE.

Referenced by BKE_mesh_clear_geometry(), and BKE_mesh_clear_geometry_and_metadata().

mesh_copy_data()

void mesh_copy_data ( Main * bmain, std::optional< Library * > owner_library, ID * id_dst, const ID * id_src, const int flag )

static

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

References Mesh::active_color_attribute, Mesh::active_uv_map_attribute, Mesh::attribute_storage, BKE_defgroup_copy_list(), BKE_id_copy_in_lib(), CD_MASK_DERIVEDMESH, CD_MASK_MESH, blender::implicit_sharing::copy_shared_pointer(), Mesh::corner_data, Mesh::corners_num, CustomData_init_from(), CustomData_MeshMasks_update(), Mesh::default_color_attribute, Mesh::default_uv_map_attribute, Mesh::edge_data, Mesh::edges_num, Mesh::face_data, Mesh::face_offset_indices, Mesh::faces_num, Mesh::fdata_legacy, flag, Key::id, Mesh::id, ID_TAG_NO_MAIN, Mesh::key, LIB_ID_COPY_SHAPEKEY, mask(), Mesh::mat, ME_WRAPPER_TYPE_MDATA, ME_WRAPPER_TYPE_SUBD, MEM_dupallocN(), mesh_tessface_clear_intern(), Mesh::mselect, Mesh::runtime, ID::tag, Mesh::totface_legacy, Mesh::vert_data, Mesh::vertex_group_names, and Mesh::verts_num.

mesh_foreach_id()

void mesh_foreach_id ( ID * id, LibraryForeachIDData * data )

static

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

References BKE_LIB_FOREACHID_PROCESS_IDSUPER, data, i, IDWALK_CB_NEVER_SELF, IDWALK_CB_USER, Mesh::key, Mesh::mat, Mesh::texcomesh, and Mesh::totcol.

mesh_foreach_path()

void mesh_foreach_path ( ID * id, BPathForeachPathData * bpath_data )

static

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

References BKE_bpath_foreach_path_fixed_process(), Mesh::corner_data, CustomData::external, and CustomDataExternal::filepath.

mesh_foreach_working_space_color()

void mesh_foreach_working_space_color ( ID * id, const IDTypeForeachColorFunctionCallback & fn )

static

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

References Mesh::attribute_storage, CD_PROP_COLOR, Mesh::corner_data, Mesh::corners_num, CustomDataLayer::data, Mesh::edge_data, Mesh::edges_num, Mesh::face_data, Mesh::faces_num, i, IDTypeForeachColorFunctionCallback::implicit_sharing_array, CustomData::layers, CustomDataLayer::sharing_info, size(), CustomData::totlayer, CustomDataLayer::type, Mesh::vert_data, and Mesh::verts_num.

mesh_free_data()

void mesh_free_data ( ID * id )

static

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

References Mesh::active_color_attribute, Mesh::active_uv_map_attribute, Mesh::attribute_storage, BLI_freelistN(), Mesh::corner_data, CustomData_free(), Mesh::default_color_attribute, Mesh::default_uv_map_attribute, Mesh::edge_data, Mesh::face_data, Mesh::face_offset_indices, Mesh::fdata_legacy, blender::implicit_sharing::free_shared_data(), Mesh::mat, MEM_SAFE_FREE, Mesh::mselect, Mesh::runtime, Mesh::vert_data, and Mesh::vertex_group_names.

mesh_init_data()

void mesh_init_data ( ID * id )

static

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

References Mesh::attribute_storage, BLI_assert, BLI_hash_int(), BLI_time_now_seconds_i(), Mesh::corner_data, CustomData_reset(), DNA_struct_default_get, Mesh::edge_data, Mesh::face_data, Mesh::face_sets_color_seed, Mesh::fdata_legacy, MEMCMP_STRUCT_AFTER_IS_ZERO, MEMCPY_STRUCT_AFTER, Mesh::runtime, UINT_MAX, and Mesh::vert_data.

mesh_tessface_clear_intern()

void mesh_tessface_clear_intern ( Mesh * mesh, int free_customdata )

static

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

References CustomData_free(), and CustomData_reset().

Referenced by BKE_mesh_new_nomain_from_template_ex(), BKE_mesh_tessface_clear(), and mesh_copy_data().

use_bmesh_material_indices()

bool use_bmesh_material_indices ( const Mesh & mesh )

static

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

References ME_WRAPPER_TYPE_BMESH.

Variable Documentation

IDType_ID_ME

IDTypeInfo IDType_ID_ME

Initial value:

                        = {
     Mesh::id_type,
     FILTER_ID_ME,
     FILTER_ID_ME | FILTER_ID_MA | FILTER_ID_IM | FILTER_ID_KE,
     INDEX_ID_ME,
     sizeof(Mesh),
     "Mesh",
     N_("meshes"),
     BLT_I18NCONTEXT_ID_MESH,
     IDTYPE_FLAGS_APPEND_IS_REUSABLE,
     nullptr,
 
     mesh_init_data,
     mesh_copy_data,
     mesh_free_data,
     nullptr,
     mesh_foreach_id,
     nullptr,
     mesh_foreach_path,
     mesh_foreach_working_space_color,
     nullptr,
 
     mesh_blend_write,
     mesh_blend_read_data,
     nullptr,
 
     nullptr,
 
     nullptr,
}

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