Blender V5.3
ED_mesh.hh File Reference
#include <optional>
#include <string>
#include "BKE_attribute.hh"
#include "BLI_compiler_attrs.hh"
#include "BLI_math_vector_types.hh"
#include "BLI_span.hh"
#include "BLI_virtual_array.hh"
#include "DNA_windowmanager_enums.h"

Go to the source code of this file.

Classes

class  blender::EditMeshSymmetryHelper
struct  blender::EDBMUpdate_Params
struct  blender::MirrTopoStore_t
struct  blender::BMBackup

Namespaces

namespace  blender
 BMesh Iterators.
namespace  blender::ed
namespace  blender::ed::mesh

Macros

#define ED_MESH_PICK_DEFAULT_VERT_DIST   25
#define ED_MESH_PICK_DEFAULT_FACE_DIST   1
#define USE_LOOPSLIDE_HACK

Enumerations

enum  blender::eEditMesh_PreSelPreviewAction { blender::PRESELECT_ACTION_TRANSFORM = 1 , blender::PRESELECT_ACTION_CREATE = 2 , blender::PRESELECT_ACTION_DELETE = 3 }

Functions

BMVert * blender::EDBM_vert_find_nearest_ex (ViewContext *vc, float *dist_px_manhattan_p, bool use_select_bias, bool use_cycle, Span< Base * > bases, uint *r_base_index)
BMEdge * blender::EDBM_edge_find_nearest_ex (ViewContext *vc, float *dist_px_manhattan, float *r_dist_center, bool use_select_bias, bool use_cycle, BMEdge **r_eed_zbuf, Span< Base * > bases, uint *r_base_index)
BMFace * blender::EDBM_face_find_nearest_ex (ViewContext *vc, float *dist_px_manhattan, float *r_dist_center, bool use_zbuf_single_px, bool use_select_bias, bool use_cycle, BMFace **r_efa_zbuf, Span< Base * > bases, uint *r_base_index)
bool blender::EDBM_unified_findnearest (ViewContext *vc, Span< Base * > bases, int *r_base_index, BMVert **r_eve, BMEdge **r_eed, BMFace **r_efa)
bool blender::EDBM_unified_findnearest_from_raycast (ViewContext *vc, Span< Base * > bases, bool use_boundary_vertices, bool use_boundary_edges, int *r_base_index_vert, int *r_base_index_edge, int *r_base_index_face, BMVert **r_eve, BMEdge **r_eed, BMFace **r_efa)
bool blender::EDBM_mesh_deselect_all_multi_ex (Span< Base * > bases)
bool blender::EDBM_selectmode_disable_multi_ex (Scene *scene, Span< Base * > bases, short selectmode_disable, short selectmode_fallback)
bool blender::EDBM_smooth_vert (BMesh *bm, wmOperator *op)
void blender::ED_operatortypes_mesh ()
void blender::ED_operatormacros_mesh ()
void blender::ED_keymap_mesh (wmKeyConfig *keyconf)
void blender::paintface_flush_flags (bContext *C, Object *ob, bool flush_selection, bool flush_hidden)
bool blender::paintface_mouse_select (bContext *C, const int mval[2], const SelectPick_Params &params, Object *ob)
bool blender::paintface_deselect_all_visible (bContext *C, Object *ob, int action, bool flush_flags)
void blender::paintface_select_linked (bContext *C, Object *ob, const int mval[2], bool select)
void blender::paintface_select_loop (bContext *C, Object *ob, const int mval[2], bool select)
void blender::paintface_select_more (Mesh *mesh, bool face_step)
void blender::paintface_select_less (Mesh *mesh, bool face_step)
bool blender::paintface_minmax (Object *ob, float r_min[3], float r_max[3])
void blender::paintface_hide (bContext *C, Object *ob, bool unselected)
void blender::paintface_reveal (bContext *C, Object *ob, bool select)
bool blender::paintvert_deselect_all_visible (Object *ob, int action, bool flush_flags)
void blender::paintvert_select_ungrouped (Object *ob, bool extend, bool flush_flags)
void blender::paintvert_flush_flags (Object *ob)
void blender::paintvert_tag_select_update (bContext *C, Object *ob)
void blender::paintvert_select_loop (bContext *C, Object *ob, const int mval[2], const bool select)
void blender::paintvert_select_linked (bContext *C, Object *ob)
void blender::paintvert_select_linked_pick (bContext *C, Object *ob, const int region_coordinates[2], bool select)
void blender::paintvert_select_more (Mesh *mesh, bool face_step)
void blender::paintvert_select_less (Mesh *mesh, bool face_step)
void blender::paintvert_hide (bContext *C, Object *ob, bool unselected)
void blender::paintvert_reveal (bContext *C, Object *ob, bool select)
wmOperatorStatus blender::ed::mesh::join_objects_exec (bContext *C, wmOperator *op)
int blender::mesh_get_x_mirror_vert (Object *ob, Mesh *mesh_eval, int index, bool use_topology)
BMVert * blender::editbmesh_get_x_mirror_vert (Object *ob, BMesh *bm, BMVert *eve, const float co[3], int index, bool use_topology)
int * blender::mesh_get_x_mirror_faces (Object *ob, Mesh *mesh_eval)
int blender::ED_mesh_mirror_get_vert (Object *ob, int index)
bool blender::ED_mesh_pick_vert (bContext *C, Object *ob, const int mval[2], uint dist_px, bool use_zbuf, uint *r_index)
bool blender::ED_mesh_pick_face (bContext *C, Object *ob, const int mval[2], uint dist_px, uint *r_index)
bool blender::ED_mesh_pick_face_vert (bContext *C, Object *ob, const int mval[2], uint dist_px, uint *r_index)
bool blender::ED_mesh_pick_edge (bContext *C, Object *ob, const int mval[2], uint dist_px, uint *r_index)
MDeformVert * blender::ED_mesh_active_dvert_get_em (Object *ob, BMVert **r_eve)
MDeformVert * blender::ED_mesh_active_dvert_get_ob (Object *ob, int *r_index)
MDeformVert * blender::ED_mesh_active_dvert_get_only (Object *ob)
void blender::EDBM_mesh_stats_multi (Span< Object * > objects, int totelem[3], int totelem_sel[3])
void blender::EDBM_mesh_elem_index_ensure_multi (Span< Object * > objects, char htype)
Mirror Cache API
void blender::EDBM_verts_mirror_cache_begin_ex (BMEditMesh *em, BMesh *bm, int axis, bool use_self, bool use_select, bool respecthide, bool use_topology, float maxdist, int *r_index)
void blender::EDBM_verts_mirror_cache_begin (BMEditMesh *em, BMesh *bm, int axis, bool use_self, bool use_select, bool respecthide, bool use_topology)
void blender::EDBM_verts_mirror_apply (BMEditMesh *em, BMesh *bm, int sel_from, int sel_to)
BMVert * blender::EDBM_verts_mirror_get (BMEditMesh *em, BMesh *bm, BMVert *v)
BMEdge * blender::EDBM_verts_mirror_get_edge (BMEditMesh *em, BMesh *bm, BMEdge *e)
BMFace * blender::EDBM_verts_mirror_get_face (BMEditMesh *em, BMesh *bm, BMFace *f)
void blender::EDBM_verts_mirror_cache_clear (BMEditMesh *em, BMesh *bm, BMVert *v)
void blender::EDBM_verts_mirror_cache_end (BMEditMesh *em)
Update API
void blender::EDBM_mesh_normals_update_ex (BMesh *bm, const BMeshNormalsUpdate_Params *params)
void blender::EDBM_mesh_normals_update (BMesh *bm)
void blender::EDBM_update (Mesh *mesh, const EDBMUpdate_Params *params)
void blender::EDBM_update_extern (Mesh *mesh, bool do_tessellation, bool is_destructive)
Selection Utilities
void blender::EDBM_selectmode_to_scene (bContext *C)
void blender::EDBM_select_more (BMesh *bm, short selectmode, bool use_face_step)
void blender::EDBM_select_less (BMesh *bm, short selectmode, bool use_face_step)
void blender::EDBM_selectmode_flush_ex (BMesh *bm, short selectmode)
void blender::EDBM_selectmode_flush (BMesh *bm, short selectmode)
void blender::EDBM_select_flush_from_verts (BMesh *bm, short selectmode, bool select)
void blender::EDBM_flag_enable_all (BMesh *bm, char hflag)
void blender::EDBM_flag_disable_all (BMesh *bm, char hflag)
bool blender::EDBM_uvselect_clear (BMesh *bm)
Edit BMesh API

