Implement the next phases of bounds improvement design #96968. Mainly the following changes: Don't use `Object.runtime.bb` for performance caching volume bounds. This is redundant with the cache in most geometry data-block types. Instead, this becomes `Object.runtime.bounds_eval`, and is only used where it's actually needed: syncing the bounds from the evaluated geometry in the active depsgraph to the original object. Remove all redundant functions to access geometry bounds with an Object argument. These make the whole design confusing, since they access geometry bounds at an object level. Use `std::optional<Bounds<float3>>` to pass and store bounds instead of an allocated `BoundBox` struct. This uses less space, avoids small heap allocations, and generally simplifies code, since we usually only want the min and max anyway. After this, to avoid performance regressions, we should also cache bounds in volumes, and maybe the legacy curve and GP data types (though it might not be worth the effort for those legacy types). Pull Request: https://projects.blender.org/blender/blender/pulls/114933
104 lines
3.6 KiB
C
104 lines
3.6 KiB
C
/* SPDX-FileCopyrightText: 2001-2002 NaN Holding BV. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Base;
|
|
struct Depsgraph;
|
|
struct Main;
|
|
struct MetaBall;
|
|
struct MetaElem;
|
|
struct Object;
|
|
struct Scene;
|
|
|
|
struct MetaBall *BKE_mball_add(struct Main *bmain, const char *name);
|
|
|
|
bool BKE_mball_is_any_selected(const struct MetaBall *mb);
|
|
bool BKE_mball_is_any_selected_multi(struct Base **bases, int bases_len);
|
|
bool BKE_mball_is_any_unselected(const struct MetaBall *mb);
|
|
|
|
/**
|
|
* Return `true` if `ob1` and `ob2` are part of the same metaBall group.
|
|
*
|
|
* \note Currently checks whether their two base names (without numerical suffix) is the same.
|
|
*/
|
|
bool BKE_mball_is_same_group(const struct Object *ob1, const struct Object *ob2);
|
|
/**
|
|
* Return `true` if `ob1` and `ob2` are part of the same metaBall group, and `ob1` is its
|
|
* basis.
|
|
*/
|
|
bool BKE_mball_is_basis_for(const struct Object *ob1, const struct Object *ob2);
|
|
/**
|
|
* Test, if \a ob is a basis meta-ball.
|
|
*
|
|
* It test last character of Object ID name.
|
|
* If last character is digit it return 0, else it return 1.
|
|
*/
|
|
bool BKE_mball_is_basis(const struct Object *ob);
|
|
/**
|
|
* This function finds the basis meta-ball.
|
|
*
|
|
* Basis meta-ball doesn't include any number at the end of
|
|
* its name. All meta-balls with same base of name can be
|
|
* blended. meta-balls with different basic name can't be blended.
|
|
*
|
|
* \warning #BKE_mball_is_basis() can fail on returned object, see function docs for details.
|
|
*/
|
|
struct Object *BKE_mball_basis_find(struct Scene *scene, struct Object *ob);
|
|
|
|
/**
|
|
* Copy some properties from a meta-ball obdata to all other meta-ball obdata belonging to the same
|
|
* family (i.e. object sharing the same name basis).
|
|
*
|
|
* When some properties (wire-size, threshold, update flags) of meta-ball are changed, then this
|
|
* properties are copied to all meta-balls in same "group" (meta-balls with same base name:
|
|
* `MBall`, `MBall.001`, `MBall.002`, etc). The most important is to copy properties to the base
|
|
* meta-ball, because this meta-ball influences polygonization of meta-balls.
|
|
*/
|
|
void BKE_mball_properties_copy(struct Main *bmain, struct MetaBall *metaball_src);
|
|
|
|
bool BKE_mball_minmax_ex(
|
|
const struct MetaBall *mb, float min[3], float max[3], const float obmat[4][4], short flag);
|
|
|
|
/* Basic vertex data functions. */
|
|
|
|
bool BKE_mball_minmax(const struct MetaBall *mb, float min[3], float max[3]);
|
|
bool BKE_mball_center_median(const struct MetaBall *mb, float r_cent[3]);
|
|
bool BKE_mball_center_bounds(const struct MetaBall *mb, float r_cent[3]);
|
|
void BKE_mball_transform(struct MetaBall *mb, const float mat[4][4], bool do_props);
|
|
void BKE_mball_translate(struct MetaBall *mb, const float offset[3]);
|
|
|
|
/**
|
|
* Most simple meta-element adding function.
|
|
*
|
|
* \note don't do context manipulation here (rna uses).
|
|
*/
|
|
struct MetaElem *BKE_mball_element_add(struct MetaBall *mb, int type);
|
|
|
|
/* *** Select functions *** */
|
|
|
|
int BKE_mball_select_count(const struct MetaBall *mb);
|
|
int BKE_mball_select_count_multi(struct Base **bases, int bases_len);
|
|
bool BKE_mball_select_all(struct MetaBall *mb);
|
|
bool BKE_mball_select_all_multi_ex(struct Base **bases, int bases_len);
|
|
bool BKE_mball_deselect_all(struct MetaBall *mb);
|
|
bool BKE_mball_deselect_all_multi_ex(struct Base **bases, int bases_len);
|
|
bool BKE_mball_select_swap(struct MetaBall *mb);
|
|
bool BKE_mball_select_swap_multi_ex(struct Base **bases, int bases_len);
|
|
|
|
/* **** Depsgraph evaluation **** */
|
|
|
|
void BKE_mball_data_update(struct Depsgraph *depsgraph, struct Scene *scene, struct Object *ob);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|