Alexander Gavrilov
de662e7cd3
NLA strips support using the keyframe values in a variety of ways: adding, subtracting, multiplying, linearly mixing with the result of strips located below in the stack. This is intended for layering tweaks on top of a base animation. However, when inserting keyframes into such strips, it simply inserts the final value of the property, irrespective of these settings. This in fact makes the feature nearly useless. To fix this it is necessary to evaluate the NLA stack below the edited strip and correctly compute the raw key that would produce the intended final value, according to the mode and influence. Differential Revision: https://developer.blender.org/D3927
110 lines
3.7 KiB
C++
110 lines
3.7 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) 2009 Blender Foundation, Joshua Leung
|
|
* All rights reserved.
|
|
*
|
|
* The Original Code is: all of this file.
|
|
*
|
|
* Contributor(s): Joshua Leung (full recode)
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
|
|
/** \file blender/blenkernel/nla_private.h
|
|
* \ingroup bke
|
|
*/
|
|
|
|
|
|
#ifndef __NLA_PRIVATE_H__
|
|
#define __NLA_PRIVATE_H__
|
|
|
|
struct Depsgraph;
|
|
|
|
#include "RNA_types.h"
|
|
|
|
/* --------------- NLA Evaluation DataTypes ----------------------- */
|
|
|
|
/* used for list of strips to accumulate at current time */
|
|
typedef struct NlaEvalStrip {
|
|
struct NlaEvalStrip *next, *prev;
|
|
|
|
NlaTrack *track; /* track that this strip belongs to */
|
|
NlaStrip *strip; /* strip that's being used */
|
|
|
|
short track_index; /* the index of the track within the list */
|
|
short strip_mode; /* which end of the strip are we looking at */
|
|
|
|
float strip_time; /* time at which which strip is being evaluated */
|
|
} NlaEvalStrip;
|
|
|
|
/* NlaEvalStrip->strip_mode */
|
|
enum eNlaEvalStrip_StripMode {
|
|
/* standard evaluation */
|
|
NES_TIME_BEFORE = -1,
|
|
NES_TIME_WITHIN,
|
|
NES_TIME_AFTER,
|
|
|
|
/* transition-strip evaluations */
|
|
NES_TIME_TRANSITION_START,
|
|
NES_TIME_TRANSITION_END,
|
|
};
|
|
|
|
|
|
/* temp channel for accumulating data from NLA (avoids needing to clear all values first) */
|
|
// TODO: maybe this will be used as the 'cache' stuff needed for editable values too?
|
|
typedef struct NlaEvalChannel {
|
|
struct NlaEvalChannel *next, *prev;
|
|
|
|
/* RNA reference to use with pointer and index */
|
|
PathResolvedRNA rna;
|
|
|
|
/* Original parameters used to look up the reference for write_orig_anim_rna */
|
|
const char *rna_path;
|
|
|
|
float value; /* value of this channel */
|
|
} NlaEvalChannel;
|
|
|
|
/* Information about the currently edited strip and ones below it for keyframing. */
|
|
typedef struct NlaKeyframingContext {
|
|
struct NlaKeyframingContext *next, *prev;
|
|
|
|
/* AnimData for which this context was built. */
|
|
struct AnimData *adt;
|
|
|
|
/* Data of the currently edited strip (copy, or fake strip for the main action). */
|
|
NlaStrip strip;
|
|
NlaEvalStrip *eval_strip;
|
|
|
|
/* Evaluated NLA stack below the current strip. */
|
|
ListBase nla_channels;
|
|
} NlaKeyframingContext;
|
|
|
|
/* --------------- NLA Functions (not to be used as a proper API) ----------------------- */
|
|
|
|
/* convert from strip time <-> global time */
|
|
float nlastrip_get_frame(NlaStrip *strip, float cframe, short mode);
|
|
|
|
/* --------------- NLA Evaluation (very-private stuff) ----------------------- */
|
|
/* these functions are only defined here to avoid problems with the order in which they get defined... */
|
|
|
|
NlaEvalStrip *nlastrips_ctime_get_strip(struct Depsgraph *depsgraph, ListBase *list, ListBase *strips, short index, float ctime);
|
|
void nlastrip_evaluate(struct Depsgraph *depsgraph, PointerRNA *ptr, ListBase *channels, ListBase *modifiers, NlaEvalStrip *nes);
|
|
void nladata_flush_channels(struct Depsgraph *depsgraph, PointerRNA *ptr, ListBase *channels);
|
|
|
|
#endif /* __NLA_PRIVATE_H__ */
|