Make/Clear/Free functions.

void blender::EDBM_mesh_make (Object *ob, int select_mode, bool add_key_index)
void blender::EDBM_mesh_make_from_mesh (Object *ob, Mesh *src_mesh, int select_mode, bool add_key_index)
void blender::EDBM_mesh_free_data (BMEditMesh *em)
void blender::EDBM_mesh_load_ex (Main *bmain, Object *ob, bool free_data)
void blender::EDBM_mesh_load (Main *bmain, Object *ob)
Hide/Reveal API
bool blender::EDBM_mesh_hide (BMesh *bm, const short selectmode, bool swap)
bool blender::EDBM_mesh_reveal (BMesh *bm, const short selectmode, bool select)
UV Vertex Map API
UvElementMap * blender::BM_uv_element_map_create (BMesh *bm, const Scene *scene, bool uv_selected, bool use_winding, bool use_seams, bool do_islands)
void blender::BM_uv_element_map_free (UvElementMap *element_map)
UvElement * blender::BM_uv_element_get (const UvElementMap *element_map, const BMLoop *l)
UvElement * blender::BM_uv_element_get_head (UvElementMap *element_map, UvElement *child)
int blender::BM_uv_element_get_unique_index (UvElementMap *element_map, UvElement *child)
UvElement ** blender::BM_uv_element_map_ensure_head_table (UvElementMap *element_map)
int * blender::BM_uv_element_map_ensure_unique_index (UvElementMap *element_map)
void blender::BM_uv_vert_map_free (UvVertMap *vmap)
UvMapVert * blender::BM_uv_vert_map_at_index (UvVertMap *vmap, unsigned int v)
UvVertMap * blender::BM_uv_vert_map_create (BMesh *bm, bool use_select, bool respect_hide)
Data Layer Checks
bool blender::EDBM_uv_check (const Mesh *mesh)
BMFace * blender::EDBM_uv_active_face_get (Mesh *mesh, bool sloppy, bool selected)
BMesh BVH API
bool blender::BMBVH_EdgeVisible (const BMBVHTree *tree, const BMEdge *e, const Depsgraph *depsgraph, const ARegion *region, const View3D *v3d, const Object *obedit)
BMesh Vertex Projection API
void blender::EDBM_project_snap_verts (bContext *C, Depsgraph *depsgraph, ARegion *region, Object *obedit)
Auto-Merge Selection

