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

Go to the source code of this file.

Functions

Internal Utilities
static void bm_mesh_uvselect_disable_all (BMesh *bm)
UV Selection Functions (low level)
bool BM_loop_vert_uvselect_test (const BMLoop *l)
bool BM_loop_edge_uvselect_test (const BMLoop *l)
bool BM_face_uvselect_test (const BMFace *f)
UV Selection Connectivity Checks
bool BM_loop_vert_uvselect_check_other_loop_vert (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_loop_vert_uvselect_check_other_loop_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_loop_vert_uvselect_check_other_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_loop_vert_uvselect_check_other_face (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_loop_edge_uvselect_check_other_loop_edge (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_loop_edge_uvselect_check_other_face (BMLoop *l, const char hflag, const int cd_loop_uv_offset)
bool BM_face_uvselect_check_edges_all (BMFace *f)
UV Selection Functions
void BM_loop_vert_uvselect_set_noflush (BMesh *bm, BMLoop *l, bool select)
void BM_loop_edge_uvselect_set_noflush (BMesh *bm, BMLoop *l, bool select)
void BM_loop_edge_uvselect_set (BMesh *bm, BMLoop *l, bool select)
void BM_face_uvselect_set_noflush (BMesh *bm, BMFace *f, bool select)
void BM_face_uvselect_set (BMesh *bm, BMFace *f, bool select)
bool BM_mesh_uvselect_clear (BMesh *bm)
UV Selection Functions (Shared)
void BM_loop_vert_uvselect_set_shared (BMesh *bm, BMLoop *l, bool select, const int cd_loop_uv_offset)
void BM_loop_edge_uvselect_set_shared (BMesh *bm, BMLoop *l, bool select, const int cd_loop_uv_offset)
void BM_face_uvselect_set_shared (BMesh *bm, BMFace *f, bool select, const int cd_loop_uv_offset)
void BM_mesh_uvselect_set_elem_shared (BMesh *bm, bool select, const int cd_loop_uv_offset, const blender::Span< BMLoop * > loop_verts, const blender::Span< BMLoop * > loop_edges, const blender::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 bm_vert_uvselect_set_pick (BMesh *bm, BMVert *v, const bool select, const BMUVSelectPickParams &, bool caller_handles_edge_or_face_mode)
static void 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 bm_face_uvselect_set_pick (BMesh *bm, BMFace *f, const bool select, const BMUVSelectPickParams &uv_pick_params)
void BM_vert_uvselect_set_pick (BMesh *bm, BMVert *v, bool select, const BMUVSelectPickParams &params)
void BM_edge_uvselect_set_pick (BMesh *bm, BMEdge *e, bool select, const BMUVSelectPickParams &params)
void BM_face_uvselect_set_pick (BMesh *bm, BMFace *f, bool select, const BMUVSelectPickParams &params)
static void 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 BM_mesh_uvselect_set_elem_from_mesh (BMesh *bm, const bool select, const BMUVSelectPickParams &params, const blender::VectorList< BMVert * > &verts, const blender::VectorList< BMEdge * > &edges, const blender::VectorList< BMFace * > &faces)
void BM_mesh_uvselect_set_elem_from_mesh (BMesh *bm, bool select, const BMUVSelectPickParams &params, blender::Span< BMVert * > verts, blender::Span< BMEdge * > edges, blender::Span< BMFace * > faces)
UV Selection Flushing (Only Select/De-Select)
void BM_mesh_uvselect_flush_from_loop_verts_only_select (BMesh *bm)
void BM_mesh_uvselect_flush_from_loop_verts_only_deselect (BMesh *bm)
void BM_mesh_uvselect_flush_from_loop_edges_only_select (BMesh *bm)
void BM_mesh_uvselect_flush_from_loop_edges_only_deselect (BMesh *bm)
void BM_mesh_uvselect_flush_from_faces_only_select (BMesh *bm)
void BM_mesh_uvselect_flush_from_faces_only_deselect (BMesh *bm)
void BM_mesh_uvselect_flush_shared_only_select (BMesh *bm, const int cd_loop_uv_offset)
void BM_mesh_uvselect_flush_shared_only_deselect (BMesh *bm, const int cd_loop_uv_offset)
UV Selection Flushing (Between Elements)
void BM_mesh_uvselect_flush_from_loop_verts (BMesh *bm)
void BM_mesh_uvselect_flush_from_loop_edges (BMesh *bm, bool flush_down)
void BM_mesh_uvselect_flush_from_faces (BMesh *bm, bool flush_down)
void BM_mesh_uvselect_flush_from_verts (BMesh *bm, const bool select)
UV Selection Flushing (Selection Mode Aware)
void BM_mesh_uvselect_mode_flush_ex (BMesh *bm, const short selectmode, const bool flush_down)
void BM_mesh_uvselect_mode_flush (BMesh *bm)
void BM_mesh_uvselect_mode_flush_only_select (BMesh *bm)
void BM_mesh_uvselect_mode_flush_update (BMesh *bm, const short selectmode_old, const short selectmode_new, const int cd_loop_uv_offset)
void BM_mesh_uvselect_flush_post_subdivide (BMesh *bm, const int cd_loop_uv_offset)
UV Selection Flushing (From/To Mesh)
static void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode (BMesh *bm)
static void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode (BMesh *bm)
static void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode (BMesh *bm)
static void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode (BMesh *bm, const int)
static void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode (BMesh *bm, const int cd_loop_uv_offset)
static void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode (BMesh *bm, const int cd_loop_uv_offset)
void BM_mesh_uvselect_sync_from_mesh_sticky_location (BMesh *bm, const int cd_loop_uv_offset)
void BM_mesh_uvselect_sync_from_mesh_sticky_disabled (BMesh *bm)
void BM_mesh_uvselect_sync_from_mesh_sticky_vert (BMesh *bm)
void BM_mesh_uvselect_sync_to_mesh (BMesh *bm)

UV Selection Validation

Split the validity checks into categories.

  • UV selection and viewport selection are in sync. Where a selected UV-vertex must have it's viewport-vertex selected too. Where a selected viewport-vertex must have at least one selected UV.

    This is core to UV sync-select functioning properly.

    Failure to properly sync is likely to result in bugs where UV's aren't handled properly although it should not cause crashes.

  • UV selection flushing. Where the relationship between selected elements makes sense.
    • An face cannot be selected when one of it's vertices is de-selected.
    • An edge cannot be selected if one of it's vertices is de-selected. ... etc ... This is much the same as selection flushing for viewport selection.

  • Contiguous UV selection Where co-located UV's are all either selected or de-selected.

    Failure to select co-located UV's is not an error (on a data-correctness level) rather, it's something that's applied on a "tool" level - depending on UV sticky options. Depending on the tools, it may be intended that UV selection be contiguous across UV's.

#define MAYBE_ASSERT
#define INCF_MAYBE_ASSERT(var)
static void bm_mesh_loop_clear_tag (BMesh *bm)
static bool bm_mesh_uvselect_check_viewport_sync (BMesh *bm, UVSelectValidateInfo_Sync &info_sub)
static bool bm_mesh_uvselect_check_flush (BMesh *bm, UVSelectValidateInfo_Flush &info_sub)
static bool bm_mesh_uvselect_check_contiguous (BMesh *bm, const int cd_loop_uv_offset, UVSelectValidateInfo_Contiguous &info_sub)
static bool bm_mesh_uvselect_check_flush_and_contiguous (BMesh *bm, const int cd_loop_uv_offset, UVSelectValidateInfo_FlushAndContiguous &info_sub)
bool 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

#define INCF_MAYBE_ASSERT ( var)
Value:
{ \
MAYBE_ASSERT; \
(var) += 1; \
} \
((void)0)
MAYBE_ASSERT
#define MAYBE_ASSERT
Definition bmesh_uvselect.cc:1981

Definition at line 1984 of file bmesh_uvselect.cc.

Referenced by bm_mesh_uvselect_check_contiguous(), bm_mesh_uvselect_check_flush(), bm_mesh_uvselect_check_flush_and_contiguous(), and bm_mesh_uvselect_check_viewport_sync().

◆ MAYBE_ASSERT

#define MAYBE_ASSERT

Definition at line 1981 of file bmesh_uvselect.cc.

Function Documentation

◆ BM_edge_uvselect_set_pick()

void BM_edge_uvselect_set_pick ( BMesh * bm,
BMEdge * e,
bool select,
const BMUVSelectPickParams & params )

Definition at line 864 of file bmesh_uvselect.cc.

References bm, bm_edge_uvselect_set_pick(), e, params, and select.

Referenced by BM_mesh_uvselect_set_elem_from_mesh(), and EDBM_select_pick().

◆ bm_edge_uvselect_set_pick()

void bm_edge_uvselect_set_pick ( BMesh * bm,
BMEdge * e,
const bool select,
const BMUVSelectPickParams & uv_pick_params,
const bool caller_handles_face_mode )
static

Definition at line 620 of file bmesh_uvselect.cc.

References BLI_assert_msg, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_face_uvselect_check_edges_all(), BM_face_uvselect_set_noflush(), BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_check_other_loop_edge(), BM_loop_vert_uvselect_set_noflush(), BM_loop_vert_uvselect_set_shared(), BMUVSelectPickParams::cd_loop_uv_offset, e, BMLoop::f, BMLoop::next, BMLoop::prev, BMLoop::radial_next, SCE_SELECT_EDGE, SCE_SELECT_VERTEX, select, and BMUVSelectPickParams::shared.

Referenced by BM_edge_uvselect_set_pick(), and BM_mesh_uvselect_set_elem_from_mesh().

◆ BM_face_uvselect_check_edges_all()

bool BM_face_uvselect_check_edges_all ( BMFace * f)

Definition at line 250 of file bmesh_uvselect.cc.

References BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, and BMLoop::next.

Referenced by bm_edge_uvselect_set_pick(), and bm_vert_uvselect_set_pick().

◆ BM_face_uvselect_set()

void BM_face_uvselect_set ( BMesh * bm,
BMFace * f,
bool select )

Set the UV selection flag for f & flush down to edges & vertices.

Definition at line 324 of file bmesh_uvselect.cc.

References bm, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), BMLoop::next, and select.

Referenced by bm_face_uvselect_set_pick(), BM_mesh_uvselect_flush_post_subdivide(), bpy_bmface_uv_select_set(), uv_select_invert(), uvedit_face_select_disable(), and uvedit_face_select_enable().

◆ BM_face_uvselect_set_noflush()

void BM_face_uvselect_set_noflush ( BMesh * bm,
BMFace * f,
bool select )

Set the UV selection flag for f without flushing down to edges & vertices.

Definition at line 309 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, select, and UNUSED_VARS_NDEBUG.

Referenced by bm_edge_uvselect_set_pick(), BM_face_uvselect_set(), bm_face_uvselect_set_pick(), BM_face_uvselect_set_shared(), BM_mesh_uvselect_flush_from_loop_edges(), BM_mesh_uvselect_flush_from_loop_edges_only_deselect(), BM_mesh_uvselect_flush_from_loop_edges_only_select(), BM_mesh_uvselect_flush_from_loop_verts(), BM_mesh_uvselect_flush_from_loop_verts_only_deselect(), BM_mesh_uvselect_flush_from_loop_verts_only_select(), BM_mesh_uvselect_set_elem_shared(), bm_vert_uvselect_set_pick(), uv_select_flush_from_tag_face(), uv_select_flush_from_tag_loop(), uv_select_invert(), and uvedit_face_select_shared_vert().

◆ BM_face_uvselect_set_pick()

void BM_face_uvselect_set_pick ( BMesh * bm,
BMFace * f,
bool select,
const BMUVSelectPickParams & params )

Definition at line 872 of file bmesh_uvselect.cc.

References bm, bm_face_uvselect_set_pick(), params, and select.

Referenced by BM_mesh_uvselect_set_elem_from_mesh(), and EDBM_select_pick().

◆ bm_face_uvselect_set_pick()

void bm_face_uvselect_set_pick ( BMesh * bm,
BMFace * f,
const bool select,
const BMUVSelectPickParams & uv_pick_params )
static

Definition at line 793 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_face_uvselect_set(), BM_face_uvselect_set_noflush(), BM_loop_edge_uvselect_check_other_face(), BM_loop_edge_uvselect_set_noflush(), BM_loop_edge_uvselect_set_shared(), BM_loop_vert_uvselect_check_other_face(), BM_loop_vert_uvselect_set_noflush(), BM_loop_vert_uvselect_set_shared(), BMUVSelectPickParams::cd_loop_uv_offset, BMLoop::next, select, and BMUVSelectPickParams::shared.

Referenced by BM_face_uvselect_set_pick(), and BM_mesh_uvselect_set_elem_from_mesh().

◆ BM_face_uvselect_set_shared()

void BM_face_uvselect_set_shared ( BMesh * bm,
BMFace * f,
bool select,
const int cd_loop_uv_offset )

Definition at line 408 of file bmesh_uvselect.cc.

References bm, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_loop_edge_uvselect_set_shared(), BM_loop_vert_uvselect_set_shared(), BMLoop::next, and select.

Referenced by BM_mesh_uvselect_set_elem_shared(), and EDBM_mesh_reveal().

◆ BM_face_uvselect_test()

bool BM_face_uvselect_test ( const BMFace * f)

Definition at line 55 of file bmesh_uvselect.cc.

References BM_elem_flag_test, BM_ELEM_HIDDEN, and BM_ELEM_SELECT_UV.

◆ BM_loop_edge_uvselect_check_other_face()

bool BM_loop_edge_uvselect_check_other_face ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 229 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_loop_uv_share_edge_check(), ELEM, BMLoop::f, l, and BMLoop::radial_next.

Referenced by bm_face_uvselect_set_pick(), bm_mesh_uvselect_check_flush_and_contiguous(), bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode(), bm_mesh_uvselect_mode_flush_down_deselect_only(), BM_mesh_uvselect_set_elem_shared(), and uvedit_face_select_shared_vert().

◆ BM_loop_edge_uvselect_check_other_loop_edge()

bool BM_loop_edge_uvselect_check_other_loop_edge ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 208 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV_EDGE, BM_ELEM_TAG, BM_loop_uv_share_edge_check(), ELEM, BMLoop::f, l, and BMLoop::radial_next.

Referenced by BM_mesh_uvselect_flush_post_subdivide(), BM_mesh_uvselect_flush_shared_only_deselect(), and BM_mesh_uvselect_flush_shared_only_select().

◆ BM_loop_edge_uvselect_set()

void BM_loop_edge_uvselect_set ( BMesh * bm,
BMLoop * l,
bool select )

Set the UV selection flag for e & flush down to vertices.

Definition at line 301 of file bmesh_uvselect.cc.

References bm, BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), l, and select.

Referenced by BM_mesh_uvselect_flush_from_loop_edges_only_select(), BM_mesh_uvselect_flush_post_subdivide(), bpy_bmloop_uv_select_edge_set(), edbm_rip_edge_invoke(), and uvedit_edge_select_enable().

◆ BM_loop_edge_uvselect_set_noflush()

void BM_loop_edge_uvselect_set_noflush ( BMesh * bm,
BMLoop * l,
bool select )

Set the UV selection flag for e without flushing down to vertices.

Definition at line 286 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, l, select, and UNUSED_VARS_NDEBUG.

Referenced by bm_edge_uvselect_set_pick(), BM_face_uvselect_set(), bm_face_uvselect_set_pick(), BM_loop_edge_uvselect_set(), BM_loop_edge_uvselect_set_shared(), BM_mesh_uvselect_flush_from_faces(), BM_mesh_uvselect_flush_from_faces_only_deselect(), BM_mesh_uvselect_flush_from_faces_only_select(), BM_mesh_uvselect_flush_from_loop_edges_only_deselect(), BM_mesh_uvselect_flush_from_loop_verts(), BM_mesh_uvselect_flush_from_loop_verts_only_deselect(), BM_mesh_uvselect_flush_from_loop_verts_only_select(), BM_mesh_uvselect_flush_shared_only_deselect(), BM_mesh_uvselect_flush_shared_only_select(), bm_vert_uvselect_set_pick(), uv_select_invert(), uvedit_edge_select_disable(), uvedit_edge_select_set_noflush(), and uvedit_face_select_shared_vert().

◆ BM_loop_edge_uvselect_set_shared()

void BM_loop_edge_uvselect_set_shared ( BMesh * bm,
BMLoop * l,
bool select,
const int cd_loop_uv_offset )

Definition at line 385 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_elem_flag_test_bool, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_loop_edge_uvselect_set_noflush(), BM_loop_uv_share_edge_check(), BMLoop::f, l, BMLoop::radial_next, and select.

Referenced by bm_face_uvselect_set_pick(), BM_face_uvselect_set_shared(), BM_mesh_uvselect_set_elem_shared(), EDBM_mesh_reveal(), and uvedit_face_select_shared_vert().

◆ BM_loop_edge_uvselect_test()

bool BM_loop_edge_uvselect_test ( const BMLoop * l)

Definition at line 49 of file bmesh_uvselect.cc.

References BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, and l.

Referenced by ED_uvedit_active_vert_loop_get().

◆ BM_loop_vert_uvselect_check_other_edge()

bool BM_loop_vert_uvselect_check_other_edge ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 135 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_TAG, BM_loop_uv_share_vert_check(), bmesh_disk_edge_next(), BMLoop::e, ELEM, BMLoop::f, BMEdge::l, l, BMLoop::prev, BMLoop::radial_next, BMLoop::v, and v.

Referenced by bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode().

◆ BM_loop_vert_uvselect_check_other_face()

bool BM_loop_vert_uvselect_check_other_face ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 174 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_TAG, BM_loop_uv_share_vert_check(), bmesh_disk_edge_next(), ELEM, BMLoop::f, BMEdge::l, l, BMLoop::radial_next, BMLoop::v, and v.

Referenced by bm_face_uvselect_set_pick(), bm_mesh_uvselect_check_flush_and_contiguous(), bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode(), bm_mesh_uvselect_mode_flush_down_deselect_only(), and uvedit_face_select_shared_vert().

◆ BM_loop_vert_uvselect_check_other_loop_edge()

bool BM_loop_vert_uvselect_check_other_loop_edge ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 100 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_ELEM_TAG, BM_loop_uv_share_vert_check(), bmesh_disk_edge_next(), ELEM, BMLoop::f, BMEdge::l, l, BMLoop::prev, BMLoop::radial_next, BMLoop::v, and v.

Referenced by bm_edge_uvselect_set_pick(), bm_mesh_uvselect_check_flush_and_contiguous(), bm_mesh_uvselect_mode_flush_down_deselect_only(), and BM_mesh_uvselect_set_elem_shared().

◆ BM_loop_vert_uvselect_check_other_loop_vert()

bool BM_loop_vert_uvselect_check_other_loop_vert ( BMLoop * l,
const char hflag,
const int cd_loop_uv_offset )

Definition at line 66 of file bmesh_uvselect.cc.

References BLI_assert, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_TAG, BM_loop_uv_share_vert_check(), bmesh_disk_edge_next(), ELEM, BMLoop::f, BMEdge::l, l, BMLoop::radial_next, BMLoop::v, and v.

Referenced by BM_mesh_uvselect_flush_post_subdivide(), BM_mesh_uvselect_flush_shared_only_deselect(), and BM_mesh_uvselect_flush_shared_only_select().

◆ BM_loop_vert_uvselect_set_noflush()

void BM_loop_vert_uvselect_set_noflush ( BMesh * bm,
BMLoop * l,
bool select )

Set the UV selection flag for v without flushing down. since there is nothing to flush down to.

Definition at line 271 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, l, select, and UNUSED_VARS_NDEBUG.

Referenced by bm_edge_uvselect_set_pick(), BM_face_uvselect_set(), bm_face_uvselect_set_pick(), BM_loop_edge_uvselect_set(), BM_loop_vert_uvselect_set_shared(), BM_mesh_uvselect_flush_from_faces(), BM_mesh_uvselect_flush_from_faces_only_deselect(), BM_mesh_uvselect_flush_from_faces_only_select(), BM_mesh_uvselect_flush_from_loop_edges(), BM_mesh_uvselect_flush_from_loop_edges_only_deselect(), BM_mesh_uvselect_flush_post_subdivide(), BM_mesh_uvselect_flush_shared_only_deselect(), BM_mesh_uvselect_flush_shared_only_select(), bm_vert_uvselect_set_pick(), bpy_bmloop_uv_select_vert_set(), uv_select_invert(), uvedit_edge_select_disable(), uvedit_face_select_shared_vert(), uvedit_uv_select_disable(), and uvedit_uv_select_enable().

◆ BM_loop_vert_uvselect_set_shared()

void BM_loop_vert_uvselect_set_shared ( BMesh * bm,
BMLoop * l,
bool select,
const int cd_loop_uv_offset )

Definition at line 350 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_test, BM_elem_flag_test_bool, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_loop_uv_share_vert_check(), BM_loop_vert_uvselect_set_noflush(), bmesh_disk_edge_next(), BMLoop::f, BMEdge::l, l, BMLoop::radial_next, select, BMLoop::v, and v.

Referenced by bm_edge_uvselect_set_pick(), bm_face_uvselect_set_pick(), BM_face_uvselect_set_shared(), BM_mesh_uvselect_set_elem_shared(), EDBM_mesh_reveal(), uv_select_invert(), and uvedit_face_select_shared_vert().

◆ BM_loop_vert_uvselect_test()

bool BM_loop_vert_uvselect_test ( const BMLoop * l)

Definition at line 45 of file bmesh_uvselect.cc.

References BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, and l.

◆ bm_mesh_loop_clear_tag()

void bm_mesh_loop_clear_tag ( BMesh * bm)
static

Definition at line 1991 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_disable, BM_ELEM_TAG, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, and BMLoop::next.

Referenced by bm_mesh_uvselect_check_contiguous().

◆ bm_mesh_uvselect_check_contiguous()

bool bm_mesh_uvselect_check_contiguous ( BMesh * bm,
const int cd_loop_uv_offset,
UVSelectValidateInfo_Contiguous & info_sub )
static

Definition at line 2246 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_enable, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_ELEM_TAG, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_ELEM, BM_ITER_MESH, BM_loop_uv_share_edge_check(), BM_loop_uv_share_vert_check(), BM_LOOPS_OF_VERT, bm_mesh_loop_clear_tag(), UVSelectValidateInfo_Contiguous::count_uv_edge_non_contiguous_selected, UVSelectValidateInfo_Contiguous::count_uv_vert_non_contiguous_selected, BMLoop::f, INCF_MAYBE_ASSERT, BMLoop::next, and BMLoop::radial_next.

Referenced by BM_mesh_uvselect_is_valid().

◆ bm_mesh_uvselect_check_flush()

bool bm_mesh_uvselect_check_flush ( BMesh * bm,
UVSelectValidateInfo_Flush & info_sub )
static

Definition at line 2142 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, UVSelectValidateInfo_Flush::count_uv_edge_selected_with_any_verts_unselected, UVSelectValidateInfo_Flush::count_uv_edge_unselected_with_all_verts_selected, UVSelectValidateInfo_Flush::count_uv_face_selected_with_any_edges_unselected, UVSelectValidateInfo_Flush::count_uv_face_selected_with_any_verts_unselected, UVSelectValidateInfo_Flush::count_uv_face_unselected_with_all_edges_selected, UVSelectValidateInfo_Flush::count_uv_face_unselected_with_all_verts_selected, INCF_MAYBE_ASSERT, BMFace::len, BMLoop::next, SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by BM_mesh_uvselect_is_valid().

◆ bm_mesh_uvselect_check_flush_and_contiguous()

bool bm_mesh_uvselect_check_flush_and_contiguous ( BMesh * bm,
const int cd_loop_uv_offset,
UVSelectValidateInfo_FlushAndContiguous & info_sub )
static

Checks using both flush & contiguous.

Definition at line 2374 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_face(), BM_loop_vert_uvselect_check_other_face(), BM_loop_vert_uvselect_check_other_loop_edge(), UVSelectValidateInfo_FlushAndContiguous::count_uv_edge_isolated_in_face_mode, UVSelectValidateInfo_FlushAndContiguous::count_uv_vert_isolated_in_edge_or_face_mode, UVSelectValidateInfo_FlushAndContiguous::count_uv_vert_isolated_in_face_mode, INCF_MAYBE_ASSERT, BMLoop::next, BMLoop::prev, SCE_SELECT_EDGE, SCE_SELECT_FACE, and SCE_SELECT_VERTEX.

Referenced by BM_mesh_uvselect_is_valid().

◆ bm_mesh_uvselect_check_viewport_sync()

bool bm_mesh_uvselect_check_viewport_sync ( BMesh * bm,
UVSelectValidateInfo_Sync & info_sub )
static

Check UV vertices and edges are synchronized with the viewport selection.

UV face selection isn't checked here since this is handled as part of flushing checks.

Definition at line 2009 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_EDGES_OF_MESH, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_ELEM, BM_ITER_MESH, BM_LOOPS_OF_VERT, BM_VERTS_OF_MESH, UVSelectValidateInfo_Sync::count_uv_edge_any_selected_with_edge_unselected, UVSelectValidateInfo_Sync::count_uv_edge_none_selected_with_edge_selected, UVSelectValidateInfo_Sync::count_uv_vert_any_selected_with_vert_unselected, UVSelectValidateInfo_Sync::count_uv_vert_none_selected_with_vert_selected, e, BMLoop::f, INCF_MAYBE_ASSERT, l, BMLoop::next, BMLoop::radial_next, SCE_SELECT_VERTEX, BMLoop::v, and v.

Referenced by BM_mesh_uvselect_is_valid().

◆ BM_mesh_uvselect_clear()

bool BM_mesh_uvselect_clear ( BMesh * bm)

Call this function when selecting mesh elements in the viewport and the relationship with UV's is lost.

Returns
True if UV select is cleared (a change was made).

This has two purposes:

  • Maintaining the UV selection isn't needed: Some operations such as adding a new mesh primitive clear the selection, selecting all geometry from the new primitive. In this case a UV selection is redundant & should be cleared.

  • Maintaining the UV selection isn't supported: Some selection operations don't support maintaining a valid UV selection, in that case it's necessary to clear the UV selection otherwise tools may seem to be broken if they aren't operating on the selection properly.

    NOTE(@ideasman42): It's worth noting that in this case clearing the selection is "lossy", users may wish that all selection operations would handle UV selection data too. Supporting additional operations is always possible, at the time of writing it's impractical to do so, see: #131642 design task for details.

Internally this marks the UV selection data as invalid, using the mesh selection as the "source-of-truth".

Note
By convention call this immediately after flushing.
In many cases the UV selection can be maintained and this function removed, although it adds some complexity & overhead. See UVSyncSelectFromMesh.
Calls to this function that should not be removed in favor of supporting UV selection, this should be mentioned in a code-comment, making it clear this is not a limitation to fix.

Definition at line 335 of file bmesh_uvselect.cc.

References bm.

Referenced by EDBM_uvselect_clear(), uv_select_sync_update(), and uvedit_select_prepare_custom_data().

◆ bm_mesh_uvselect_disable_all()

void bm_mesh_uvselect_disable_all ( BMesh * bm)
static

Definition at line 23 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_disable, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, and BMLoop::next.

Referenced by bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode(), and bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode().

◆ BM_mesh_uvselect_flush_from_faces()

void BM_mesh_uvselect_flush_from_faces ( BMesh * bm,
bool flush_down )

Mode independent UV selection/de-selection flush from UV faces.

Flush from faces down to edges & vertices (when flush_down is true).

Note
The caller may need to run BM_mesh_uvselect_flush_shared_only_select afterwards.

Definition at line 1352 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by BM_mesh_uvselect_mode_flush_ex().

◆ BM_mesh_uvselect_flush_from_faces_only_deselect()

void BM_mesh_uvselect_flush_from_faces_only_deselect ( BMesh * bm)

Definition at line 1192 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by uv_select_linked_multi().

◆ BM_mesh_uvselect_flush_from_faces_only_select()

void BM_mesh_uvselect_flush_from_faces_only_select ( BMesh * bm)

Definition at line 1171 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by uv_select_linked_multi().

◆ BM_mesh_uvselect_flush_from_loop_edges()

void BM_mesh_uvselect_flush_from_loop_edges ( BMesh * bm,
bool flush_down )

Mode independent UV selection/de-selection flush from UV edges.

Flush from loop edges up to faces and optionally down to vertices (when flush_down is true).

Note
The caller may need to run BM_mesh_uvselect_flush_shared_only_select afterwards.

Definition at line 1305 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by BM_mesh_uvselect_mode_flush_ex(), BM_mesh_uvselect_mode_flush_update(), and uv_select_flush_from_loop_edge_flag().

◆ BM_mesh_uvselect_flush_from_loop_edges_only_deselect()

void BM_mesh_uvselect_flush_from_loop_edges_only_deselect ( BMesh * bm)

Definition at line 1139 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), BMLoop::next, and BMLoop::prev.

◆ BM_mesh_uvselect_flush_from_loop_edges_only_select()

void BM_mesh_uvselect_flush_from_loop_edges_only_select ( BMesh * bm)

Definition at line 1113 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set(), and BMLoop::next.

Referenced by BM_mesh_uvselect_mode_flush_only_select().

◆ BM_mesh_uvselect_flush_from_loop_verts()

void BM_mesh_uvselect_flush_from_loop_verts ( BMesh * bm)

Mode independent UV selection/de-selection flush from UV vertices.

Parameters
selectWhen true, flush the selection state to de-selected elements, otherwise perform the opposite, flushing de-selection.
Note
The caller may need to run BM_mesh_uvselect_flush_shared_only_select afterwards.

Definition at line 1281 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), BMLoop::next, and select.

