bmesh_uvselect.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2025 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
 
#pragma once
 
#include "bmesh_class.hh"
 
#include "BLI_vector_list.hh"

 
/* -------------------------------------------------------------------- */
 
bool BM_face_uvselect_test(const BMFace *f);
bool BM_loop_vert_uvselect_test(const BMLoop *l);
bool BM_loop_edge_uvselect_test(const BMLoop *l);

 
/* -------------------------------------------------------------------- */
 
bool BM_loop_vert_uvselect_check_other_loop_vert(BMLoop *l, char hflag, int cd_loop_uv_offset);
bool BM_loop_vert_uvselect_check_other_loop_edge(BMLoop *l, char hflag, int cd_loop_uv_offset);
bool BM_loop_vert_uvselect_check_other_edge(BMLoop *l, char hflag, int cd_loop_uv_offset);
bool BM_loop_vert_uvselect_check_other_face(BMLoop *l, char hflag, int cd_loop_uv_offset);
bool BM_loop_edge_uvselect_check_other_loop_edge(BMLoop *l, char hflag, int cd_loop_uv_offset);
bool BM_loop_edge_uvselect_check_other_face(BMLoop *l, char hflag, int cd_loop_uv_offset);
 
bool BM_face_uvselect_check_edges_all(BMFace *f);

 
/* -------------------------------------------------------------------- */

void BM_face_uvselect_set_noflush(BMesh *bm, BMFace *f, bool select);
void BM_face_uvselect_set(BMesh *bm, BMFace *f, 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_loop_vert_uvselect_set_noflush(BMesh *bm, BMLoop *l, bool select);

bool BM_mesh_uvselect_clear(BMesh *bm);

 
/* -------------------------------------------------------------------- */
 
void BM_loop_vert_uvselect_set_shared(BMesh *bm, BMLoop *l, bool select, int cd_loop_uv_offset);
void BM_loop_edge_uvselect_set_shared(BMesh *bm, BMLoop *l, bool select, int cd_loop_uv_offset);
void BM_face_uvselect_set_shared(BMesh *bm, BMFace *f, bool select, int cd_loop_uv_offset);
 
void BM_mesh_uvselect_set_elem_shared(BMesh *bm,
                                      bool select,
                                      int cd_loop_uv_offset,
                                      blender::Span<BMLoop *> loop_verts,
                                      blender::Span<BMLoop *> loop_edges,
                                      blender::Span<BMFace *> faces);

 
/* -------------------------------------------------------------------- */
 
struct BMUVSelectPickParams {
  int cd_loop_uv_offset = -1;
  bool shared = true;
};
 
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);

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

 
/* -------------------------------------------------------------------- */
 
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, int cd_loop_uv_offset);
void BM_mesh_uvselect_flush_shared_only_deselect(BMesh *bm, int cd_loop_uv_offset);

 
/* -------------------------------------------------------------------- */

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, bool select);

 
/* -------------------------------------------------------------------- */

void BM_mesh_uvselect_mode_flush_ex(BMesh *bm, const short selectmode, 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,
                                        short selectmode_old,
                                        short selectmode_new,
                                        int cd_loop_uv_offset);

void BM_mesh_uvselect_flush_post_subdivide(BMesh *bm, int cd_loop_uv_offset);

 
/* -------------------------------------------------------------------- */
 
/* From 3D viewport to UV selection.
 *
 * These functions correspond to #ToolSettings::uv_sticky options. */
 
void BM_mesh_uvselect_sync_from_mesh_sticky_location(BMesh *bm, 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);

 
/* -------------------------------------------------------------------- */

struct UVSelectValidateInfo_Sync {
  int count_uv_vert_any_selected_with_vert_unselected = 0;
  int count_uv_vert_none_selected_with_vert_selected = 0;

  int count_uv_edge_any_selected_with_edge_unselected = 0;
  int count_uv_edge_none_selected_with_edge_selected = 0;
};

struct UVSelectValidateInfo_Flush {
  int count_uv_edge_selected_with_any_verts_unselected = 0;
  int count_uv_edge_unselected_with_all_verts_selected = 0;

  int count_uv_face_selected_with_any_verts_unselected = 0;
  int count_uv_face_unselected_with_all_verts_selected = 0;

  int count_uv_face_selected_with_any_edges_unselected = 0;
  int count_uv_face_unselected_with_all_edges_selected = 0;
};

struct UVSelectValidateInfo_Contiguous {
  int count_uv_vert_non_contiguous_selected = 0;
  int count_uv_edge_non_contiguous_selected = 0;
};

struct UVSelectValidateInfo_FlushAndContiguous {
  int count_uv_vert_isolated_in_edge_or_face_mode = 0;
  int count_uv_vert_isolated_in_face_mode = 0;
  int count_uv_edge_isolated_in_face_mode = 0;
};
 
struct UVSelectValidateInfo {
  UVSelectValidateInfo_Sync sync;
 
  UVSelectValidateInfo_Flush flush;
  UVSelectValidateInfo_Contiguous contiguous;
  UVSelectValidateInfo_FlushAndContiguous flush_contiguous;
};

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