Used after transform operations.

bool blender::EDBM_automerge (Object *obedit, bool update, char hflag, float dist, bool use_centroid)
bool blender::EDBM_automerge_connected (Object *obedit, bool update, char hflag, float dist)
Auto-Merge & Split Selection

Used after transform operations.

bool blender::EDBM_automerge_and_split (Object *obedit, bool split_edges, bool split_faces, bool update, char hflag, float dist)
Implements ED Undo System
void blender::ED_mesh_undosys_type (UndoType *ut)
Select Mirror
void blender::EDBM_select_mirrored (BMEditMesh *em, Mesh *mesh, int axis, bool extend, int *r_totmirr, int *r_totfail)
Find Nearest Vert/Edge/Face
Note
Screen-space manhattan distances are used here, since its faster and good enough for the purpose of selection.
dist_bias is used so we can bias against selected items. when choosing between elements of a single type, but return the real distance to avoid the bias interfering with distance comparisons when mixing types.
BMVert * blender::EDBM_vert_find_nearest (ViewContext *vc, float *dist_px_manhattan_p)
BMEdge * blender::EDBM_edge_find_nearest (ViewContext *vc, float *dist_px_manhattan_p)
BMFace * blender::EDBM_face_find_nearest (ViewContext *vc, float *dist_px_manhattan_p)
Select Picking API

