Blender V4.5
bmesh_query.cc File Reference
#include "MEM_guardedalloc.h"
#include "BLI_alloca.h"
#include "BLI_linklist.h"
#include "BLI_math_base.h"
#include "BLI_math_geom.h"
#include "BLI_math_matrix.h"
#include "BLI_math_rotation.h"
#include "BLI_math_vector.h"
#include "BLI_utildefines_stack.h"
#include "BKE_customdata.hh"
#include "bmesh.hh"
#include "intern/bmesh_private.hh"

Go to the source code of this file.

Macros

#define LOOP_VISIT   _FLAG_WALK
#define EDGE_VISIT   _FLAG_WALK

Functions

BMLoopBM_face_other_edge_loop (BMFace *f, BMEdge *e, BMVert *v)
 Other Loop in Face Sharing an Edge.
BMLoopBM_loop_other_edge_loop (BMLoop *l, BMVert *v)
BMLoopBM_face_other_vert_loop (BMFace *f, BMVert *v_prev, BMVert *v)
 Other Loop in Face Sharing a Vertex.
BMLoopBM_loop_other_vert_loop (BMLoop *l, BMVert *v)
 Other Loop in Face Sharing a Vert.
BMLoopBM_loop_other_vert_loop_by_edge (BMLoop *l, BMEdge *e)
bool BM_vert_pair_share_face_check (BMVert *v_a, BMVert *v_b)
bool BM_vert_pair_share_face_check_cb (BMVert *v_a, BMVert *v_b, bool(*test_fn)(BMFace *, void *user_data), void *user_data)
BMFaceBM_vert_pair_shared_face_cb (BMVert *v_a, BMVert *v_b, const bool allow_adjacent, bool(*callback)(BMFace *, BMLoop *, BMLoop *, void *userdata), void *user_data, BMLoop **r_l_a, BMLoop **r_l_b)
BMFaceBM_vert_pair_share_face_by_len (BMVert *v_a, BMVert *v_b, BMLoop **r_l_a, BMLoop **r_l_b, const bool allow_adjacent)
BMFaceBM_edge_pair_share_face_by_len (BMEdge *e_a, BMEdge *e_b, BMLoop **r_l_a, BMLoop **r_l_b, const bool allow_adjacent)
static float bm_face_calc_split_dot (BMLoop *l_a, BMLoop *l_b)
float BM_loop_point_side_of_loop_test (const BMLoop *l, const float co[3])
float BM_loop_point_side_of_edge_test (const BMLoop *l, const float co[3])
BMFaceBM_vert_pair_share_face_by_angle (BMVert *v_a, BMVert *v_b, BMLoop **r_l_a, BMLoop **r_l_b, const bool allow_adjacent)
BMLoopBM_vert_find_first_loop (BMVert *v)
BMLoopBM_vert_find_first_loop_visible (BMVert *v)
bool BM_vert_in_face (BMVert *v, BMFace *f)
int BM_verts_in_face_count (BMVert **varr, int len, BMFace *f)
bool BM_verts_in_face (BMVert **varr, int len, BMFace *f)
bool BM_edge_in_face (const BMEdge *e, const BMFace *f)
BMLoopBM_edge_other_loop (BMEdge *e, BMLoop *l)
BMLoopBM_vert_step_fan_loop (BMLoop *l, BMEdge **e_step)
BMEdgeBM_vert_other_disk_edge (BMVert *v, BMEdge *e_first)
float BM_edge_calc_length (const BMEdge *e)
float BM_edge_calc_length_squared (const BMEdge *e)
bool BM_edge_face_pair (BMEdge *e, BMFace **r_fa, BMFace **r_fb)
bool BM_edge_loop_pair (BMEdge *e, BMLoop **r_la, BMLoop **r_lb)
bool BM_vert_is_edge_pair (const BMVert *v)
bool BM_vert_is_edge_pair_manifold (const BMVert *v)
bool BM_vert_edge_pair (const BMVert *v, BMEdge **r_e_a, BMEdge **r_e_b)
int BM_vert_edge_count (const BMVert *v)
int BM_vert_edge_count_at_most (const BMVert *v, const int count_max)
int BM_vert_edge_count_nonwire (const BMVert *v)
int BM_edge_face_count (const BMEdge *e)
int BM_edge_face_count_at_most (const BMEdge *e, const int count_max)
int BM_vert_face_count (const BMVert *v)
int BM_vert_face_count_at_most (const BMVert *v, int count_max)
bool BM_vert_face_check (const BMVert *v)
bool BM_vert_is_wire (const BMVert *v)
bool BM_vert_is_manifold (const BMVert *v)
static int bm_loop_region_count__recursive (BMEdge *e, BMVert *v)
static int bm_loop_region_count__clear (BMLoop *l)
int BM_loop_region_loops_count_at_most (BMLoop *l, int *r_loop_total)
int BM_loop_region_loops_count (BMLoop *l)
bool BM_vert_is_manifold_region (const BMVert *v)
bool BM_edge_is_convex (const BMEdge *e)
bool BM_edge_is_contiguous_loop_cd (const BMEdge *e, const int cd_loop_type, const int cd_loop_offset)
bool BM_vert_is_boundary (const BMVert *v)
int BM_face_share_face_count (BMFace *f_a, BMFace *f_b)
bool BM_face_share_face_check (BMFace *f_a, BMFace *f_b)
int BM_face_share_edge_count (BMFace *f_a, BMFace *f_b)
bool BM_face_share_edge_check (BMFace *f_a, BMFace *f_b)
int BM_face_share_vert_count (BMFace *f_a, BMFace *f_b)
bool BM_face_share_vert_check (BMFace *f_a, BMFace *f_b)
bool BM_loop_share_edge_check (BMLoop *l_a, BMLoop *l_b)
bool BM_edge_share_face_check (BMEdge *e1, BMEdge *e2)
bool BM_edge_share_quad_check (BMEdge *e1, BMEdge *e2)
bool BM_edge_share_vert_check (BMEdge *e1, BMEdge *e2)
BMVertBM_edge_share_vert (BMEdge *e1, BMEdge *e2)
BMLoopBM_edge_vert_share_loop (BMLoop *l, BMVert *v)
 Return the Loop Shared by Edge and Vert.
BMLoopBM_face_vert_share_loop (BMFace *f, BMVert *v)
 Return the Loop Shared by Face and Vertex.
BMLoopBM_face_edge_share_loop (BMFace *f, BMEdge *e)
 Return the Loop Shared by Face and Edge.
void BM_edge_ordered_verts_ex (const BMEdge *edge, BMVert **r_v1, BMVert **r_v2, const BMLoop *edge_loop)
void BM_edge_ordered_verts (const BMEdge *edge, BMVert **r_v1, BMVert **r_v2)
BMLoopBM_loop_find_prev_nodouble (BMLoop *l, BMLoop *l_stop, const float eps_sq)
BMLoopBM_loop_find_next_nodouble (BMLoop *l, BMLoop *l_stop, const float eps_sq)
bool BM_loop_is_convex (const BMLoop *l)
float BM_loop_calc_face_angle (const BMLoop *l)
float BM_loop_calc_face_normal_safe_ex (const BMLoop *l, const float epsilon_sq, float r_normal[3])
 BM_loop_calc_face_normal.
