Joshua Leung
7f133f65b2
RNA Paths used in F-Curve, Drivers, etc. now get renamed when some data that they use gets renamed. This only works when things like Bones, Constraints, Shape Keys, and Modifiers get renamed, but other cases can get added easily. The code here only performs simple string replacements, so there is the potential for problems when several sets of data with the same names are present. For example, if there are multiple armatures with bones that have the same names, renaming a bone on one armature (with a bone on another armature having the same name) will break all the drivers on the other one, even though they aren't really connected. However, I don't expect the aforementioned scenario to really be a problem in most production scenarios.
124 lines
4.3 KiB
C++
124 lines
4.3 KiB
C++
/**
|
|
* $Id$
|
|
*
|
|
* ***** 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*
|
|
* The Original Code is Copyright (C) 2009 Blender Foundation, Joshua Leung
|
|
* All rights reserved.
|
|
*
|
|
* Contributor(s): Joshua Leung (original author)
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
|
|
#ifndef BKE_ANIM_SYS_H
|
|
#define BKE_ANIM_SYS_H
|
|
|
|
struct ID;
|
|
struct ListBase;
|
|
struct Main;
|
|
struct AnimData;
|
|
struct KeyingSet;
|
|
struct KS_Path;
|
|
|
|
struct PointerRNA;
|
|
struct bAction;
|
|
struct bActionGroup;
|
|
struct AnimMapper;
|
|
|
|
/* ************************************* */
|
|
/* AnimData API */
|
|
|
|
/* Get AnimData from the given ID-block. */
|
|
struct AnimData *BKE_animdata_from_id(struct ID *id);
|
|
|
|
/* Add AnimData to the given ID-block */
|
|
struct AnimData *BKE_id_add_animdata(struct ID *id);
|
|
|
|
/* Free AnimData */
|
|
void BKE_free_animdata(struct ID *id);
|
|
|
|
/* Copy AnimData */
|
|
struct AnimData *BKE_copy_animdata(struct AnimData *adt);
|
|
|
|
/* Make Local */
|
|
void BKE_animdata_make_local(struct AnimData *adt);
|
|
|
|
/* ************************************* */
|
|
/* KeyingSets API */
|
|
|
|
/* Used to create a new 'custom' KeyingSet for the user, that will be automatically added to the stack */
|
|
struct KeyingSet *BKE_keyingset_add(struct ListBase *list, const char name[], short flag, short keyingflag);
|
|
|
|
/* Add a destination to a KeyingSet */
|
|
void BKE_keyingset_add_destination(struct KeyingSet *ks, struct ID *id, const char group_name[], const char rna_path[], int array_index, short flag, short groupmode);
|
|
|
|
/* Find the destination matching the criteria given */
|
|
struct KS_Path *BKE_keyingset_find_destination(struct KeyingSet *ks, struct ID *id, const char group_name[], const char rna_path[], int array_index, int group_mode);
|
|
|
|
/* Copy all KeyingSets in the given list */
|
|
void BKE_keyingsets_copy(struct ListBase *newlist, struct ListBase *list);
|
|
|
|
/* Free data for KeyingSet but not set itself */
|
|
void BKE_keyingset_free(struct KeyingSet *ks);
|
|
|
|
/* Free all the KeyingSets in the given list */
|
|
void BKE_keyingsets_free(struct ListBase *list);
|
|
|
|
/* ************************************* */
|
|
/* Path Fixing API */
|
|
|
|
/* Fix all the paths for the given ID+AnimData */
|
|
void BKE_animdata_fix_paths_rename(struct ID *owner_id, struct AnimData *adt, char *prefix, char *oldName, char *newName);
|
|
|
|
/* Fix all the paths for the entire database... */
|
|
void BKE_all_animdata_fix_paths_rename(char *prefix, char *oldName, char *newName);
|
|
|
|
/* ************************************* */
|
|
// TODO: overrides, remapping, and path-finding api's
|
|
|
|
/* ************************************* */
|
|
/* Evaluation API */
|
|
|
|
/* ------------- Main API -------------------- */
|
|
/* In general, these ones should be called to do all animation evaluation */
|
|
|
|
/* Evaluation loop for evaluating animation data */
|
|
void BKE_animsys_evaluate_animdata(struct ID *id, struct AnimData *adt, float ctime, short recalc);
|
|
|
|
/* Evaluation of all ID-blocks with Animation Data blocks - Animation Data Only */
|
|
void BKE_animsys_evaluate_all_animation(struct Main *main, float ctime);
|
|
|
|
|
|
/* ------------ Specialised API --------------- */
|
|
/* There are a few special tools which require these following functions. They are NOT to be used
|
|
* for standard animation evaluation UNDER ANY CIRCUMSTANCES!
|
|
*
|
|
* i.e. Pose Library (PoseLib) uses some of these for selectively applying poses, but
|
|
* Particles/Sequencer performing funky time manipulation is not ok.
|
|
*/
|
|
|
|
/* Evaluate Action (F-Curve Bag) */
|
|
void animsys_evaluate_action(struct PointerRNA *ptr, struct bAction *act, struct AnimMapper *remap, float ctime);
|
|
|
|
/* Evaluate Action Group */
|
|
void animsys_evaluate_action_group(struct PointerRNA *ptr, struct bAction *act, struct bActionGroup *agrp, struct AnimMapper *remap, float ctime);
|
|
|
|
/* ************************************* */
|
|
|
|
#endif /* BKE_ANIM_SYS_H*/
|