Here actual select happens, Gets called via generic mouse select operator.

bool blender::EDBM_select_pick (bContext *C, const int mval[2], const SelectPick_Params &params)
Select Mode Utilities
void blender::EDBM_selectmode_set (BMEditMesh *em, BMesh *bm, short selectmode)
void blender::EDBM_selectmode_convert (BMesh *bm, short selectmode_old, short selectmode_new)
bool blender::EDBM_selectmode_set_multi_ex (Scene *scene, Span< Object * > objects, const short selectmode)
bool blender::EDBM_selectmode_set_multi (bContext *C, short selectmode)
bool blender::EDBM_selectmode_toggle_multi (bContext *C, short selectmode_toggle, int action, bool use_extend, bool use_expand)
bool blender::EDBM_selectmode_disable (Scene *scene, BMEditMesh *em, BMesh *bm, short selectmode_disable, short selectmode_fallback)
Select Toggle
bool blender::EDBM_deselect_by_material (BMesh *bm, short index, bool select)
void blender::EDBM_select_toggle_all (BMesh *bm)
void blender::EDBM_select_swap (BMEditMesh *em, BMesh *bm)
bool blender::EDBM_mesh_deselect_all_multi (bContext *C)
bool blender::EDBM_selectmode_disable_multi (bContext *C, short selectmode_disable, short selectmode_fallback)
Select Interior Faces

Overview of the algorithm:

  • Groups faces surrounded by edges with 3+ faces using them.
  • Calculates a cost of each face group comparing its angle with the faces connected to its non-manifold edges.
  • Mark the face group as interior, and mark connected face groups for recalculation.
  • Continue to remove the face groups with the highest 'cost'.
