This will allow much finer controll over how we copy data-blocks, from full copy in Main database, to "lighter" ones (out of Main, inside an already allocated datablock, etc.). This commit also transfers a llot of what was previously handled by per-ID-type custom code to generic ID handling code in BKE_library. Hopefully will avoid in future inconsistencies and missing bits we had all over the codebase in the past. It also adds missing copying handling for a few types, most notably Scene (which where using a fully customized handling previously). Note that the type of allocation used during copying (regular in Main, allocated but outside of Main, or not allocated by ID handling code at all) is stored in ID's, which allows to handle them correctly when freeing. This needs to be taken care of with caution when doing 'weird' unusual things with ID copying and/or allocation! As a final note, while rather noisy, this commit will hopefully not break too much existing branches, old 'API' has been kept for the main part, as a wrapper around new code. Cleaning it up will happen later. Design task : T51804 Phab Diff: D2714
126 lines
5.1 KiB
C++
126 lines
5.1 KiB
C++
/*
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
|
|
* All rights reserved.
|
|
*
|
|
* The Original Code is: all of this file.
|
|
*
|
|
* Contributor(s): none yet.
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
#ifndef __BKE_KEY_H__
|
|
#define __BKE_KEY_H__
|
|
|
|
/** \file BKE_key.h
|
|
* \ingroup bke
|
|
* \since March 2001
|
|
* \author nzc
|
|
*/
|
|
struct Key;
|
|
struct KeyBlock;
|
|
struct ID;
|
|
struct ListBase;
|
|
struct Curve;
|
|
struct Object;
|
|
struct Lattice;
|
|
struct Main;
|
|
struct Mesh;
|
|
struct WeightsArrayCache;
|
|
|
|
/* Kernel prototypes */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
void BKE_key_free(struct Key *sc);
|
|
void BKE_key_free_nolib(struct Key *key);
|
|
struct Key *BKE_key_add(struct ID *id);
|
|
void BKE_key_copy_data(struct Main *bmain, struct Key *key_dst, const struct Key *key_src, const int flag);
|
|
struct Key *BKE_key_copy(struct Main *bmain, const struct Key *key);
|
|
struct Key *BKE_key_copy_nolib(struct Key *key);
|
|
void BKE_key_sort(struct Key *key);
|
|
|
|
void key_curve_position_weights(float t, float data[4], int type);
|
|
void key_curve_tangent_weights(float t, float data[4], int type);
|
|
void key_curve_normal_weights(float t, float data[4], int type);
|
|
|
|
float *BKE_key_evaluate_object_ex(
|
|
struct Object *ob, int *r_totelem,
|
|
float *arr, size_t arr_size);
|
|
float *BKE_key_evaluate_object(
|
|
struct Object *ob, int *r_totelem);
|
|
|
|
struct Key **BKE_key_from_id_p(struct ID *id);
|
|
struct Key *BKE_key_from_id(struct ID *id);
|
|
struct Key **BKE_key_from_object_p(struct Object *ob);
|
|
struct Key *BKE_key_from_object(struct Object *ob);
|
|
struct KeyBlock *BKE_keyblock_from_object(struct Object *ob);
|
|
struct KeyBlock *BKE_keyblock_from_object_reference(struct Object *ob);
|
|
|
|
struct KeyBlock *BKE_keyblock_add(struct Key *key, const char *name);
|
|
struct KeyBlock *BKE_keyblock_add_ctime(struct Key *key, const char *name, const bool do_force);
|
|
struct KeyBlock *BKE_keyblock_from_key(struct Key *key, int index);
|
|
struct KeyBlock *BKE_keyblock_find_name(struct Key *key, const char name[]);
|
|
void BKE_keyblock_copy_settings(struct KeyBlock *kb_dst, const struct KeyBlock *kb_src);
|
|
char *BKE_keyblock_curval_rnapath_get(struct Key *key, struct KeyBlock *kb);
|
|
|
|
// needed for the GE
|
|
typedef struct WeightsArrayCache {
|
|
int num_defgroup_weights;
|
|
float **defgroup_weights;
|
|
} WeightsArrayCache;
|
|
|
|
float **BKE_keyblock_get_per_block_weights(struct Object *ob, struct Key *key, struct WeightsArrayCache *cache);
|
|
void BKE_keyblock_free_per_block_weights(struct Key *key, float **per_keyblock_weights, struct WeightsArrayCache *cache);
|
|
void BKE_key_evaluate_relative(const int start, int end, const int tot, char *basispoin, struct Key *key, struct KeyBlock *actkb,
|
|
float **per_keyblock_weights, const int mode);
|
|
|
|
/* conversion functions */
|
|
/* Note: 'update_from' versions do not (re)allocate mem in kb, while 'convert_from' do. */
|
|
void BKE_keyblock_update_from_lattice(struct Lattice *lt, struct KeyBlock *kb);
|
|
void BKE_keyblock_convert_from_lattice(struct Lattice *lt, struct KeyBlock *kb);
|
|
void BKE_keyblock_convert_to_lattice(struct KeyBlock *kb, struct Lattice *lt);
|
|
|
|
void BKE_keyblock_update_from_curve(struct Curve *cu, struct KeyBlock *kb, struct ListBase *nurb);
|
|
void BKE_keyblock_convert_from_curve(struct Curve *cu, struct KeyBlock *kb, struct ListBase *nurb);
|
|
void BKE_keyblock_convert_to_curve(struct KeyBlock *kb, struct Curve *cu, struct ListBase *nurb);
|
|
|
|
void BKE_keyblock_update_from_mesh(struct Mesh *me, struct KeyBlock *kb);
|
|
void BKE_keyblock_convert_from_mesh(struct Mesh *me, struct KeyBlock *kb);
|
|
void BKE_keyblock_convert_to_mesh(struct KeyBlock *kb, struct Mesh *me);
|
|
void BKE_keyblock_mesh_calc_normals(
|
|
struct KeyBlock *kb, struct Mesh *mesh, float (*r_vertnors)[3], float (*r_polynors)[3], float (*r_loopnors)[3]);
|
|
|
|
void BKE_keyblock_update_from_vertcos(struct Object *ob, struct KeyBlock *kb, float (*vertCos)[3]);
|
|
void BKE_keyblock_convert_from_vertcos(struct Object *ob, struct KeyBlock *kb, float (*vertCos)[3]);
|
|
float (*BKE_keyblock_convert_to_vertcos(struct Object *ob, struct KeyBlock *kb))[3];
|
|
|
|
void BKE_keyblock_update_from_offset(struct Object *ob, struct KeyBlock *kb, float (*ofs)[3]);
|
|
|
|
/* other management */
|
|
bool BKE_keyblock_move(struct Object *ob, int org_index, int new_index);
|
|
|
|
bool BKE_keyblock_is_basis(struct Key *key, const int index);
|
|
|
|
#ifdef __cplusplus
|
|
};
|
|
#endif
|
|
|
|
#endif /* __BKE_KEY_H__ */
|