e955c94ed3
Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783.
93 lines
3.2 KiB
C
93 lines
3.2 KiB
C
/* SPDX-FileCopyrightText: 2023 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bmesh
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Retrieve the custom data offsets for the UV map.
|
|
* \param layer: The layer index (where 0 is the first UV map).
|
|
* \return The layer offsets or -1 when not found.
|
|
*/
|
|
BMUVOffsets BM_uv_map_get_offsets_from_layer(const BMesh *bm, int layer);
|
|
|
|
/**
|
|
* Retrieve the custom data offsets for layers used for user interaction with the active UV map.
|
|
* \return The layer offsets or -1 when not found.
|
|
*/
|
|
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
|