6c774feba2
Currently the `MLoopUV` struct stores UV coordinates and flags related to editing UV maps in the UV editor. This patch changes the coordinates to use the generic 2D vector type, and moves the flags into three separate boolean attributes. This follows the design in T95965, with the ultimate intention of simplifying code and improving performance. Importantly, the change allows exporters and renderers to use UVs "touched" by geometry nodes, which only creates generic attributes. It also allows geometry nodes to create "proper" UV maps from scratch, though only with the Store Named Attribute node for now. The new design considers any 2D vector attribute on the corner domain to be a UV map. In the future, they might be distinguished from regular 2D vectors with attribute metadata, which may be helpful because they are often interpolated differently. Most of the code changes deal with passing around UV BMesh custom data offsets and tracking the boolean "sublayers". The boolean layers are use the following prefixes for attribute names: vert selection: `.vs.`, edge selection: `.es.`, pinning: `.pn.`. Currently these are short to avoid using up the maximum length of attribute names. To accommodate for these 4 extra characters, the name length limit is enlarged to 68 bytes, while the maximum user settable name length is still 64 bytes. Unfortunately Python/RNA API access to the UV flag data becomes slower. Accessing the boolean layers directly is be better for performance in general. Like the other mesh SoA refactors, backward and forward compatibility aren't affected, and won't be changed until 4.0. We pay for that by making mesh reading and writing more expensive with conversions. Resolves T85962 Differential Revision: https://developer.blender.org/D14365
83 lines
2.9 KiB
C
83 lines
2.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bmesh
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Retrieve the custom data offsets for layers used for user interaction with the active UV map.
|
|
*/
|
|
BMUVOffsets BM_uv_map_get_offsets(const BMesh *bm);
|
|
|
|
float BM_loop_uv_calc_edge_length_squared(const BMLoop *l,
|
|
int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT
|
|
ATTR_NONNULL();
|
|
float BM_loop_uv_calc_edge_length(const BMLoop *l, int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT
|
|
ATTR_NONNULL();
|
|
|
|
/**
|
|
* Computes the UV center of a face, using the mean average weighted by edge length.
|
|
*
|
|
* See #BM_face_calc_center_median_weighted for matching spatial functionality.
|
|
*
|
|
* \param aspect: Calculate the center scaling by these values, and finally dividing.
|
|
* Since correct weighting depends on having the correct aspect.
|
|
*/
|
|
void BM_face_uv_calc_center_median_weighted(const BMFace *f,
|
|
const float aspect[2],
|
|
int cd_loop_uv_offset,
|
|
float r_cent[2]) ATTR_NONNULL();
|
|
void BM_face_uv_calc_center_median(const BMFace *f, int cd_loop_uv_offset, float r_cent[2])
|
|
ATTR_NONNULL();
|
|
|
|
/**
|
|
* Calculate the UV cross product (use the sign to check the winding).
|
|
*/
|
|
float BM_face_uv_calc_cross(const BMFace *f, int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT
|
|
ATTR_NONNULL();
|
|
|
|
void BM_face_uv_minmax(const BMFace *f, float min[2], float max[2], int cd_loop_uv_offset);
|
|
|
|
bool BM_loop_uv_share_edge_check_with_limit(BMLoop *l_a,
|
|
BMLoop *l_b,
|
|
const float limit[2],
|
|
int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT
|
|
ATTR_NONNULL();
|
|
|
|
/**
|
|
* Check if two loops that share an edge also have the same UV coordinates.
|
|
*/
|
|
bool BM_loop_uv_share_edge_check(BMLoop *l_a,
|
|
BMLoop *l_b,
|
|
int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
|
|
|
|
/**
|
|
* Check if two loops that share a vertex also have the same UV coordinates.
|
|
*/
|
|
bool BM_edge_uv_share_vert_check(BMEdge *e, BMLoop *l_a, BMLoop *l_b, int cd_loop_uv_offset)
|
|
ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
|
|
|
|
/**
|
|
* Check if two loops that share a vertex also have the same UV coordinates.
|
|
*/
|
|
bool BM_loop_uv_share_vert_check(BMLoop *l_a,
|
|
BMLoop *l_b,
|
|
int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
|
|
|
|
/**
|
|
* Check if the point is inside the UV face.
|
|
*/
|
|
bool BM_face_uv_point_inside_test(const BMFace *f,
|
|
const float co[2],
|
|
int cd_loop_uv_offset) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|