Blender V5.3
nla_private.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2009 Blender Authors, Joshua Leung. All rights reserved.
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#pragma once
10
11#include "BLI_bitmap.hh"
12#include "BLI_ghash.hh"
13
14#include "DNA_anim_types.h"
15#include "DNA_listBase.h"
16
17#include "RNA_types.hh"
18
19namespace blender {
20
22
23/* --------------- NLA Evaluation DataTypes ----------------------- */
24
42
45 /* standard evaluation */
49
50 /* transition-strip evaluations */
53};
54
55struct NlaEvalChannel;
56struct NlaEvalData;
57
62
63 friend bool operator==(const NlaEvalChannelKey &a, const NlaEvalChannelKey &b)
64 {
65 return a.ptr.data == b.ptr.data && a.prop == b.prop;
66 }
67
68 uint64_t hash() const
69 {
70 return get_default_hash(this->ptr.data, this->prop);
71 }
72};
73
79
83
86
92
93 int length; /* Number of values in the property. */
94 bool is_base; /* Base snapshot of the channel. */
95
96 float values[]; /* Item values. */
97 /* Memory over-allocated to provide space for values. */
98};
99
107
115
116 /* Original RNA path string and property key. */
117 const char *rna_path;
119
120 int index;
123
124 /* Associated with the RNA property's value(s), marks which elements are affected by NLA. */
126
127 /* Base set of values. */
129 /* Memory over-allocated to provide space for base_snapshot.values. */
130};
131
134 /* Snapshot this one defaults to. */
136
137 int size;
139};
140
143 ListBaseT<NlaEvalChannel> channels;
144
145 /* Mapping of paths and NlaEvalChannelKeys to channels. */
148
149 /* Base snapshot. */
152
153 /* Evaluation result snapshot. */
155};
156
160
161 /* AnimData for which this context was built. */
162 struct AnimData *adt;
163
164 /* Data of the currently edited strip (copy, or fake strip for the main action). */
167 /* Storage for the action track as a strip. */
169
170 /* Strips above tweaked strip. */
171 ListBaseT<NlaEvalStrip> upper_estrips;
172 /* Evaluated NLA stack below the tweak strip. */
174};
175
176/* --------------- NLA Functions (not to be used as a proper API) ----------------------- */
177
185float nlastrip_get_frame(NlaStrip *strip, float cframe, short mode);
186
187/* --------------- NLA Evaluation (very-private stuff) ----------------------- */
188/* these functions are only defined here to avoid problems with the order
189 * in which they get defined. */
190
195 ListBaseT<NlaStrip> *strips,
196 short index,
197 const struct AnimationEvalContext *anim_eval_context,
198 bool flush_to_original);
202
216
217void nlastrip_evaluate(const int evaluation_mode,
218 PointerRNA *ptr,
219 NlaEvalData *channels,
220 ListBaseT<FModifier> *modifiers,
221 NlaEvalStrip *nes,
222 NlaEvalSnapshot *snapshot,
223 const struct AnimationEvalContext *anim_eval_context,
224 bool flush_to_original);
229 NlaEvalData *channels,
230 NlaEvalSnapshot *snapshot,
231 bool flush_to_original);
232
234
236
245void nlasnapshot_blend(NlaEvalData *eval_data,
246 NlaEvalSnapshot *lower_snapshot,
247 NlaEvalSnapshot *upper_snapshot,
248 short upper_blendmode,
249 float upper_influence,
250 NlaEvalSnapshot *r_blended_snapshot);
251
261 NlaEvalSnapshot *lower_snapshot,
262 NlaEvalSnapshot *blended_snapshot,
263 short upper_blendmode,
264 float upper_influence,
265 NlaEvalSnapshot *r_upper_snapshot);
266
279 NlaEvalSnapshot *blended_snapshot,
280 NlaEvalSnapshot *upper_snapshot,
281 const short upper_blendmode,
282 const float upper_influence,
283 NlaEvalSnapshot *r_lower_snapshot);
284
286 NlaEvalData *channels,
287 ListBaseT<FModifier> *modifiers,
288 NlaEvalStrip *nes,
289 NlaEvalSnapshot *snapshot,
290 const struct AnimationEvalContext *anim_eval_context,
291 const bool flush_to_original);
292
294 PointerRNA *ptr,
295 NlaEvalData *channels,
296 ListBaseT<FModifier> *modifiers,
297 NlaEvalStrip *nes,
298 NlaEvalSnapshot *snapshot,
299 const struct AnimationEvalContext *anim_eval_context);
300
302 NlaEvalData *channels,
303 ListBaseT<FModifier> *modifiers,
304 NlaEvalStrip *nes,
305 NlaEvalSnapshot *snapshot,
306 const struct AnimationEvalContext *anim_eval_context);
307
308} // namespace blender
These structs are the foundation for all linked lists in the library system.
BMesh Iterators.
float nlastrip_get_frame(NlaStrip *strip, float cframe, short mode)
unsigned __int64 uint64_t
Definition BKE_text.h:91
eNlaEvalChannel_MixMode
@ NEC_MIX_MULTIPLY
@ NEC_MIX_AXIS_ANGLE
@ NEC_MIX_QUATERNION
void nladata_flush_channels(PointerRNA *ptr, NlaEvalData *channels, NlaEvalSnapshot *snapshot, const bool flush_to_original)
Definition anim_sys.cc:2854
void nlasnapshot_blend(NlaEvalData *eval_data, NlaEvalSnapshot *lower_snapshot, NlaEvalSnapshot *upper_snapshot, const short upper_blendmode, const float upper_influence, NlaEvalSnapshot *r_blended_snapshot)
Definition anim_sys.cc:3395
void nlasnapshot_blend_strip(PointerRNA *ptr, NlaEvalData *channels, ListBaseT< FModifier > *modifiers, NlaEvalStrip *nes, NlaEvalSnapshot *snapshot, const AnimationEvalContext *anim_eval_context, const bool flush_to_original)
Definition anim_sys.cc:2807
void nlasnapshot_blend_get_inverted_upper_snapshot(NlaEvalData *eval_data, NlaEvalSnapshot *lower_snapshot, NlaEvalSnapshot *blended_snapshot, const short upper_blendmode, const float upper_influence, NlaEvalSnapshot *r_upper_snapshot)
Definition anim_sys.cc:3423
void nlastrip_evaluate(const int evaluation_mode, PointerRNA *ptr, NlaEvalData *channels, ListBaseT< FModifier > *modifiers, NlaEvalStrip *nes, NlaEvalSnapshot *snapshot, const AnimationEvalContext *anim_eval_context, const bool flush_to_original)
Definition anim_sys.cc:2750
void nlasnapshot_blend_strip_get_inverted_lower_snapshot(PointerRNA *ptr, NlaEvalData *channels, ListBaseT< FModifier > *modifiers, NlaEvalStrip *nes, NlaEvalSnapshot *snapshot, const AnimationEvalContext *anim_eval_context)
Definition anim_sys.cc:2825
void nlasnapshot_blend_get_inverted_lower_snapshot(NlaEvalData *eval_data, NlaEvalSnapshot *blended_snapshot, NlaEvalSnapshot *upper_snapshot, const short upper_blendmode, const float upper_influence, NlaEvalSnapshot *r_lower_snapshot)
Definition anim_sys.cc:3451
void nlasnapshot_ensure_channels(NlaEvalData *eval_data, NlaEvalSnapshot *snapshot)
Definition anim_sys.cc:3388
void nlasnapshot_enable_all_blend_domain(NlaEvalSnapshot *snapshot)
Definition anim_sys.cc:3376
eNlaEvalStrip_StripMode
Definition nla_private.h:44
@ NES_TIME_TRANSITION_START
Definition nla_private.h:51
@ NES_TIME_WITHIN
Definition nla_private.h:47
@ NES_TIME_AFTER
Definition nla_private.h:48
@ NES_TIME_TRANSITION_END
Definition nla_private.h:52
@ NES_TIME_BEFORE
Definition nla_private.h:46
unsigned int BLI_bitmap
Definition BLI_bitmap.hh:15
NlaEvalStrip * nlastrips_ctime_get_strip(ListBaseT< NlaEvalStrip > *list, ListBaseT< NlaStrip > *strips, short index, const AnimationEvalContext *anim_eval_context, const bool flush_to_original)
Definition anim_sys.cc:777
eNlaStripEvaluate_Mode
@ STRIP_EVAL_BLEND_GET_INVERTED_LOWER_SNAPSHOT
@ STRIP_EVAL_BLEND
@ STRIP_EVAL_NOBLEND
void nlasnapshot_blend_strip_no_blend(PointerRNA *ptr, NlaEvalData *channels, ListBaseT< FModifier > *modifiers, NlaEvalStrip *nes, NlaEvalSnapshot *snapshot, const AnimationEvalContext *anim_eval_context)
Definition anim_sys.cc:2843
constexpr uint64_t get_default_hash(const T &v, const Args &...args)
Definition BLI_hash.hh:252
friend bool operator==(const NlaEvalChannelKey &a, const NlaEvalChannelKey &b)
Definition nla_private.h:63
struct PropertyRNA * prop
Definition nla_private.h:61
uint64_t hash() const
Definition nla_private.h:68
struct PointerRNA ptr
Definition nla_private.h:60
struct NlaEvalChannel * channel
Definition nla_private.h:82
struct NlaEvalChannel * prev
NlaEvalChannelKey key
NlaEvalChannelSnapshot base_snapshot
struct NlaEvalData * owner
struct NlaEvalChannel * next
NlaEvalSnapshot base_snapshot
Map< NlaEvalChannelKey, NlaEvalChannel * > * key_hash
NlaEvalSnapshot eval_snapshot
ListBaseT< NlaEvalChannel > channels
struct NlaEvalSnapshot * base
NlaEvalChannelSnapshot ** channels
struct NlaEvalStrip * prev
Definition nla_private.h:27
struct NlaEvalStrip * next
Definition nla_private.h:27
struct NlaKeyframingContext * prev
ListBaseT< NlaEvalStrip > upper_estrips
struct NlaKeyframingContext * next
BLI_bitmap buffer[sizeof(uint64_t)/sizeof(BLI_bitmap)]
Definition nla_private.h:77