Referenced by BM_mesh_uvselect_mode_flush_ex(), BM_mesh_uvselect_mode_flush_update(), and uv_rip_object().

◆ BM_mesh_uvselect_flush_from_loop_verts_only_deselect()

void BM_mesh_uvselect_flush_from_loop_verts_only_deselect ( BMesh * bm)

Definition at line 1084 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), and BMLoop::next.

Referenced by BM_mesh_uvselect_flush_from_verts(), and uv_select_more_less().

◆ BM_mesh_uvselect_flush_from_loop_verts_only_select()

void BM_mesh_uvselect_flush_from_loop_verts_only_select ( BMesh * bm)

Definition at line 1056 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_set_noflush(), and BMLoop::next.

Referenced by BM_mesh_uvselect_flush_from_verts(), BM_mesh_uvselect_mode_flush_only_select(), uv_select_more_less(), uv_select_similar_edge_exec(), uv_select_similar_face_exec(), uv_select_similar_island_exec(), and uv_select_similar_vert_exec().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode ( BMesh * bm,
const int cd_loop_uv_offset )
static

Definition at line 1702 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_vert_uvselect_check_other_edge(), BMLoop::e, BMLoop::next, BMLoop::prev, and BMLoop::v.

Referenced by BM_mesh_uvselect_sync_from_mesh_sticky_location().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode ( BMesh * bm,
const int cd_loop_uv_offset )
static