float BM_loop_calc_face_normal_safe_vcos_ex (const BMLoop *l, const float normal_fallback[3], float const (*vertexCos)[3], const float epsilon_sq, float r_normal[3])
float BM_loop_calc_face_normal_safe (const BMLoop *l, float r_normal[3])
float BM_loop_calc_face_normal_safe_vcos (const BMLoop *l, const float normal_fallback[3], float const (*vertexCos)[3], float r_normal[3])
float BM_loop_calc_face_normal (const BMLoop *l, float r_normal[3])
 BM_loop_calc_face_normal.
void BM_loop_calc_face_direction (const BMLoop *l, float r_dir[3])
 BM_loop_calc_face_direction.
void BM_loop_calc_face_tangent (const BMLoop *l, float r_tangent[3])
 BM_loop_calc_face_tangent.
float BM_edge_calc_face_angle_ex (const BMEdge *e, const float fallback)
 BMESH EDGE/FACE ANGLE.
float BM_edge_calc_face_angle (const BMEdge *e)
float BM_edge_calc_face_angle_with_imat3_ex (const BMEdge *e, const float imat3[3][3], const float fallback)
 BMESH EDGE/FACE ANGLE.
float BM_edge_calc_face_angle_with_imat3 (const BMEdge *e, const float imat3[3][3])
float BM_edge_calc_face_angle_signed_ex (const BMEdge *e, const float fallback)
 BMESH EDGE/FACE ANGLE.
float BM_edge_calc_face_angle_signed (const BMEdge *e)
void BM_edge_calc_face_tangent (const BMEdge *e, const BMLoop *e_loop, float r_tangent[3])
 BMESH EDGE/FACE TANGENT.
float BM_vert_calc_edge_angle_ex (const BMVert *v, const float fallback)
 BMESH VERT/EDGE ANGLE.
float BM_vert_calc_edge_angle (const BMVert *v)
float BM_vert_calc_shell_factor (const BMVert *v)
float BM_vert_calc_shell_factor_ex (const BMVert *v, const float no[3], const char hflag)
float BM_vert_calc_median_tagged_edge_length (const BMVert *v)
BMLoopBM_face_find_shortest_loop (BMFace *f)
BMLoopBM_face_find_longest_loop (BMFace *f)
BMEdgeBM_edge_exists (BMVert *v_a, BMVert *v_b)
BMEdgeBM_edge_find_double (BMEdge *e)
BMLoopBM_edge_find_first_loop_visible (BMEdge *e)
BMFaceBM_face_exists (BMVert *const *varr, int len)
BMFaceBM_face_find_double (BMFace *f)
bool BM_face_exists_multi (BMVert **varr, BMEdge **earr, int len)
bool BM_face_exists_multi_edge (BMEdge **earr, int len)
BMFaceBM_face_exists_overlap (BMVert **varr, const int len)
bool BM_face_exists_overlap_subset (BMVert **varr, const int len)
bool BM_vert_is_all_edge_flag_test (const BMVert *v, const char hflag, const bool respect_hide)
bool BM_vert_is_all_face_flag_test (const BMVert *v, const char hflag, const bool respect_hide)
bool BM_edge_is_all_face_flag_test (const BMEdge *e, const char hflag, const bool respect_hide)
bool BM_edge_is_any_face_flag_test (const BMEdge *e, const char hflag)
bool BM_edge_is_any_vert_flag_test (const BMEdge *e, const char hflag)
bool BM_face_is_any_vert_flag_test (const BMFace *f, const char hflag)
bool BM_face_is_any_edge_flag_test (const BMFace *f, const char hflag)
bool BM_edge_is_any_face_len_test (const BMEdge *e, const int len)
bool BM_face_is_normal_valid (const BMFace *f)
static double bm_mesh_calc_volume_face (const BMFace *f)
double BM_mesh_calc_volume (BMesh *bm, bool is_signed)
int BM_mesh_calc_face_groups (BMesh *bm, int *r_groups_array, int(**r_group_index)[2], BMLoopFilterFunc filter_fn, BMLoopPairFilterFunc filter_pair_fn, void *user_data, const char hflag_test, const char htype_step)
int BM_mesh_calc_edge_groups (BMesh *bm, int *r_groups_array, int(**r_group_index)[2], BMVertFilterFunc filter_fn, void *user_data, const char hflag_test)
int BM_mesh_calc_edge_groups_as_arrays (BMesh *bm, BMVert **verts, BMEdge **edges, BMFace **faces, int(**r_groups)[3])
float bmesh_subd_falloff_calc (const int falloff, float val)

Detailed Description

This file contains functions for answering common Topological and geometric queries about a mesh, such as, "What is the angle between these two faces?" or, "How many faces are incident upon this vertex?" Tool authors should use the functions in this file instead of inspecting the mesh structure directly.

Definition in file bmesh_query.cc.

Macro Definition Documentation

◆ EDGE_VISIT

#define EDGE_VISIT   _FLAG_WALK

Definition at line 773 of file bmesh_query.cc.

◆ LOOP_VISIT

#define LOOP_VISIT   _FLAG_WALK

Definition at line 772 of file bmesh_query.cc.

Function Documentation

◆ BM_edge_calc_face_angle()

float BM_edge_calc_face_angle ( const BMEdge * e)

◆ BM_edge_calc_face_angle_ex()

float BM_edge_calc_face_angle_ex ( const BMEdge * e,
float fallback )

BMESH EDGE/FACE ANGLE.

Calculates the angle between two faces. Assumes the face normals are correct.

Returns
angle in radians

Definition at line 1339 of file bmesh_query.cc.

References angle_normalized_v3v3(), BM_edge_calc_face_angle_ex(), BM_edge_is_manifold(), e, BMLoop::f, and BMFace::no.

Referenced by BM_edge_calc_face_angle(), BM_edge_calc_face_angle_ex(), BM_loop_is_adjacent(), bpy_bmedge_calc_face_angle(), and edbm_beautify_fill_exec().

◆ BM_edge_calc_face_angle_signed()

float BM_edge_calc_face_angle_signed ( const BMEdge * e)

◆ BM_edge_calc_face_angle_signed_ex()

float BM_edge_calc_face_angle_signed_ex ( const BMEdge * e,
float fallback )

BMESH EDGE/FACE ANGLE.

Calculates the angle between two faces. Assumes the face normals are correct.

Returns
angle in radians

Definition at line 1379 of file bmesh_query.cc.

References angle(), angle_normalized_v3v3(), BM_edge_calc_face_angle_signed_ex(), BM_edge_is_convex(), BM_edge_is_manifold(), e, BMLoop::f, and BMFace::no.

Referenced by BM_edge_calc_face_angle_signed(), BM_edge_calc_face_angle_signed_ex(), BM_loop_is_adjacent(), bpy_bmedge_calc_face_angle_signed(), and tri_corner_test().

◆ BM_edge_calc_face_angle_with_imat3()

float BM_edge_calc_face_angle_with_imat3 ( const BMEdge * e,
const float imat3[3][3] )

◆ BM_edge_calc_face_angle_with_imat3_ex()

float BM_edge_calc_face_angle_with_imat3_ex ( const BMEdge * e,
const float imat3[3][3],
float fallback )

BMESH EDGE/FACE ANGLE.

Calculates the angle between two faces in world space. Assumes the face normals are correct.

Returns
angle in radians

Definition at line 1353 of file bmesh_query.cc.

