Blender V5.3
bmesh_uvselect.cc File Reference
#include "MEM_guardedalloc.h"
#include "DNA_scene_types.h"
#include "BLI_listbase.hh"
#include "BLI_math_bits.hh"
#include "bmesh.hh"
#include "bmesh_structure.hh"

Go to the source code of this file.

Namespaces

namespace  blender
 BMesh Iterators.

Functions

Internal Utilities
static void blender::bm_mesh_uvselect_disable_all (BMesh *bm)
UV Selection Functions (low level)

Selection checking functions. These should be used instead of checking BM_ELEM_SELECT_UV, so hidden geometry is never considered selected.

bool blender::BM_loop_vert_uvselect_test (const BMLoop *l)
bool blender::BM_loop_edge_uvselect_test (const BMLoop *l)
bool blender::BM_face_uvselect_test (const BMFace *f)
UV Selection Connectivity Checks

Regarding the hflag parameter: this is typically set to:

Each function asserts that a supported hflag is passed in.

bool blender::BM_loop_vert_uvselect_check_other_loop_vert (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_loop_vert_uvselect_check_other_loop_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_loop_vert_uvselect_check_other_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_loop_vert_uvselect_check_other_face (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_loop_edge_uvselect_check_other_loop_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_loop_edge_uvselect_check_other_face (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool blender::BM_face_uvselect_check_edges_all (BMFace *f)
UV Selection Functions
void blender::BM_loop_vert_uvselect_set_noflush (BMesh *bm, BMLoop *l, bool select)
void blender::BM_loop_edge_uvselect_set_noflush (BMesh *bm, BMLoop *l, bool select)
void blender::BM_loop_edge_uvselect_set (BMesh *bm, BMLoop *l, bool select)
void blender::BM_face_uvselect_set_noflush (BMesh *bm, BMFace *f, bool select)
void blender::BM_face_uvselect_set (BMesh *bm, BMFace *f, bool select)
bool blender::BM_mesh_uvselect_clear (BMesh *bm)
UV Selection Functions (Shared)
void blender::BM_loop_vert_uvselect_set_shared (BMesh *bm, BMLoop *l, bool select, const int cd_loop_uv_offset)
void blender::BM_loop_edge_uvselect_set_shared (BMesh *bm, BMLoop *l, bool select, const int cd_loop_uv_offset)
void blender::BM_face_uvselect_set_shared (BMesh *bm, BMFace *f, bool select, const int cd_loop_uv_offset)
void blender::BM_mesh_uvselect_set_elem_shared (BMesh *bm, bool select, const int cd_loop_uv_offset, const Span< BMLoop * > loop_verts, const Span< BMLoop * > loop_edges, const Span< BMFace * > faces)
UV Selection Picking Versions of Selection Functions

These functions differ in that they perform all necessary flushing but do so only on local elements. This is only practical with a small number of elements since it'd be inefficient on large selections.

Note that we could also support selecting face-corners from the 3D viewport using these functions, however that's not yet supported.

Selection Modes & Flushing

Picking an edge in face-select mode or a vertex in edge-select mode is not supported. This is logical because the user cannot select a single vertex in face select mode. As these functions are exposed publicly for picking, this makes some sense.

Internally however, these functions are currently used by BM_mesh_uvselect_set_elem_from_mesh, which corrects "isolated" elements which should not be selected based on the selection-mode.

static void blender::bm_vert_uvselect_set_pick (BMesh *bm, BMVert *v, const bool select, const BMUVSelectPickParams &, bool caller_handles_edge_or_face_mode)
static void blender::bm_edge_uvselect_set_pick (BMesh *bm, BMEdge *e, const bool select, const BMUVSelectPickParams &uv_pick_params, const bool caller_handles_face_mode)
static void blender::bm_face_uvselect_set_pick (BMesh *bm, BMFace *f, const bool select, const BMUVSelectPickParams &uv_pick_params)
void blender::BM_vert_uvselect_set_pick (BMesh *bm, BMVert *v, bool select, const BMUVSelectPickParams &params)
void blender::BM_edge_uvselect_set_pick (BMesh *bm, BMEdge *e, bool select, const BMUVSelectPickParams &params)
void blender::BM_face_uvselect_set_pick (BMesh *bm, BMFace *f, bool select, const BMUVSelectPickParams &params)
static void blender::bm_mesh_uvselect_mode_flush_down_deselect_only (BMesh *bm, const short select_mode, const int cd_loop_uv_offset, const bool shared, const bool check_verts, const bool check_edges)
void blender::BM_mesh_uvselect_set_elem_from_mesh (BMesh *bm, bool select, const BMUVSelectPickParams &params, const VectorList< BMVert * > &verts, const VectorList< BMEdge * > &edges, const VectorList< BMFace * > &faces)
void blender::BM_mesh_uvselect_set_elem_from_mesh (BMesh *bm, bool select, const BMUVSelectPickParams &params, Span< BMVert * > verts, Span< BMEdge * > edges, Span< BMFace * > faces)
UV Selection Flushing (Only Select/De-Select)
Note
In most cases flushing assumes selection has already been flushed down.

This means:

  • A selected edge must have both UV vertices selected.
  • A selected faces has all its edges & vertices selected.

It's often useful to call BM_mesh_uvselect_flush_shared_only_select after using these non-UV-coordinate aware flushing functions.

void blender::BM_mesh_uvselect_flush_from_loop_verts_only_select (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_loop_verts_only_deselect (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_loop_edges_only_select (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_loop_edges_only_deselect (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_faces_only_select (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_faces_only_deselect (BMesh *bm)
void blender::BM_mesh_uvselect_flush_shared_only_select (BMesh *bm, const int cd_loop_uv_offset)
void blender::BM_mesh_uvselect_flush_shared_only_deselect (BMesh *bm, const int cd_loop_uv_offset)
UV Selection Flushing (Between Elements)

Regarding the flush_down argument.

Primitive UV selection functions always flush down:

This means it's often only necessary to flush up after the selection has been changed.

void blender::BM_mesh_uvselect_flush_from_loop_verts (BMesh *bm)
void blender::BM_mesh_uvselect_flush_from_loop_edges (BMesh *bm, bool flush_down)
void blender::BM_mesh_uvselect_flush_from_faces (BMesh *bm, bool flush_down)
void blender::BM_mesh_uvselect_flush_from_verts (BMesh *bm, const bool select)
UV Selection Flushing (Selection Mode Aware)
void blender::BM_mesh_uvselect_mode_flush_ex (BMesh *bm, const short selectmode, const bool flush_down)
void blender::BM_mesh_uvselect_mode_flush (BMesh *bm)
void blender::BM_mesh_uvselect_mode_flush_only_select (BMesh *bm)
void blender::BM_mesh_uvselect_mode_flush_update (BMesh *bm, const short selectmode_old, const short selectmode_new, const int cd_loop_uv_offset)
void blender::BM_mesh_uvselect_flush_post_subdivide (BMesh *bm, const int cd_loop_uv_offset)
UV Selection Flushing (From/To Mesh)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode (BMesh *bm)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode (BMesh *bm)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode (BMesh *bm)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode (BMesh *bm, const int)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode (BMesh *bm, const int cd_loop_uv_offset)
static void blender::bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode (BMesh *bm, const int cd_loop_uv_offset)
void blender::BM_mesh_uvselect_sync_from_mesh_sticky_location (BMesh *bm, const int cd_loop_uv_offset)
void blender::BM_mesh_uvselect_sync_from_mesh_sticky_disabled (BMesh *bm)
void blender::BM_mesh_uvselect_sync_from_mesh_sticky_vert (BMesh *bm)
void blender::BM_mesh_uvselect_sync_to_mesh (BMesh *bm)

UV Selection Validation

#define MAYBE_ASSERT
#define INCF_MAYBE_ASSERT(var)
static void blender::bm_mesh_loop_clear_tag (BMesh *bm)
static bool blender::bm_mesh_uvselect_check_viewport_sync (BMesh *bm, UVSelectValidateInfo_Sync &info_sub)
static bool blender::bm_mesh_uvselect_check_flush (BMesh *bm, UVSelectValidateInfo_Flush &info_sub)
static bool blender::bm_mesh_uvselect_check_contiguous (BMesh *bm, const int cd_loop_uv_offset, UVSelectValidateInfo_Contiguous &info_sub)
static bool blender::bm_mesh_uvselect_check_flush_and_contiguous (BMesh *bm, const int cd_loop_uv_offset, UVSelectValidateInfo_FlushAndContiguous &info_sub)
bool blender::BM_mesh_uvselect_is_valid (BMesh *bm, const int cd_loop_uv_offset, const bool check_sync, const bool check_flush, const bool check_contiguous, UVSelectValidateInfo *info_p)

Macro Definition Documentation

◆ INCF_MAYBE_ASSERT

◆ MAYBE_ASSERT

#define MAYBE_ASSERT

Definition at line 2030 of file bmesh_uvselect.cc.