Definition at line 1736 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_disable, BM_elem_flag_enable, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_face(), BM_loop_vert_uvselect_check_other_face(), BMLoop::e, BMLoop::next, and BMLoop::v.

Referenced by BM_mesh_uvselect_sync_from_mesh_sticky_location().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode ( BMesh * bm,
const int  )
static

Definition at line 1687 of file bmesh_uvselect.cc.

References bm, and bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode().

Referenced by BM_mesh_uvselect_sync_from_mesh_sticky_location().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode ( BMesh * bm)
static

Definition at line 1623 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_enable, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, bm_mesh_uvselect_disable_all(), BMLoop::e, and BMLoop::next.

Referenced by BM_mesh_uvselect_sync_from_mesh_sticky_vert().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode ( BMesh * bm)
static

Definition at line 1657 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_enable, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, bm_mesh_uvselect_disable_all(), and BMLoop::next.

Referenced by BM_mesh_uvselect_sync_from_mesh_sticky_vert().

◆ bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode()

void bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode ( BMesh * bm)
static

Definition at line 1600 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_set, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BMLoop::e, BMLoop::next, and BMLoop::v.

Referenced by bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode(), BM_mesh_uvselect_sync_from_mesh_sticky_disabled(), and BM_mesh_uvselect_sync_from_mesh_sticky_vert().