References angle_normalized_v3v3(), BM_edge_calc_face_angle_with_imat3_ex(), BM_edge_is_manifold(), copy_v3_v3(), e, BMLoop::f, mul_transposed_m3_v3(), BMFace::no, and normalize_v3().

Referenced by BM_edge_calc_face_angle_with_imat3(), BM_edge_calc_face_angle_with_imat3_ex(), and BM_loop_is_adjacent().

◆ BM_edge_calc_face_tangent()

void BM_edge_calc_face_tangent ( const BMEdge * e,
const BMLoop * e_loop,
float r_tangent[3] )

BMESH EDGE/FACE TANGENT.

Calculate the tangent at this loop corner or fallback to the face normal on straight lines. This vector always points inward into the face.

BM_edge_calc_face_tangent

Parameters
e
e_loopThe loop to calculate the tangent at, used to get the face and winding direction.
r_tangentThe loop corner tangent to set

Definition at line 1394 of file bmesh_query.cc.

References BM_edge_calc_face_tangent(), BM_edge_ordered_verts_ex(), BMVert::co, cross_v3_v3v3(), e, BMLoop::f, BMFace::no, normalize_v3(), sub_v3_v3v3(), and v2.

Referenced by BM_edge_calc_face_tangent(), BM_loop_is_adjacent(), bm_vert_boundary_tangent(), bm_vert_calc_surface_tangent(), bmo_face_inset_individual(), bmo_inset_region_exec(), and bpy_bmedge_calc_tangent().

◆ BM_edge_calc_length()

◆ BM_edge_calc_length_squared()

◆ BM_edge_exists()

BMEdge * BM_edge_exists ( BMVert * v_a,
BMVert * v_b )

Returns the edge existing between v_a and v_b, or nullptr if there isn't one.

Note
multiple edges may exist between any two vertices, and therefore this function only returns the first one found.

Definition at line 1564 of file bmesh_query.cc.

References BLI_assert, BM_edge_exists(), BM_VERT, BM_vert_in_edge(), bmesh_disk_edge_next(), BMVert::e, BMVert::head, and BMHeader::htype.

Referenced by bev_rebuild_polygon(), bevel_build_edge_polygons(), BKE_mesh_remesh_voxel_fix_poles(), BM_edge_create(), BM_edge_exists(), BM_edge_rotate(), BM_edge_rotate_check_degenerate(), BM_edgeloop_edges_get(), bm_edgeloop_flag_set(), bm_edgenet_path_calc_best(), bm_edgering_pair_order(), bm_edgering_pair_order_is_flipped(), BM_edges_from_verts(), bm_face_connect_verts(), BM_face_create_ngon_verts(), BM_face_other_vert_loop(), bm_face_split_edge_find(), BM_face_split_edgenet_connect_islands(), bm_grid_fill(), bm_isect_edge_tri(), bm_isect_tri_tri(), BM_loop_is_adjacent(), bm_loop_pair_from_verts(), BM_mesh_intersect(), BM_mesh_intersect_edges(), BM_mesh_wireframe(), bm_vert_connect_select_history(), bm_vert_loop_pair(), BM_vert_splice_check_double(), bmesh_kernel_join_edge_kill_vert(), bmesh_kernel_join_vert_kill_edge(), bmo_extrude_face_region_exec(), bmo_subdivide_edges_exec(), bmo_triangle_fill_exec(), bmo_weld_verts_exec(), bmw_EdgeLoopWalker_step(), bpy_bm_utils_vert_splice(), bpy_bmedgeseq_get__method(), bpy_bmedgeseq_new(), bridge_loop_pair(), build_hull(), edbm_add_edge_face_exec__tricky_extend_sel(), EDBM_verts_mirror_get_edge(), blender::ed::transform::getTransformOrientation_ex(), is_vertex_diagonal(), knife_add_single_cut(), knife_make_face_cuts(), blender::bke::pbvh::merge_face_edge_data(), blender::bke::pbvh::merge_flap_edge_data(), blender::bke::pbvh::pbvh_bmesh_collapse_short_edges(), blender::bke::pbvh::pbvh_bmesh_subdivide_long_edges(), remdoubles_createface(), blender::ed::transform::transform_mesh_edge_slide_data_create(), and weld_cross_attrs_copy().

◆ BM_edge_face_count()

◆ BM_edge_face_count_at_most()

int BM_edge_face_count_at_most ( const BMEdge * e,
const int count_max )

◆ BM_edge_face_pair()

bool BM_edge_face_pair ( BMEdge * e,
BMFace ** r_fa,
BMFace ** r_fb )

◆ BM_edge_find_double()

BMEdge * BM_edge_find_double ( BMEdge * e)

Returns an edge sharing the same vertices as this one. This isn't an invalid state but tools should clean up these cases before returning the mesh to the user.

Definition at line 1592 of file bmesh_query.cc.

References BM_edge_find_double(), BM_vert_in_edge(), bmesh_disk_edge_next(), e, UNLIKELY, and v.

Referenced by bm_decim_edge_collapse(), BM_edge_find_double(), BM_face_split_edgenet_connect_islands(), BM_loop_is_adjacent(), BM_mesh_edgesplit(), and bmo_spin_exec().

◆ BM_edge_find_first_loop_visible()

BMLoop * BM_edge_find_first_loop_visible ( BMEdge * e)

Only BMEdge.l access us needed, however when we want the first visible loop, a utility function is needed.

Definition at line 1609 of file bmesh_query.cc.

References BM_edge_find_first_loop_visible(), BM_elem_flag_test, BM_ELEM_HIDDEN, e, BMLoop::f, and BMLoop::radial_next.

Referenced by BM_edge_find_first_loop_visible(), and BM_edge_other_vert().

◆ BM_edge_in_face()

◆ BM_edge_is_all_face_flag_test()

bool BM_edge_is_all_face_flag_test ( const BMEdge * e,
const char hflag,
const bool respect_hide )

◆ BM_edge_is_any_face_flag_test()

bool BM_edge_is_any_face_flag_test ( const BMEdge * e,
const char hflag )

◆ BM_edge_is_any_face_len_test()

bool BM_edge_is_any_face_len_test ( const BMEdge * e,
const int len )

◆ BM_edge_is_any_vert_flag_test()

bool BM_edge_is_any_vert_flag_test ( const BMEdge * e,
const char hflag )

◆ BM_edge_is_contiguous_loop_cd()

bool BM_edge_is_contiguous_loop_cd ( const BMEdge * e,
int cd_loop_type,
int cd_loop_offset )

◆ BM_edge_is_convex()

bool BM_edge_is_convex ( const BMEdge * e)

◆ BM_edge_loop_pair()

◆ BM_edge_ordered_verts()

◆ BM_edge_ordered_verts_ex()

void BM_edge_ordered_verts_ex ( const BMEdge * edge,
BMVert ** r_v1,
BMVert ** r_v2,
const BMLoop * edge_loop )

Returns the verts of an edge as used in a face if used in a face at all, otherwise just assign as used in the edge.

Useful to get a deterministic winding order when calling BM_face_create_ngon() on an arbitrary array of verts, though be sure to pick an edge which has a face.

Note
This is in fact quite a simple check, mainly include this function so the intent is more obvious. We know these 2 verts will always make up the loops edge

Definition at line 1140 of file bmesh_query.cc.

References BLI_assert, BM_edge_ordered_verts_ex(), BMLoop::e, BMLoop::next, and BMLoop::v.

