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/
96 lines
3.1 KiB
C
96 lines
3.1 KiB
C
/* SPDX-FileCopyrightText: 2023 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bmesh
|
|
*/
|
|
|
|
#include "BLI_compiler_attrs.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Parameters used to determine which kinds of data needs to be generated.
|
|
*/
|
|
typedef struct BMPartialUpdate_Params {
|
|
bool do_normals;
|
|
bool do_tessellate;
|
|
} BMPartialUpdate_Params;
|
|
|
|
/**
|
|
* Cached data to speed up partial updates.
|
|
*
|
|
* Hints:
|
|
*
|
|
* - Avoid creating this data for single updates,
|
|
* it should be created and reused across multiple updates to gain a significant benefit
|
|
* (while transforming geometry for example).
|
|
*
|
|
* - Partial normal updates use face & loop indices,
|
|
* setting them to dirty values between updates will slow down normal recalculation.
|
|
*/
|
|
typedef struct BMPartialUpdate {
|
|
BMVert **verts;
|
|
BMFace **faces;
|
|
int verts_len, verts_len_alloc;
|
|
int faces_len, faces_len_alloc;
|
|
|
|
/** Store the parameters used in creation so invalid use can be asserted. */
|
|
BMPartialUpdate_Params params;
|
|
} BMPartialUpdate;
|
|
|
|
/**
|
|
* All Tagged & Connected, see: #BM_mesh_partial_create_from_verts
|
|
* Operate on everything that's tagged as well as connected geometry.
|
|
*/
|
|
BMPartialUpdate *BM_mesh_partial_create_from_verts(BMesh *bm,
|
|
const BMPartialUpdate_Params *params,
|
|
const unsigned int *verts_mask,
|
|
int verts_mask_count)
|
|
ATTR_NONNULL(1, 2, 3) ATTR_WARN_UNUSED_RESULT;
|
|
|
|
/**
|
|
* All Connected, operate on all faces that have both tagged and un-tagged vertices.
|
|
*
|
|
* Reduces computations when transforming isolated regions.
|
|
*/
|
|
BMPartialUpdate *BM_mesh_partial_create_from_verts_group_single(
|
|
BMesh *bm,
|
|
const BMPartialUpdate_Params *params,
|
|
const unsigned int *verts_mask,
|
|
int verts_mask_count) ATTR_NONNULL(1, 2, 3) ATTR_WARN_UNUSED_RESULT;
|
|
|
|
/**
|
|
* All Connected, operate on all faces that have vertices in the same group.
|
|
*
|
|
* Reduces computations when transforming isolated regions.
|
|
*
|
|
* This is a version of #BM_mesh_partial_create_from_verts_group_single
|
|
* that handles multiple groups instead of a bitmap mask.
|
|
*
|
|
* This is needed for example when transform has mirror enabled,
|
|
* since one side needs to have a different group to the other since a face that has vertices
|
|
* attached to both won't have an affine transformation.
|
|
*
|
|
* \param verts_group: Vertex aligned array of groups.
|
|
* Values are used as follows:
|
|
* - >0: Each face is grouped with other faces of the same group.
|
|
* - 0: Not in a group (don't handle these).
|
|
* - -1: Don't use grouping logic (include any face that contains a vertex with this group).
|
|
* \param verts_group_count: The number of non-zero values in `verts_groups`.
|
|
*/
|
|
BMPartialUpdate *BM_mesh_partial_create_from_verts_group_multi(
|
|
BMesh *bm, const BMPartialUpdate_Params *params, const int *verts_group, int verts_group_count)
|
|
ATTR_NONNULL(1, 2, 3) ATTR_WARN_UNUSED_RESULT;
|
|
|
|
void BM_mesh_partial_destroy(BMPartialUpdate *bmpinfo) ATTR_NONNULL(1);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|