◆ BM_mesh_uvselect_flush_from_verts()

void BM_mesh_uvselect_flush_from_verts ( BMesh * bm,
bool select )

Mode independent UV selection/de-selection flush from UV vertices.

Use this when it's know geometry was only selected/de-selected.

Note
An equivalent to BM_mesh_select_flush_from_verts for the UV selection.

Definition at line 1375 of file bmesh_uvselect.cc.

References bm, BM_mesh_uvselect_flush_from_loop_verts_only_deselect(), BM_mesh_uvselect_flush_from_loop_verts_only_select(), and select.

Referenced by bpy_bmesh_uv_select_flush().

◆ BM_mesh_uvselect_flush_post_subdivide()

void BM_mesh_uvselect_flush_post_subdivide ( BMesh * bm,
int cd_loop_uv_offset )

A specialized flushing that fills in selection information after subdividing.

It's important this runs:

  • After subdivision.
  • After the mesh selection has already been flushed.
Note
Intended to be a generic utility to be used in any situation new geometry is created by splitting existing geometry.

Definition at line 1515 of file bmesh_uvselect.cc.

References bm, BM_edge_is_any_face_flag_test(), BM_EDGES_OF_MESH, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_face_uvselect_set(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_loop_edge(), BM_loop_edge_uvselect_set(), BM_loop_vert_uvselect_check_other_loop_vert(), BM_loop_vert_uvselect_set_noflush(), BM_mesh_uvselect_mode_flush_only_select(), e, BMLoop::next, BMLoop::radial_next, SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by BM_mesh_esubdivide().

◆ BM_mesh_uvselect_flush_shared_only_deselect()

void BM_mesh_uvselect_flush_shared_only_deselect ( BMesh * bm,
const int cd_loop_uv_offset )

Definition at line 1244 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_loop_edge(), BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_check_other_loop_vert(), BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by bpy_bmesh_uv_select_flush_shared().

◆ BM_mesh_uvselect_flush_shared_only_select()

void BM_mesh_uvselect_flush_shared_only_select ( BMesh * bm,
int cd_loop_uv_offset )

A useful utility so simple selection operations can be performed on edges/faces, afterwards this can be used to select UV's that are connected. This avoids having to use more involved UV connectivity aware logic inline.

Definition at line 1213 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_loop_edge(), BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_check_other_loop_vert(), BM_loop_vert_uvselect_set_noflush(), and BMLoop::next.

Referenced by bpy_bmesh_uv_select_flush_shared(), ED_uvedit_select_sync_flush(), and uv_select_invert().

◆ BM_mesh_uvselect_is_valid()

bool BM_mesh_uvselect_is_valid ( BMesh * bm,
int cd_loop_uv_offset,
bool check_sync,
bool check_flush,
bool check_contiguous,
UVSelectValidateInfo * info )

Check the UV selection is valid, mainly for debugging & testing purposes.

The primary check which should remain valid is: check_sync, if there is ever a selected vertex without any selected UV's or a selected UV without it's vertex being selected (and similar kinds of issues), then the selection is out-of-sync, which Blender should never allow.

While an invalid selection should not crash, tools that operate on selection may behave unpredictably.

The other checks may be desired or not although this depends more on the situation.

Parameters
cd_loop_uv_offsetThe UV custom-data layer to check. Ignored when -1 (UV checks wont be used).
check_syncWhen true, check the selection is synchronized between the UV and mesh selection. This should practically always be true, as it doesn't make sense to check the UV selection if valid otherwise, unless the UV selection is being set and has not yet been synchronized.
check_flushWhen true, check the selection is flushed based on BMesh::selectmode.
check_contiguousWhen true, check that UV selection is contiguous. Note that this is not considered an error since users may cause this to happen and tools are expected to work properly, however some operations are expected to maintain a contiguous selection. This check is included to ensure those operations are working.

Definition at line 2463 of file bmesh_uvselect.cc.

References BLI_assert, bm, bm_mesh_uvselect_check_contiguous(), bm_mesh_uvselect_check_flush(), bm_mesh_uvselect_check_flush_and_contiguous(), bm_mesh_uvselect_check_viewport_sync(), UVSelectValidateInfo::contiguous, UVSelectValidateInfo::flush, UVSelectValidateInfo::flush_contiguous, and UVSelectValidateInfo::sync.

Referenced by bpy_bm_utils_uv_select_check(), and undomesh_from_editmesh().

◆ BM_mesh_uvselect_mode_flush()

void BM_mesh_uvselect_mode_flush ( BMesh * bm)

Definition at line 1404 of file bmesh_uvselect.cc.

References bm, and BM_mesh_uvselect_mode_flush_ex().

Referenced by ED_uvedit_select_sync_flush(), EDBM_mesh_reveal(), uv_mouse_select_multi(), and uv_select_invert().

◆ bm_mesh_uvselect_mode_flush_down_deselect_only()

void 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 )
static