Referenced by BM_edge_calc_face_tangent(), BM_edge_ordered_verts(), BM_edge_ordered_verts_ex(), BM_loop_is_adjacent(), and bmo_inset_region_exec().

◆ BM_edge_other_loop()

BMLoop * BM_edge_other_loop ( BMEdge * e,
BMLoop * l )

Given a edge and a loop (assumes the edge is manifold). returns the other faces loop, sharing the same vertex.

+-------------------+
|                   |
|                   |
|l_other <-- return |
+-------------------+ <-- A manifold edge between 2 faces
|l    e  <-- edge   |
|^ <-------- loop   |
|                   |
+-------------------+

Definition at line 444 of file bmesh_query.cc.

References BLI_assert, BM_edge_other_loop(), BM_vert_in_edge(), BMLoop::e, e, l, BMLoop::next, BMLoop::prev, BMLoop::radial_next, and BMLoop::v.

Referenced by BM_edge_other_loop(), BM_edge_other_vert(), bm_extrude_copy_face_loop_attributes(), bm_loop_customdata_merge(), BM_vert_step_fan_loop(), bmo_inset_region_exec(), and edbm_tagged_loop_pairs_do_fill_faces().

◆ BM_edge_pair_share_face_by_len()

◆ BM_edge_share_face_check()

◆ BM_edge_share_quad_check()

bool BM_edge_share_quad_check ( BMEdge * e1,
BMEdge * e2 )

◆ BM_edge_share_vert()

BMVert * BM_edge_share_vert ( BMEdge * e1,
BMEdge * e2 )

Return the shared vertex between the two edges or NULL

Definition at line 1089 of file bmesh_query.cc.

References BLI_assert, BM_edge_share_vert(), BM_vert_in_edge(), BMEdge::v1, and BMEdge::v2.

Referenced by bm_edge_collapse(), BM_edge_share_vert(), BM_loop_is_adjacent(), BM_verts_from_edges(), and edbm_tagged_loop_pairs_do_fill_faces().

◆ BM_edge_share_vert_check()

bool BM_edge_share_vert_check ( BMEdge * e1,
BMEdge * e2 )

◆ BM_edge_vert_share_loop()

BMLoop * BM_edge_vert_share_loop ( BMLoop * l,
BMVert * v )

Return the Loop Shared by Edge and Vert.

Finds the loop used which uses in face loop l

Note
this function takes a loop rather than an edge so we can select the face that the loop should be from.

Definition at line 1101 of file bmesh_query.cc.

References BLI_assert, BM_edge_vert_share_loop(), BM_vert_in_edge(), BMLoop::e, l, BMLoop::next, BMLoop::v, and v.

Referenced by BM_edge_vert_share_loop(), BM_loop_is_adjacent(), and edbm_rip_invoke__vert().

◆ bm_face_calc_split_dot()

float bm_face_calc_split_dot ( BMLoop * l_a,
BMLoop * l_b )
static

◆ BM_face_edge_share_loop()

◆ BM_face_exists()

BMFace * BM_face_exists ( BMVert *const * varr,
int len )

◆ BM_face_exists_multi()

bool BM_face_exists_multi ( BMVert ** varr,
BMEdge ** earr,
int len )

Given a set of vertices and edges (varr, earr), find out if all those vertices are filled in by existing faces that only use those vertices.

This is for use in cases where creating a face is possible but would result in many overlapping faces.

An example of how this is used: when 2 triangles are selected that share an edge, pressing F-key would make a new overlapping quad (without a check like this)

earr and varr can be in any order, however they must form a closed loop.

Definition at line 1703 of file bmesh_query.cc.

References BM_EDGES_OF_VERT, BM_elem_flag_disable, BM_elem_flag_enable, BM_elem_flag_test, BM_ELEM_INTERNAL_TAG, BM_face_exists_multi(), BM_FACES_OF_EDGE, BM_ITER_ELEM, BM_VERTS_OF_FACE, e, i, len(), and v.

Referenced by bm_edgenet_face_from_path(), BM_face_exists_multi(), BM_face_exists_multi_edge(), and BM_loop_is_adjacent().

◆ BM_face_exists_multi_edge()

bool BM_face_exists_multi_edge ( BMEdge ** earr,
int len )

◆ BM_face_exists_overlap()

BMFace * BM_face_exists_overlap ( BMVert ** varr,
int len )

Given a set of vertices (varr), find out if all those vertices overlap an existing face.

Note
The face may contain other verts not in varr.
Its possible there are more than one overlapping faces, in this case the first one found will be returned.
Parameters
varrArray of unordered verts.
lenvarr array length.
Returns
The face or NULL.

Definition at line 1825 of file bmesh_query.cc.

References _FLAG_OVERLAP, BLI_assert, BLI_linklist_prepend_alloca, BM_ELEM_API_FLAG_DISABLE, BM_ELEM_API_FLAG_ENABLE, BM_ELEM_API_FLAG_TEST, BM_face_exists_overlap(), BM_FACES_OF_VERT, BM_ITER_ELEM, BM_verts_in_face_count(), i, len(), LinkNode::link, and LinkNode::next.

Referenced by BM_face_exists_overlap(), and BM_loop_is_adjacent().

◆ BM_face_exists_overlap_subset()

bool BM_face_exists_overlap_subset ( BMVert ** varr,
int len )

Given a set of vertices (varr), find out if there is a face that uses vertices only from this list (that the face is a subset or made from the vertices given).

Parameters
varrArray of unordered verts.
lenvarr array length.

Definition at line 1863 of file bmesh_query.cc.

References _FLAG_OVERLAP, BLI_assert, BLI_linklist_prepend_alloca, BM_ELEM_API_FLAG_DISABLE, BM_ELEM_API_FLAG_ENABLE, BM_ELEM_API_FLAG_TEST, BM_face_exists_overlap_subset(), BM_FACE_FIRST_LOOP, BM_FACES_OF_VERT, BM_ITER_ELEM, i, BMFace::len, len(), LinkNode::link, BMLoop::next, LinkNode::next, and BMLoop::v.

Referenced by bm_edgenet_path_check_overlap(), BM_face_exists_overlap_subset(), and BM_loop_is_adjacent().

◆ BM_face_find_double()

BMFace * BM_face_find_double ( BMFace * f)

◆ BM_face_find_longest_loop()

◆ BM_face_find_shortest_loop()

BMLoop * BM_face_find_shortest_loop ( BMFace * f)

Returns the loop of the shortest edge in f.

Definition at line 1498 of file bmesh_query.cc.

References BM_face_find_shortest_loop(), BM_FACE_FIRST_LOOP, BMVert::co, FLT_MAX, len_squared_v3v3(), BMLoop::next, and BMLoop::v.

Referenced by BM_face_find_shortest_loop(), BM_loop_is_adjacent(), and collapse_face_corners().

◆ BM_face_is_any_edge_flag_test()

bool BM_face_is_any_edge_flag_test ( const BMFace * f,
const char hflag )

◆ BM_face_is_any_vert_flag_test()

bool BM_face_is_any_vert_flag_test ( const BMFace * f,
const char hflag )

◆ BM_face_is_normal_valid()

◆ BM_face_other_edge_loop()

BMLoop * BM_face_other_edge_loop ( BMFace * f,
BMEdge * e,
BMVert * v )

Other Loop in Face Sharing an Edge.

