1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
/*
* 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) 2009 Blender Foundation, Joshua Leung
* All rights reserved.
*/
#pragma once
/** \file
* \ingroup bke
*/
#include "BLI_sys_types.h" /* for bool */
#ifdef __cplusplus
extern "C" {
#endif
struct AnimData;
struct BlendDataReader;
struct BlendExpander;
struct BlendLibReader;
struct BlendWriter;
struct ID;
struct LibraryForeachIDData;
struct Main;
struct ReportList;
struct bAction;
/* ************************************* */
/* AnimData API */
/**
* Check if the given ID-block can have AnimData.
*/
bool id_type_can_have_animdata(short id_type);
bool id_can_have_animdata(const struct ID *id);
/**
* Get #AnimData from the given ID-block.
*/
struct AnimData *BKE_animdata_from_id(struct ID *id);
/**
* Ensure #AnimData exists in the given ID-block (when supported).
*/
struct AnimData *BKE_animdata_ensure_id(struct ID *id);
/**
* Set active action used by AnimData from the given ID-block.
*
* Called when user tries to change the active action of an #AnimData block
* (via RNA, Outliner, etc.)
*
* \param reports: Can be NULL.
* \param id: The owner of the animation data
* \param act: The Action to set, or NULL to clear.
*
* \return true when the action was successfully updated, false otherwise.
*/
bool BKE_animdata_set_action(struct ReportList *reports, struct ID *id, struct bAction *act);
bool BKE_animdata_action_editable(const struct AnimData *adt);
/**
* Ensure that the action's idroot is set correctly given the ID type of the owner.
* Return true if it is, false if it was already set to an incompatible type.
*/
bool BKE_animdata_action_ensure_idroot(const struct ID *owner, struct bAction *action);
/**
* Free AnimData used by the nominated ID-block, and clear ID-block's AnimData pointer.
*/
void BKE_animdata_free(struct ID *id, bool do_id_user);
/**
* Return true if the ID-block has non-empty AnimData.
*/
bool BKE_animdata_id_is_animated(const struct ID *id);
/**
* Callback used by lib_query to walk over all ID usages
* (mimics `foreach_id` callback of #IDTypeInfo structure).
*/
void BKE_animdata_foreach_id(struct AnimData *adt, struct LibraryForeachIDData *data);
/**
* Make a copy of the given AnimData - to be used when copying data-blocks.
* \param flag: Control ID pointers management,
* see LIB_ID_CREATE_.../LIB_ID_COPY_... flags in BKE_lib_id.h
* \return The copied animdata.
*/
struct AnimData *BKE_animdata_copy(struct Main *bmain, struct AnimData *adt, int flag);
/**
* \param flag: Control ID pointers management,
* see LIB_ID_CREATE_.../LIB_ID_COPY_... flags in BKE_lib_id.h
* \return true is successfully copied.
*/
bool BKE_animdata_copy_id(struct Main *bmain, struct ID *id_to, struct ID *id_from, int flag);
/**
* Copy AnimData Actions.
*/
void BKE_animdata_copy_id_action(struct Main *bmain, struct ID *id);
void BKE_animdata_duplicate_id_action(struct Main *bmain, struct ID *id, uint duplicate_flags);
/* Merge copies of data from source AnimData block */
typedef enum eAnimData_MergeCopy_Modes {
/* Keep destination action */
ADT_MERGECOPY_KEEP_DST = 0,
/* Use src action (make a new copy) */
ADT_MERGECOPY_SRC_COPY = 1,
/* Use src action (but just reference the existing version) */
ADT_MERGECOPY_SRC_REF = 2,
} eAnimData_MergeCopy_Modes;
/**
* Merge copies of the data from the src AnimData into the destination AnimData.
*/
void BKE_animdata_merge_copy(struct Main *bmain,
struct ID *dst_id,
struct ID *src_id,
eAnimData_MergeCopy_Modes action_mode,
bool fix_drivers);
void BKE_animdata_blend_write(struct BlendWriter *writer, struct AnimData *adt);
void BKE_animdata_blend_read_data(struct BlendDataReader *reader, struct AnimData *adt);
void BKE_animdata_blend_read_lib(struct BlendLibReader *reader,
struct ID *id,
struct AnimData *adt);
void BKE_animdata_blend_read_expand(struct BlendExpander *expander, struct AnimData *adt);
#ifdef __cplusplus
}
#endif
|