Ensure isolated elements aren't selected which should be unselected based on select_mode.

Regarding Picking

Run this when picking a vertex in edge selection mode or an edge in face select mode.

This is not supported by individual picking, however when operating on many elements, it's useful to be able to support this so users of the API can select vertices for example Without it failing entirely because the users has the mesh in edge/face selection mode.

Definition at line 893 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_disable, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_loop_edge_uvselect_check_other_face(), BM_loop_vert_uvselect_check_other_face(), BM_loop_vert_uvselect_check_other_loop_edge(), BMLoop::next, BMLoop::prev, SCE_SELECT_EDGE, SCE_SELECT_FACE, SCE_SELECT_VERTEX, and shared.

Referenced by BM_mesh_uvselect_mode_flush_update(), BM_mesh_uvselect_set_elem_from_mesh(), and BM_mesh_uvselect_set_elem_from_mesh().

◆ BM_mesh_uvselect_mode_flush_ex()

void BM_mesh_uvselect_mode_flush_ex ( BMesh * bm,
const short selectmode,
bool flush_down )
Parameters
flush_downSee BMSelectFlushFlag::Down for notes on flushing down.

Definition at line 1391 of file bmesh_uvselect.cc.

References bm, BM_mesh_uvselect_flush_from_faces(), BM_mesh_uvselect_flush_from_loop_edges(), BM_mesh_uvselect_flush_from_loop_verts(), SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by BM_mesh_uvselect_mode_flush(), and bpy_bmesh_uv_select_flush_mode().