Finds the other loop that shares v with e loop in f.

    +----------+
    |          |
    |    f     |
    |          |
    +----------+ <-- return the face loop of this vertex.
    v --> e
    ^     ^ <------- These vert args define direction
                     in the face to check.
                     The faces loop direction is ignored.
Note
caller must ensure e is used in f

Definition at line 32 of file bmesh_query.cc.

References BLI_assert, BM_face_edge_share_loop(), BM_face_other_edge_loop(), BM_loop_other_edge_loop(), e, l, and v.

Referenced by BM_edge_other_vert(), and BM_face_other_edge_loop().

◆ BM_face_other_vert_loop()

BMLoop * BM_face_other_vert_loop ( BMFace * f,
BMVert * v_prev,
BMVert * v )

Other Loop in Face Sharing a Vertex.

Finds the other loop in a face.

This function returns a loop in f that shares an edge with v The direction is defined by v_prev, where the return value is the loop of what would be 'v_next'

    +----------+ <-- return the face loop of this vertex.
    |          |
    |    f     |
    |          |
    +----------+
    v_prev --> v
    ^^^^^^     ^ <-- These vert args define direction
                     in the face to check.
                     The faces loop direction is ignored.
Note
v_prev and v implicitly define an edge.

Definition at line 45 of file bmesh_query.cc.

References BLI_assert, BM_edge_exists(), BM_face_other_vert_loop(), BM_face_vert_share_loop(), BMLoop::next, BMLoop::prev, BMLoop::v, and v.

Referenced by BM_edge_calc_rotate(), BM_edge_other_vert(), BM_edge_rotate_check(), BM_edge_rotate_check_degenerate(), BM_face_other_vert_loop(), BM_loop_other_vert_loop(), bmw_EdgeLoopWalker_step(), and edbm_rip_edge_side_measure().

◆ BM_face_share_edge_check()

bool BM_face_share_edge_check ( BMFace * f_a,
BMFace * f_b )

◆ BM_face_share_edge_count()

int BM_face_share_edge_count ( BMFace * f_a,
BMFace * f_b )

Counts the number of edges two faces share (if any)

Definition at line 978 of file bmesh_query.cc.

References BM_edge_in_face(), BM_FACE_FIRST_LOOP, BM_face_share_edge_count(), BMLoop::e, and BMLoop::next.

Referenced by BM_face_share_edge_count(), BM_loop_is_adjacent(), and bmesh_kernel_join_face_kill_edge().

◆ BM_face_share_face_check()

bool BM_face_share_face_check ( BMFace * f_a,
BMFace * f_b )

◆ BM_face_share_face_count()

int BM_face_share_face_count ( BMFace * f_a,
BMFace * f_b )

Returns the number of faces that are adjacent to both f1 and f2,

Note
Could be sped up a bit by not using iterators and by tagging faces on either side, then count the tags rather then searching.

Definition at line 943 of file bmesh_query.cc.

References BM_EDGES_OF_FACE, BM_face_share_edge_check(), BM_face_share_face_count(), BM_FACES_OF_EDGE, BM_ITER_ELEM, and e.

Referenced by BM_face_share_face_count(), and BM_loop_is_adjacent().

◆ BM_face_share_vert_check()

bool BM_face_share_vert_check ( BMFace * f_a,
BMFace * f_b )

Returns true if the faces share a vert.

Definition at line 1025 of file bmesh_query.cc.

References BM_FACE_FIRST_LOOP, BM_face_share_vert_check(), BM_vert_in_face(), BMLoop::next, and BMLoop::v.

Referenced by BM_face_share_vert_check(), and BM_loop_is_adjacent().

◆ BM_face_share_vert_count()

int BM_face_share_vert_count ( BMFace * f_a,
BMFace * f_b )

Counts the number of verts two faces share (if any).

Definition at line 1009 of file bmesh_query.cc.

References BM_FACE_FIRST_LOOP, BM_face_share_vert_count(), BM_vert_in_face(), BMLoop::next, and BMLoop::v.

Referenced by BM_face_share_vert_count(), bm_face_split_by_edges_island_connect(), and BM_loop_is_adjacent().

◆ BM_face_vert_share_loop()

◆ BM_loop_calc_face_angle()

float BM_loop_calc_face_angle ( const BMLoop * l)

Calculates the angle between the previous and next loops (angle at this loops face corner).

Returns
angle in radians

Definition at line 1202 of file bmesh_query.cc.

References angle_v3v3v3(), BM_loop_calc_face_angle(), BMVert::co, l, BMLoop::next, BMLoop::prev, and BMLoop::v.

Referenced by BM_loop_calc_face_angle(), BM_loop_is_adjacent(), BM_mesh_wireframe(), BM_vert_calc_shell_factor(), BM_vert_calc_shell_factor_ex(), bpy_bmloop_calc_angle(), and edbm_average_normals_exec().

◆ BM_loop_calc_face_direction()

void BM_loop_calc_face_direction ( const BMLoop * l,
float r_dir[3] )

BM_loop_calc_face_direction.

Calculate the direction a loop is pointing.

Parameters
lThe loop to calculate the direction at
r_dirResulting direction

Definition at line 1294 of file bmesh_query.cc.

References add_v3_v3v3(), BM_loop_calc_face_direction(), BMVert::co, l, BMLoop::next, normalize_v3(), BMLoop::prev, sub_v3_v3v3(), and BMLoop::v.

Referenced by BM_loop_calc_face_direction(), BM_loop_is_adjacent(), and blender::ed::transform::isect_face_dst().

◆ BM_loop_calc_face_normal()

float BM_loop_calc_face_normal ( const BMLoop * l,
float r_normal[3] )

BM_loop_calc_face_normal.

Calculate the normal at this loop corner or fall back to the face normal on straight lines.

Parameters
lThe loop to calculate the normal at
r_normalResulting normal
Returns
The length of the cross product (double the area).

Definition at line 1280 of file bmesh_query.cc.

References BM_loop_calc_face_normal(), BMVert::co, copy_v3_v3(), cross_v3_v3v3(), BMLoop::f, l, len(), BMLoop::next, BMFace::no, normalize_v3(), BMLoop::prev, sub_v3_v3v3(), UNLIKELY, BMLoop::v, and v2.

Referenced by BM_loop_calc_face_normal(), BM_loop_is_adjacent(), and bpy_bmloop_calc_normal().

◆ BM_loop_calc_face_normal_safe()

float BM_loop_calc_face_normal_safe ( const BMLoop * l,
float r_normal[3] )

BM_loop_calc_face_normal_safe_ex with predefined sane epsilon.

Since this doesn't scale based on triangle size, fixed value works well.

Definition at line 1266 of file bmesh_query.cc.

References BM_loop_calc_face_normal_safe(), BM_loop_calc_face_normal_safe_ex(), and l.

Referenced by BM_loop_calc_face_normal_safe(), BM_loop_is_adjacent(), and blender::draw::statvis_calc_distort().

◆ BM_loop_calc_face_normal_safe_ex()

float BM_loop_calc_face_normal_safe_ex ( const BMLoop * l,
float epsilon_sq,
float r_normal[3] )

BM_loop_calc_face_normal.

Calculate the normal at this loop corner or fall back to the face normal on straight lines.

Parameters
lThe loop to calculate the normal at.
epsilon_sqValue to avoid numeric errors (1e-5f works well).
r_normalResulting normal.

Definition at line 1207 of file bmesh_query.cc.