bool blender::EDBM_select_interior_faces (BMesh *bm)
Select N'th Operator
ViewContext blender::em_setup_viewcontext (bContext *C)
Mesh Edge Ring Pre-Select
EditMesh_PreSelEdgeRing * blender::EDBM_preselect_edgering_create ()
void blender::EDBM_preselect_edgering_destroy (EditMesh_PreSelEdgeRing *psel)
void blender::EDBM_preselect_edgering_clear (EditMesh_PreSelEdgeRing *psel)
void blender::EDBM_preselect_edgering_draw (EditMesh_PreSelEdgeRing *psel, const float matrix[4][4])
void blender::EDBM_preselect_edgering_update_from_edge (EditMesh_PreSelEdgeRing *psel, BMesh *bm, BMEdge *eed_start, int previewlines, Span< float3 > vert_positions)
Mesh Element Pre-Select
EditMesh_PreSelElem * blender::EDBM_preselect_elem_create ()
void blender::EDBM_preselect_elem_destroy (EditMesh_PreSelElem *psel)
void blender::EDBM_preselect_elem_clear (EditMesh_PreSelElem *psel)
void blender::EDBM_preselect_preview_clear (EditMesh_PreSelElem *psel)
void blender::EDBM_preselect_elem_draw (EditMesh_PreSelElem *psel, const float matrix[4][4])
void blender::EDBM_preselect_elem_update_from_single (EditMesh_PreSelElem *psel, BMesh *bm, BMElem *ele, Span< float3 > vert_positions)
void blender::EDBM_preselect_elem_update_preview (EditMesh_PreSelElem *psel, ViewContext *vc, BMesh *bm, BMElem *ele, const int mval[2])
void blender::EDBM_preselect_action_set (EditMesh_PreSelElem *psel, eEditMesh_PreSelPreviewAction action)
eEditMesh_PreSelPreviewAction blender::EDBM_preselect_action_get (EditMesh_PreSelElem *psel)
Extrude Internal Utilities
bool blender::EDBM_extrude_edges_indiv (BMesh *bm, wmOperator *op, char hflag, bool use_normal_flip)
Mesh Topology Mirror API
bool blender::ED_mesh_mirrtopo_recalc_check (BMesh *bm, Mesh *mesh, MirrTopoStore_t *mesh_topo_store)
void blender::ED_mesh_mirrtopo_init (BMesh *bm, Mesh *mesh, MirrTopoStore_t *mesh_topo_store, bool skip_bm_vert_array_init)
void blender::ED_mesh_mirrtopo_free (MirrTopoStore_t *mesh_topo_store)
void blender::ED_mesh_mirror_topo_table_begin (Object *ob, Mesh *mesh_eval)
void blender::ED_mesh_mirror_topo_table_end (Object *ob)
Add Geometry
void blender::ED_mesh_verts_add (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_edges_add (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_loops_add (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_faces_add (Mesh *mesh, ReportList *reports, int count)
Remove Geometry
void blender::ED_mesh_verts_remove (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_edges_remove (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_loops_remove (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_faces_remove (Mesh *mesh, ReportList *reports, int count)
void blender::ED_mesh_geometry_clear (Mesh *mesh)
UV Layer API
bke::AttributeWriter< bool > blender::ED_mesh_uv_map_pin_layer_ensure (Mesh *mesh, int uv_index)
VArray< bool > blender::ED_mesh_uv_map_pin_layer_get (const Mesh *mesh, int uv_index)
void blender::ED_mesh_uv_ensure (Mesh *mesh, const char *name)
std::optional< std::string > blender::ED_mesh_uv_add (Mesh *mesh, const char *name, bool active_set, bool do_init, ReportList *reports)
void blender::ED_mesh_uv_loop_reset (bContext *C, Mesh *mesh)
Color Layer API
bool blender::ED_mesh_color_ensure (Mesh *mesh, const char *name)
std::optional< std::string > blender::ED_mesh_color_add (Mesh *mesh, const char *name, bool active_set, bool do_init, ReportList *reports)
Miscellaneous Public API
void blender::ED_mesh_report_mirror (ReportList &reports, int totmirr, int totfail)
void blender::ED_mesh_report_mirror_ex (ReportList &reports, int totmirr, int totfail, char selectmode)
KeyBlock * blender::ED_mesh_get_edit_shape_key (const Mesh *me)
Mesh * blender::ED_mesh_context (bContext *C)
void blender::ED_mesh_split_faces (Mesh *mesh)
Redo API
BMBackup blender::EDBM_redo_state_store (BMesh *bm)
void blender::EDBM_redo_state_restore (BMBackup *backup, BMEditMesh *em, BMesh *bm, bool recalc_looptris) ATTR_NONNULL(1
void void blender::EDBM_redo_state_restore_and_free (BMBackup *backup, BMEditMesh *em, BMesh *bm, bool recalc_looptris) ATTR_NONNULL(1
void void void blender::EDBM_redo_state_free (BMBackup *backup) ATTR_NONNULL(1)
Join as Shapes

Add vertex positions of selected meshes as shape keys to the active mesh.

wmOperatorStatus blender::ED_mesh_shapes_join_objects_exec (bContext *C, bool ensure_keys_exist, bool mirror, ReportList *reports)
Mesh Spatial Mirror API
void blender::ED_mesh_mirror_spatial_table_begin (Object *ob, Mesh *mesh_eval)
void blender::ED_mesh_mirror_spatial_table_end (Object *ob)
int blender::ED_mesh_mirror_spatial_table_lookup (Object *ob, Mesh *mesh_eval, const float co[3])

Macro Definition Documentation

◆ ED_MESH_PICK_DEFAULT_FACE_DIST

#define ED_MESH_PICK_DEFAULT_FACE_DIST   1

◆ ED_MESH_PICK_DEFAULT_VERT_DIST

◆ USE_LOOPSLIDE_HACK

#define USE_LOOPSLIDE_HACK

Definition at line 669 of file ED_mesh.hh.