◆ BM_mesh_uvselect_mode_flush_only_select()

void BM_mesh_uvselect_mode_flush_only_select ( BMesh * bm)

Select elements based on the selection mode. (flushes the selection up based on the mode).

  • With vertex selection mode enabled: flush up to edges and faces.
  • With edge selection mode enabled: flush to faces.
  • With only face selection mode enabled: do nothing.
Note
An "only deselect" version function could be added, it's not needed at the moment.a

Definition at line 1409 of file bmesh_uvselect.cc.

References bm, BM_mesh_uvselect_flush_from_loop_edges_only_select(), BM_mesh_uvselect_flush_from_loop_verts_only_select(), SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by BM_mesh_uvselect_flush_post_subdivide().

◆ BM_mesh_uvselect_mode_flush_update()

void BM_mesh_uvselect_mode_flush_update ( BMesh * bm,
short selectmode_old,
short selectmode_new,
int cd_loop_uv_offset )

When the select mode changes, update to ensure the selection is valid. So single vertices aren't selected in edge-select mode for example.

The mesh selection flushing must have already run.

Definition at line 1422 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_disable, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_FACES_OF_MESH, BM_ITER_MESH, BM_mesh_uvselect_flush_from_loop_edges(), BM_mesh_uvselect_flush_from_loop_verts(), bm_mesh_uvselect_mode_flush_down_deselect_only(), BMLoop::e, highest_order_bit_s(), BMLoop::next, SCE_SELECT_EDGE, SCE_SELECT_VERTEX, shared, and BMLoop::v.