References BM_loop_calc_face_normal_safe_ex(), BMVert::co, copy_v3_v3(), cross_v3_v3v3(), BMLoop::f, is_zero_v3(), l, len_squared_v3(), mul_v3_v3fl(), BMLoop::next, BMFace::no, normalize_v3(), BMLoop::prev, sub_v3_v3(), sub_v3_v3v3(), BMLoop::v, and v2.

Referenced by BM_loop_calc_face_normal_safe(), BM_loop_calc_face_normal_safe_ex(), and BM_loop_is_adjacent().

◆ BM_loop_calc_face_normal_safe_vcos()

float BM_loop_calc_face_normal_safe_vcos ( const BMLoop * l,
const float normal_fallback[3],
float const (*) vertexCos[3],
float r_normal[3] )

◆ BM_loop_calc_face_normal_safe_vcos_ex()

float BM_loop_calc_face_normal_safe_vcos_ex ( const BMLoop * l,
const float normal_fallback[3],
float const (*) vertexCos[3],
float epsilon_sq,
float r_normal[3] )

◆ BM_loop_calc_face_tangent()

void BM_loop_calc_face_tangent ( const BMLoop * l,
float r_tangent[3] )

BM_loop_calc_face_tangent.

Calculate the tangent at this loop corner or fall back to the face normal on straight lines. This vector always points inward into the face.

Parameters
lThe loop to calculate the tangent at
r_tangentResulting tangent

Definition at line 1309 of file bmesh_query.cc.

References add_v3_v3v3(), BM_loop_calc_face_tangent(), BMVert::co, compare_v3v3(), cross_v3_v3v3(), dot_v3v3(), BMLoop::f, l, negate_v3(), BMLoop::next, BMFace::no, normalize_v3(), BMLoop::prev, sub_v3_v3v3(), UNLIKELY, and BMLoop::v.

Referenced by BM_loop_calc_face_tangent(), BM_loop_is_adjacent(), BM_mesh_wireframe(), bpy_bmloop_calc_tangent(), and edbm_calc_loop_co().

◆ BM_loop_find_next_nodouble()

BMLoop * BM_loop_find_next_nodouble ( BMLoop * l,
BMLoop * l_stop,
float eps_sq )
Returns
The next loop, over eps_sq distance from l (or NULL if l_stop is reached).

Definition at line 1173 of file bmesh_query.cc.

References BLI_assert, BM_loop_find_next_nodouble(), BMVert::co, ELEM, l, len_squared_v3v3(), BMLoop::next, UNLIKELY, and BMLoop::v.

Referenced by BM_loop_find_next_nodouble(), BM_loop_is_adjacent(), and blender::ed::transform::mesh_customdatacorrect_init_vert().

◆ BM_loop_find_prev_nodouble()

BMLoop * BM_loop_find_prev_nodouble ( BMLoop * l,
BMLoop * l_stop,
float eps_sq )
Returns
The previous loop, over eps_sq distance from l (or NULL if l_stop is reached).

Definition at line 1156 of file bmesh_query.cc.

References BLI_assert, BM_loop_find_prev_nodouble(), BMVert::co, ELEM, l, len_squared_v3v3(), BMLoop::prev, UNLIKELY, and BMLoop::v.

Referenced by BM_loop_find_prev_nodouble(), BM_loop_is_adjacent(), and blender::ed::transform::mesh_customdatacorrect_init_vert().

◆ BM_loop_is_convex()

bool BM_loop_is_convex ( const BMLoop * l)

Check if the loop is convex or concave (depends on face normal)

Definition at line 1190 of file bmesh_query.cc.

References BM_loop_is_convex(), BMVert::co, cross_v3_v3v3(), dot_v3v3(), BMLoop::f, l, BMLoop::next, BMFace::no, BMLoop::prev, sub_v3_v3v3(), and BMLoop::v.

Referenced by BM_edge_is_contiguous(), bm_face_convex_tag_verts(), BM_loop_is_convex(), and bpy_bmloop_is_convex_get().

◆ BM_loop_other_edge_loop()

◆ BM_loop_other_vert_loop()

BMLoop * BM_loop_other_vert_loop ( BMLoop * l,
BMVert * v )

Other Loop in Face Sharing a Vert.

Finds the other loop that shares v with e loop in f.

    +----------+ <-- return the face loop of this vertex.
    |          |
    |          |
    |          |
    +----------+ <-- This vertex defines the direction.
          l    v
          ^ <------- This loop defines both the face to search
                     and the edge, in combination with 'v'
                     The faces loop direction is ignored.

Definition at line 67 of file bmesh_query.cc.

References BLI_assert, BM_edge_other_vert(), BM_face_other_vert_loop(), BM_loop_other_vert_loop(), BMLoop::e, e, BMLoop::f, l, BMLoop::next, BMLoop::prev, BMLoop::v, and v.

Referenced by BM_edge_other_vert(), BM_loop_other_vert_loop(), BM_vert_other_disk_edge(), and bmo_inset_region_exec().

◆ BM_loop_other_vert_loop_by_edge()

BMLoop * BM_loop_other_vert_loop_by_edge ( BMLoop * l,
BMEdge * e )

Return the other loop that uses this edge.

In this case the loop defines the vertex, the edge passed in defines the direction to step.

    +----------+ <-- Return the face-loop of this vertex.
    |          |
    |        e | <-- This edge defines the direction.
    |          |
    +----------+ <-- This loop defines the face and vertex..
               l

Definition at line 92 of file bmesh_query.cc.

References BLI_assert, BM_loop_other_vert_loop_by_edge(), BM_vert_in_edge(), BMLoop::e, e, l, BMLoop::next, BMLoop::prev, and BMLoop::v.

Referenced by BM_edge_other_vert(), BM_edge_uv_share_vert_check(), and BM_loop_other_vert_loop_by_edge().

◆ BM_loop_point_side_of_edge_test()

float BM_loop_point_side_of_edge_test ( const BMLoop * l,
const float co[3] )

Check if a point is inside the edge defined by a loop (within the plane defined by the loops edge & face normal).

Returns
signed, squared distance to the edge plane, less than 0.0 when outside.

Definition at line 246 of file bmesh_query.cc.

References BM_loop_point_side_of_edge_test(), BMVert::co, cross_v3_v3v3(), dist_signed_squared_to_plane_v3(), dot_v3v3(), BMLoop::f, l, BMLoop::next, BMFace::no, sub_v3_v3v3(), and BMLoop::v.

Referenced by BM_loop_is_adjacent(), BM_loop_point_side_of_edge_test(), and knife_add_single_cut__is_linehit_outside_face().

◆ BM_loop_point_side_of_loop_test()

float BM_loop_point_side_of_loop_test ( const BMLoop * l,
const float co[3] )

Check if a point is inside the corner defined by a loop (within the 2 planes defined by the loops corner & face normal).

Returns
signed, squared distance to the loops planes, less than 0.0 when outside.

Definition at line 240 of file bmesh_query.cc.

References BM_loop_point_side_of_loop_test(), BMVert::co, dist_signed_squared_to_corner_v3v3v3(), BMLoop::f, l, BMLoop::next, BMFace::no, BMLoop::prev, and BMLoop::v.

Referenced by BM_loop_is_adjacent(), BM_loop_point_side_of_loop_test(), and knife_add_single_cut__is_linehit_outside_face().

◆ bm_loop_region_count__clear()

◆ bm_loop_region_count__recursive()

