c1bc70b711
A lot of files were missing copyright field in the header and
the Blender Foundation contributed to them in a sense of bug
fixing and general maintenance.
This change makes it explicit that those files are at least
partially copyrighted by the Blender Foundation.
Note that this does not make it so the Blender Foundation is
the only holder of the copyright in those files, and developers
who do not have a signed contract with the foundation still
hold the copyright as well.
Another aspect of this change is using SPDX format for the
header. We already used it for the license specification,
and now we state it for the copyright as well, following the
FAQ:
https://reuse.software/faq/
93 lines
3.2 KiB
C
93 lines
3.2 KiB
C
/* SPDX-FileCopyrightText: 2023 Blender Foundation
|
|
*
|
|
* 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
|