Referenced by EDBM_selectmode_set(), and uv_select_sync_update().

◆ BM_mesh_uvselect_set_elem_from_mesh() [1/2]

void BM_mesh_uvselect_set_elem_from_mesh ( BMesh * bm,
bool select,
const BMUVSelectPickParams & params,
blender::Span< BMVert * > verts,
blender::Span< BMEdge * > edges,
blender::Span< BMFace * > faces )

Select/deselect elements in the viewport, then integrate the selection with the UV selection, without clearing an re-initializing the synchronized state. (likely to re-select islands bounds from a user-perspective).

Definition at line 1026 of file bmesh_uvselect.cc.

References bm, BM_edge_uvselect_set_pick(), BM_face_uvselect_set_pick(), bm_mesh_uvselect_mode_flush_down_deselect_only(), BM_vert_uvselect_set_pick(), e, faces, blender::Span< T >::is_empty(), params, select, v, and verts.

◆ BM_mesh_uvselect_set_elem_from_mesh() [2/2]

void BM_mesh_uvselect_set_elem_from_mesh ( BMesh * bm,
bool select,
const BMUVSelectPickParams & params,
const blender::VectorList< BMVert * > & verts,
const blender::VectorList< BMEdge * > & edges,
const blender::VectorList< BMFace * > & faces )