◆ BM_loop_region_loops_count()

int BM_loop_region_loops_count ( BMLoop * l)

◆ BM_loop_region_loops_count_at_most()

int BM_loop_region_loops_count_at_most ( BMLoop * l,
int * r_loop_total )

◆ BM_loop_share_edge_check()

bool BM_loop_share_edge_check ( BMLoop * l_a,
BMLoop * l_b )

Returns true when 2 loops share an edge (are adjacent in the face-fan)

Definition at line 1040 of file bmesh_query.cc.

References BLI_assert, BM_loop_share_edge_check(), BMLoop::e, ELEM, l_b, BMLoop::prev, and BMLoop::v.

Referenced by BM_loop_is_adjacent(), BM_loop_share_edge_check(), facetag_add_adjacent(), and facetag_add_adjacent_uv().

◆ BM_mesh_calc_edge_groups()

◆ BM_mesh_calc_edge_groups_as_arrays()

◆ BM_mesh_calc_face_groups()

◆ BM_mesh_calc_volume()

double BM_mesh_calc_volume ( BMesh * bm,
bool is_signed )

◆ bm_mesh_calc_volume_face()

double bm_mesh_calc_volume_face ( const BMFace * f)
static

Use to accumulate volume calculation for faces with consistent winding.

Use double precision since this is prone to float precision error, see #73295.

Definition at line 2059 of file bmesh_query.cc.

References BLI_array_alloca, BM_face_calc_tessellation(), bm_mesh_calc_volume_face(), BMVert::co, copy_v3db_v3fl(), cross, cross_v3_v3v3_db(), dot_v3v3_db(), BMFace::len, and BMLoop::v.

Referenced by BM_mesh_calc_volume(), and bm_mesh_calc_volume_face().

◆ BM_vert_calc_edge_angle()

float BM_vert_calc_edge_angle ( const BMVert * v)

◆ BM_vert_calc_edge_angle_ex()

float BM_vert_calc_edge_angle_ex ( const BMVert * v,
float fallback )

BMESH VERT/EDGE ANGLE.

Calculates the angle a verts 2 edges.

Returns
the angle in radians

Definition at line 1407 of file bmesh_query.cc.

References angle_v3v3v3(), BM_edge_other_vert(), BM_vert_calc_edge_angle_ex(), bmesh_disk_edge_next(), BMVert::co, BMVert::e, M_PI, v, and v2.

Referenced by BM_loop_is_adjacent(), BM_vert_calc_edge_angle(), BM_vert_calc_edge_angle_ex(), and bpy_bmvert_calc_edge_angle().

◆ BM_vert_calc_median_tagged_edge_length()

float BM_vert_calc_median_tagged_edge_length ( const BMVert * v)
Note
quite an obscure function. used in bmesh operators that have a relative scale options,

Definition at line 1478 of file bmesh_query.cc.

References BM_edge_calc_length(), BM_edge_other_vert(), BM_EDGES_OF_VERT, BM_elem_flag_test, BM_ELEM_TAG, BM_ITER_ELEM_INDEX, BM_vert_calc_median_tagged_edge_length(), e, length(), and v.

Referenced by BM_loop_is_adjacent(), BM_mesh_wireframe(), and BM_vert_calc_median_tagged_edge_length().

◆ BM_vert_calc_shell_factor()

float BM_vert_calc_shell_factor ( const BMVert * v)
Note
this isn't optimal to run on an array of verts, see 'solidify_add_thickness' for a function which runs on an array.

Definition at line 1431 of file bmesh_query.cc.

References BM_ITER_ELEM, BM_loop_calc_face_angle(), BM_LOOPS_OF_VERT, BM_vert_calc_shell_factor(), BMLoop::f, l, BMFace::no, BMVert::no, shell_v3v3_normalized_to_dist(), and v.

Referenced by BM_loop_is_adjacent(), BM_vert_calc_shell_factor(), BM_vert_calc_shell_factor_ex(), bmo_inset_region_exec(), and bpy_bmvert_calc_shell_factor().

◆ BM_vert_calc_shell_factor_ex()

◆ BM_vert_edge_count()

int BM_vert_edge_count ( const BMVert * v)

Returns the number of edges around this vertex.

Definition at line 615 of file bmesh_query.cc.

References BM_vert_edge_count(), bmesh_disk_count(), and v.

Referenced by BKE_mesh_remesh_voxel_fix_poles(), BM_vert_edge_count(), and similar_vert_select_exec().

◆ BM_vert_edge_count_at_most()

int BM_vert_edge_count_at_most ( const BMVert * v,
const int count_max )

◆ BM_vert_edge_count_nonwire()

◆ BM_vert_edge_pair()

bool BM_vert_edge_pair ( const BMVert * v,
BMEdge ** r_e_a,
BMEdge ** r_e_b )

◆ BM_vert_face_check()

bool BM_vert_face_check ( const BMVert * v)

Return true if the vertex is connected to any faces.

same as BM_vert_face_count(v) != 0 or BM_vert_find_first_loop(v) == NULL.

Definition at line 682 of file bmesh_query.cc.

References BM_vert_face_check(), bmesh_disk_edge_next(), BMVert::e, BMEdge::l, and v.

Referenced by bevel_vert_two_edges(), BM_vert_face_check(), and blender::bke::pbvh::pbvh_bmesh_collapse_edge().

◆ BM_vert_face_count()

int BM_vert_face_count ( const BMVert * v)

Returns the number of faces around this vert length matches BM_LOOPS_OF_VERT iterator

Definition at line 672 of file bmesh_query.cc.

References BM_vert_face_count(), bmesh_disk_facevert_count(), and v.

Referenced by BM_vert_face_count(), bmo_pointmerge_facedata_exec(), bmw_EdgeLoopWalker_begin(), and similar_vert_select_exec().

◆ BM_vert_face_count_at_most()

int BM_vert_face_count_at_most ( const BMVert * v,
int count_max )

◆ BM_vert_find_first_loop()

◆ BM_vert_find_first_loop_visible()

BMLoop * BM_vert_find_first_loop_visible ( BMVert * v)

◆ BM_vert_in_face()

◆ BM_vert_is_all_edge_flag_test()

bool BM_vert_is_all_edge_flag_test ( const BMVert * v,
const char hflag,
const bool respect_hide )

◆ BM_vert_is_all_face_flag_test()

bool BM_vert_is_all_face_flag_test ( const BMVert * v,
const char hflag,
const bool respect_hide )

◆ BM_vert_is_boundary()

◆ BM_vert_is_edge_pair()

◆ BM_vert_is_edge_pair_manifold()

bool BM_vert_is_edge_pair_manifold ( const BMVert * v)

Fast alternative to (BM_vert_edge_count(v) == 2) that checks both edges connect to the same faces.

Definition at line 586 of file bmesh_query.cc.

References BM_DISK_EDGE_NEXT, BM_edge_is_manifold(), BM_vert_is_edge_pair_manifold(), BMVert::e, e, and v.

Referenced by bm_loop_pair_ends(), bm_loop_region_test_chain(), BM_vert_is_edge_pair_manifold(), bm_vert_pair_ends(), bm_vert_region_test_chain(), mesh_calc_path_region_elem(), and mesh_calc_path_region_elem().

◆ BM_vert_is_manifold()

bool BM_vert_is_manifold ( const BMVert * v)

A vertex is non-manifold if it meets the following conditions: 1: Loose - (has no edges/faces incident upon it). 2: Joins two distinct regions - (two pyramids joined at the tip). 3: Is part of an edge with more than 2 faces. 4: Is part of a wire edge.

Definition at line 713 of file bmesh_query.cc.

References BLI_assert, BM_edge_is_boundary(), BM_vert_is_manifold(), BM_vert_step_fan_loop(), bmesh_disk_edge_next(), BMLoop::e, BMVert::e, BMEdge::l, BMLoop::next, BMLoop::radial_next, BMLoop::v, and v.

Referenced by BM_disk_dissolve(), BM_edge_is_wire(), BM_vert_dissolve(), BM_vert_is_manifold(), bpy_bmvert_is_manifold_get(), calc_solidify_normals(), edbm_select_by_pole_count_exec(), and edbm_select_non_manifold_exec().

◆ BM_vert_is_manifold_region()

bool BM_vert_is_manifold_region ( const BMVert * v)

A version of BM_vert_is_manifold which only checks if we're connected to multiple isolated regions.

Definition at line 855 of file bmesh_query.cc.

References BM_loop_region_loops_count_at_most(), BM_vert_find_first_loop(), BM_vert_is_manifold_region(), and v.

Referenced by BM_edge_is_wire(), BM_vert_is_manifold_region(), and edbm_rip_invoke__vert().

◆ BM_vert_is_wire()

bool BM_vert_is_wire ( const BMVert * v)

Tests whether or not the vertex is part of a wire edge. (ie: has no faces attached to it)

Definition at line 696 of file bmesh_query.cc.

References BM_vert_is_wire(), bmesh_disk_edge_next(), BMVert::e, BMEdge::l, and v.

Referenced by bm_vert_connect_select_history(), BM_vert_is_wire(), bpy_bmvert_is_wire_get(), edbm_polybuild_delete_at_cursor_invoke(), edbm_rip_invoke__vert(), and unsubdivide_is_all_quads().

◆ BM_vert_other_disk_edge()

BMEdge * BM_vert_other_disk_edge ( BMVert * v,
BMEdge * e )

The function takes a vertex at the center of a fan and returns the opposite edge in the fan. All edges in the fan must be manifold, otherwise return NULL.

Note
This could (probably) be done more efficiently.

Definition at line 490 of file bmesh_query.cc.

References BLI_assert, BM_edge_is_manifold(), BM_loop_other_vert_loop(), BM_vert_in_edge(), BM_vert_other_disk_edge(), BMLoop::e, i, BMEdge::l, BMLoop::prev, BMLoop::radial_next, and v.

Referenced by BM_vert_other_disk_edge(), and edbm_rip_invoke__edge().

◆ BM_vert_pair_share_face_by_angle()

BMFace * BM_vert_pair_share_face_by_angle ( BMVert * v_a,
BMVert * v_b,
BMLoop ** r_l_a,
BMLoop ** r_l_b,
bool allow_adjacent )

Given 2 verts, find a face they share that has the lowest angle across these verts and give back both loops.

This can be better than BM_vert_pair_share_face_by_len because concave splits are ranked lowest.

Definition at line 259 of file bmesh_query.cc.

References bm_face_calc_split_dot(), BM_face_vert_share_loop(), BM_ITER_ELEM, BM_loop_is_adjacent(), BM_LOOPS_OF_VERT, BM_vert_pair_share_face_by_angle(), dot(), BMVert::e, BMLoop::f, and l_b.

Referenced by BM_face_splits_check_optimal(), BM_vert_pair_share_face_by_angle(), and BM_vert_pair_shared_face_cb().

◆ BM_vert_pair_share_face_by_len()

BMFace * BM_vert_pair_share_face_by_len ( BMVert * v_a,
BMVert * v_b,
BMLoop ** r_l_a,
BMLoop ** r_l_b,
bool allow_adjacent )

Given 2 verts, find the smallest face they share and give back both loops.

Definition at line 172 of file bmesh_query.cc.

References BM_face_vert_share_loop(), BM_ITER_ELEM, BM_loop_is_adjacent(), BM_LOOPS_OF_VERT, BM_vert_pair_share_face_by_len(), BMVert::e, BMLoop::f, l_b, and BMFace::len.

Referenced by BM_vert_pair_share_face_by_len(), BM_vert_pair_shared_face_cb(), and connect_smallest_face().

◆ BM_vert_pair_share_face_check()

bool BM_vert_pair_share_face_check ( BMVert * v_a,
BMVert * v_b )

◆ BM_vert_pair_share_face_check_cb()

bool BM_vert_pair_share_face_check_cb ( BMVert * v_a,
BMVert * v_b,
bool(* test_fn )(BMFace *, void *user_data),
void * user_data )

◆ BM_vert_pair_shared_face_cb()

BMFace * BM_vert_pair_shared_face_cb ( BMVert * v_a,
BMVert * v_b,
const bool allow_adjacent,
bool(* callback )(BMFace *, BMLoop *, BMLoop *, void *userdata),
void * user_data,
BMLoop ** r_l_a,
BMLoop ** r_l_b )

◆ BM_vert_step_fan_loop()

BMLoop * BM_vert_step_fan_loop ( BMLoop * l,
BMEdge ** e_step )

Utility function to step around a fan of loops, using an edge to mark the previous side.

Note
all edges must be manifold, once a non manifold edge is hit, return NULL.
,.,-->|
_,-' |
,' | (notice how 'e_step'
/ | and 'l' define the
/ | direction the arrow
| return | points).
| loop --> |
---------------------+---------------------
^ l --> |
| |
assign e_step |
|
begin e_step ----> |
|

Definition at line 469 of file bmesh_query.cc.

References BLI_assert, BM_edge_is_manifold(), BM_edge_other_loop(), BM_vert_step_fan_loop(), BMLoop::e, l, and BMLoop::prev.

Referenced by bevel_harden_normals(), bm_edge_collapse_loop_customdata(), BM_edge_other_vert(), BM_loop_check_cyclic_smooth_fan(), bm_mesh_loops_calc_normals_for_loop(), BM_vert_is_manifold(), BM_vert_step_fan_loop(), edbm_average_normals_exec(), and normals_split().

◆ BM_verts_in_face()

bool BM_verts_in_face ( BMVert ** varr,
int len,
BMFace * f )

Return true if all verts are in the face.

Definition at line 378 of file bmesh_query.cc.

References _FLAG_OVERLAP, BM_ELEM_API_FLAG_DISABLE, BM_ELEM_API_FLAG_ENABLE, BM_ELEM_API_FLAG_TEST, BM_verts_in_face(), i, BMFace::l_first, BMFace::len, len(), BMLoop::next, and BMLoop::v.

Referenced by BM_verts_in_face().

◆ BM_verts_in_face_count()

int BM_verts_in_face_count ( BMVert ** varr,
int len,
BMFace * f )

Compares the number of vertices in an array that appear in a given face

Definition at line 338 of file bmesh_query.cc.

References _FLAG_OVERLAP, BM_ELEM_API_FLAG_DISABLE, BM_ELEM_API_FLAG_ENABLE, BM_ELEM_API_FLAG_TEST, BM_verts_in_face_count(), i, BMFace::l_first, len(), BMLoop::next, and BMLoop::v.

Referenced by BM_face_exists_overlap(), and BM_verts_in_face_count().

◆ bmesh_subd_falloff_calc()