Definition at line 999 of file bmesh_uvselect.cc.

References bm, bm_edge_uvselect_set_pick(), bm_face_uvselect_set_pick(), bm_mesh_uvselect_mode_flush_down_deselect_only(), bm_vert_uvselect_set_pick(), e, faces, blender::VectorList< T, CapacityStart, CapacityMax >::is_empty(), params, select, v, and verts.

Referenced by blender::ed::uv::UVSyncSelectFromMesh::apply(), and bpy_bmesh_uv_select_foreach_set_from_mesh().

◆ BM_mesh_uvselect_set_elem_shared()

void BM_mesh_uvselect_set_elem_shared ( BMesh * bm,
bool select,
const int cd_loop_uv_offset,
const blender::Span< BMLoop * > loop_verts,
const blender::Span< BMLoop * > loop_edges,
const blender::Span< BMFace * > faces )

Definition at line 419 of file bmesh_uvselect.cc.

References bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE_FIRST_LOOP, BM_face_uvselect_set_noflush(), BM_face_uvselect_set_shared(), BM_loop_edge_uvselect_check_other_face(), BM_loop_edge_uvselect_set_shared(), BM_loop_vert_uvselect_check_other_loop_edge(), BM_loop_vert_uvselect_set_shared(), faces, BMLoop::next, and select.

Referenced by bpy_bmesh_uv_select_foreach_set().

◆ BM_mesh_uvselect_sync_from_mesh_sticky_disabled()

void BM_mesh_uvselect_sync_from_mesh_sticky_disabled ( BMesh * bm)

Definition at line 1793 of file bmesh_uvselect.cc.

References BLI_assert, bm, and bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode().

Referenced by bpy_bmesh_uv_select_sync_from_mesh(), and uvedit_sync_uvselect_flush_from_v3d().

◆ BM_mesh_uvselect_sync_from_mesh_sticky_location()

void BM_mesh_uvselect_sync_from_mesh_sticky_location ( BMesh * bm,
const int cd_loop_uv_offset )

Definition at line 1778 of file bmesh_uvselect.cc.

References BLI_assert, bm, bm_mesh_uvselect_flush_from_mesh_sticky_location_for_edge_mode(), bm_mesh_uvselect_flush_from_mesh_sticky_location_for_face_mode(), bm_mesh_uvselect_flush_from_mesh_sticky_location_for_vert_mode(), SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by bpy_bmesh_uv_select_sync_from_mesh(), and uvedit_sync_uvselect_flush_from_v3d().

◆ BM_mesh_uvselect_sync_from_mesh_sticky_vert()

void BM_mesh_uvselect_sync_from_mesh_sticky_vert ( BMesh * bm)

Definition at line 1801 of file bmesh_uvselect.cc.

References BLI_assert, bm, bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_edge_mode(), bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_face_mode(), bm_mesh_uvselect_flush_from_mesh_sticky_vert_for_vert_mode(), SCE_SELECT_EDGE, and SCE_SELECT_VERTEX.

Referenced by bpy_bmesh_uv_select_sync_from_mesh(), and uvedit_sync_uvselect_flush_from_v3d().

◆ BM_mesh_uvselect_sync_to_mesh()

void BM_mesh_uvselect_sync_to_mesh ( BMesh * bm)

Synchronize selection: from the UV selection to the 3D viewport.

Note
BMesh::uv_select_sync_valid must be true.

Definition at line 1815 of file bmesh_uvselect.cc.

References BLI_assert, bm, BM_EDGE, BM_edge_select_set(), BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT, BM_ELEM_SELECT_UV, BM_ELEM_SELECT_UV_EDGE, BM_FACE, BM_FACE_FIRST_LOOP, BM_face_select_set(), BM_face_select_set_noflush(), BM_FACES_OF_MESH, BM_ITER_MESH, BM_mesh_elem_hflag_disable_all(), BM_mesh_select_flush_from_verts(), BM_SELECT_HISTORY_BACKUP, BM_SELECT_HISTORY_RESTORE, BM_select_history_validate(), BM_VERT, BM_vert_select_set(), BMLoop::e, BMLoop::next, SCE_SELECT_EDGE, SCE_SELECT_VERTEX, and BMLoop::v.

Referenced by bpy_bmesh_uv_select_sync_to_mesh(), ED_uvedit_select_sync_flush(), uv_mouse_select_multi(), uv_select_invert(), uv_select_linked_multi(), uv_select_more_less(), uv_select_similar_edge_exec(), uv_select_similar_face_exec(), uv_select_similar_island_exec(), and uv_select_similar_vert_exec().

◆ BM_vert_uvselect_set_pick()

void BM_vert_uvselect_set_pick ( BMesh * bm,
BMVert * v,
bool select,
const BMUVSelectPickParams & params )

Definition at line 856 of file bmesh_uvselect.cc.

References bm, bm_vert_uvselect_set_pick(), params, select, and v.

Referenced by BM_mesh_uvselect_set_elem_from_mesh(), and EDBM_select_pick().

◆ bm_vert_uvselect_set_pick()

void bm_vert_uvselect_set_pick ( BMesh * bm,
BMVert * v,
const bool select,
const BMUVSelectPickParams & ,
bool caller_handles_edge_or_face_mode )
static

Definition at line 530 of file bmesh_uvselect.cc.

References BLI_assert_msg, bm, BM_elem_flag_test, BM_ELEM_HIDDEN, BM_ELEM_SELECT_UV, BM_face_uvselect_check_edges_all(), BM_face_uvselect_set_noflush(), BM_loop_edge_uvselect_set_noflush(), BM_loop_vert_uvselect_set_noflush(), bmesh_disk_edge_next(), BMLoop::f, BMEdge::l, BMLoop::next, BMLoop::prev, BMLoop::radial_next, SCE_SELECT_VERTEX, select, BMLoop::v, and v.

Referenced by BM_mesh_uvselect_set_elem_from_mesh(), and BM_vert_uvselect_set_pick().

Generated on for Blender by  doxygen 1.16.1