fcurve.c File Reference

#include <float.h>
#include <math.h>
#include <stddef.h>
#include <stdio.h>
#include <string.h>
#include "MEM_guardedalloc.h"
#include "DNA_anim_types.h"
#include "DNA_object_types.h"
#include "DNA_text_types.h"
#include "BLI_blenlib.h"
#include "BLI_easing.h"
#include "BLI_ghash.h"
#include "BLI_math.h"
#include "BLI_sort_utils.h"
#include "BKE_anim_data.h"
#include "BKE_animsys.h"
#include "BKE_context.h"
#include "BKE_curve.h"
#include "BKE_fcurve.h"
#include "BKE_fcurve_driver.h"
#include "BKE_global.h"
#include "BKE_idprop.h"
#include "BKE_lib_query.h"
#include "BKE_nla.h"
#include "BLO_read_write.h"
#include "RNA_access.h"
#include "CLG_log.h"

Go to the source code of this file.

Macros
#define	SMALL   -1.0e-10
#define	SELECT   1

Functions
void	BKE_fcurve_keyframe_move_value_with_handles (struct BezTriple *keyframe, const float new_value)
F-Curve Data Create
FCurve *	BKE_fcurve_create (void)
F-Curve Data Free
void	BKE_fcurve_free (FCurve *fcu)
void	BKE_fcurves_free (ListBase *list)
F-Curve Data Copy
FCurve *	BKE_fcurve_copy (const FCurve *fcu)
void	BKE_fcurves_copy (ListBase *dst, ListBase *src)
void	BKE_fcurve_foreach_id (FCurve *fcu, LibraryForeachIDData *data)
FCurve *	id_data_find_fcurve (ID *id, void *data, StructRNA *type, const char *prop_name, int index, bool *r_driven)
FCurve *	BKE_fcurve_find (ListBase *list, const char rna_path[], const int array_index)
FCurve Iteration
FCurve *	BKE_fcurve_iter_step (FCurve *fcu_iter, const char rna_path[])
int	BKE_fcurves_filter (ListBase *dst, ListBase *src, const char *dataPrefix, const char *dataName)
FCurve *	BKE_fcurve_find_by_rna (PointerRNA *ptr, PropertyRNA *prop, int rnaindex, AnimData **r_adt, bAction **r_action, bool *r_driven, bool *r_special)
FCurve *	BKE_fcurve_find_by_rna_context_ui (bContext *C, PointerRNA *ptr, PropertyRNA *prop, int rnaindex, AnimData **r_animdata, bAction **r_action, bool *r_driven, bool *r_special)
Finding Keyframes/Extents
static int	BKE_fcurve_bezt_binarysearch_index_ex (BezTriple array[], float frame, int arraylen, float threshold, bool *r_replace)
int	BKE_fcurve_bezt_binarysearch_index (BezTriple array[], float frame, int arraylen, bool *r_replace)
static short	get_fcurve_end_keyframes (FCurve *fcu, BezTriple **first, BezTriple **last, const bool do_sel_only)
bool	BKE_fcurve_calc_bounds (FCurve *fcu, float *xmin, float *xmax, float *ymin, float *ymax, const bool do_sel_only, const bool include_handles)
bool	BKE_fcurve_calc_range (FCurve *fcu, float *start, float *end, const bool do_sel_only, const bool do_min_length)
float *	BKE_fcurves_calc_keyed_frames_ex (FCurve **fcurve_array, int fcurve_array_len, const float interval, int *r_frames_len)
float *	BKE_fcurves_calc_keyed_frames (FCurve **fcurve_array, int fcurve_array_len, int *r_frames_len)
Active Keyframe
void	BKE_fcurve_active_keyframe_set (FCurve *fcu, const BezTriple *active_bezt)
int	BKE_fcurve_active_keyframe_index (const FCurve *fcu)
Status Checks
bool	BKE_fcurve_are_keyframes_usable (FCurve *fcu)
bool	BKE_fcurve_is_protected (FCurve *fcu)
bool	BKE_fcurve_is_keyframable (FCurve *fcu)
Keyframe Column Tools
static void UNUSED_FUNCTION()	bezt_add_to_cfra_elem (ListBase *lb, BezTriple *bezt)
Samples Utilities
float	fcurve_samplingcb_evalcurve (FCurve *fcu, void *UNUSED(data), float evaltime)
void	fcurve_store_samples (FCurve *fcu, void *data, int start, int end, FcuSampleFunc sample_cb)
static void	init_unbaked_bezt_data (BezTriple *bezt)
void	fcurve_samples_to_keyframes (FCurve *fcu, const int start, const int end)
eFCU_Cycle_Type	BKE_fcurve_get_cycle_type (FCurve *fcu)
bool	BKE_fcurve_is_cyclic (FCurve *fcu)
static BezTriple *	cycle_offset_triple (bool cycle, BezTriple *out, const BezTriple *in, const BezTriple *from, const BezTriple *to)
void	calchandles_fcurve_ex (FCurve *fcu, eBezTriple_Flag handle_sel_flag)
void	calchandles_fcurve (FCurve *fcu)
void	testhandles_fcurve (FCurve *fcu, eBezTriple_Flag sel_flag, const bool use_handle)
void	sort_time_fcurve (FCurve *fcu)
bool	test_time_fcurve (FCurve *fcu)
F-Curve Calculations
void	BKE_fcurve_correct_bezpart (const float v1[2], float v2[2], float v3[2], const float v4[2])
static int	solve_cubic (double c0, double c1, double c2, double c3, float *o)
static int	findzero (float x, float q0, float q1, float q2, float q3, float *o)
static void	berekeny (float f1, float f2, float f3, float f4, float *o, int b)
bool	BKE_fcurve_bezt_subdivide_handles (struct BezTriple *bezt, struct BezTriple *prev, struct BezTriple *next, float *r_pdelta)
F-Curve Evaluation
static float	fcurve_eval_keyframes_extrapolate (FCurve *fcu, BezTriple *bezts, float evaltime, int endpoint_offset, int direction_to_neighbor)
static float	fcurve_eval_keyframes_interpolate (FCurve *fcu, BezTriple *bezts, float evaltime)
static float	fcurve_eval_keyframes (FCurve *fcu, BezTriple *bezts, float evaltime)
static float	fcurve_eval_samples (FCurve *fcu, FPoint *fpts, float evaltime)
F-Curve - Evaluation
static float	evaluate_fcurve_ex (FCurve *fcu, float evaltime, float cvalue)
float	evaluate_fcurve (FCurve *fcu, float evaltime)
float	evaluate_fcurve_only_curve (FCurve *fcu, float evaltime)
float	evaluate_fcurve_driver (PathResolvedRNA *anim_rna, FCurve *fcu, ChannelDriver *driver_orig, const AnimationEvalContext *anim_eval_context)
bool	BKE_fcurve_is_empty (FCurve *fcu)
float	calculate_fcurve (PathResolvedRNA *anim_rna, FCurve *fcu, const AnimationEvalContext *anim_eval_context)
F-Curve - .blend file API
void	BKE_fmodifiers_blend_write (BlendWriter *writer, ListBase *fmodifiers)
void	BKE_fmodifiers_blend_read_data (BlendDataReader *reader, ListBase *fmodifiers, FCurve *curve)
void	BKE_fmodifiers_blend_read_lib (BlendLibReader *reader, ID *id, ListBase *fmodifiers)
void	BKE_fmodifiers_blend_read_expand (BlendExpander *expander, ListBase *fmodifiers)
void	BKE_fcurve_blend_write (BlendWriter *writer, ListBase *fcurves)
void	BKE_fcurve_blend_read_data (BlendDataReader *reader, ListBase *fcurves)
void	BKE_fcurve_blend_read_lib (BlendLibReader *reader, ID *id, ListBase *fcurves)
void	BKE_fcurve_blend_read_expand (BlendExpander *expander, ListBase *fcurves)

Variables
static CLG_LogRef	LOG = {"bke.fcurve"}

Macro Definition Documentation

SELECT

#define SELECT   1

Definition at line 60 of file fcurve.c.

SMALL

#define SMALL   -1.0e-10

Definition at line 59 of file fcurve.c.

Function Documentation

berekeny()

static void berekeny ( float  f1, float  f2, float  f3, float  f4, float *  o, int  b  )

static

Definition at line 1690 of file fcurve.c.

References Freestyle::a, and t.

Referenced by fcurve_eval_keyframes_interpolate().

bezt_add_to_cfra_elem()

static void UNUSED_FUNCTION() bezt_add_to_cfra_elem ( ListBase *  lb, BezTriple *  bezt  )

static

Definition at line 1054 of file fcurve.c.

References BEZT_BINARYSEARCH_THRESH, BLI_addtail(), BLI_insertlinkbefore(), CfraElem::cfra, IS_EQT, MEM_callocN, CfraElem::next, CfraElem::sel, and SELECT.

BKE_fcurve_active_keyframe_index()

int BKE_fcurve_active_keyframe_index

(

const FCurve *

fcu

)

Get the active keyframe index, with sanity checks for point bounds.

Definition at line 926 of file fcurve.c.

References FCurve::active_keyframe_index, FCurve::bezt, BezTriple::f1, BezTriple::f2, BezTriple::f3, FCURVE_ACTIVE_KEYFRAME_NONE, NULL, SELECT, and FCurve::totvert.

BKE_fcurve_active_keyframe_set()

void BKE_fcurve_active_keyframe_set	(	FCurve *	fcu,
		const BezTriple *	active_bezt
	)

Set the index that stores the FCurve's active keyframe, assuming that active_bezt is already part of fcu->bezt. If NULL, set active keyframe index to "none."

Definition at line 902 of file fcurve.c.

References FCurve::active_keyframe_index, FCurve::bezt, BEZT_ISSEL_ANY, BLI_assert, FCURVE_ACTIVE_KEYFRAME_NONE, NULL, and FCurve::totvert.

BKE_fcurve_are_keyframes_usable()

bool BKE_fcurve_are_keyframes_usable

(

FCurve *

fcu

)

Definition at line 963 of file fcurve.c.

References data, FModifier::data, FCM_GENERATOR_ADDITIVE, ListBase::first, FModifier::flag, FMODIFIER_FLAG_DISABLED, FMODIFIER_FLAG_MUTED, FMODIFIER_TYPE_CYCLES, FMODIFIER_TYPE_FN_GENERATOR, FMODIFIER_TYPE_GENERATOR, FMODIFIER_TYPE_NOISE, FMODIFIER_TYPE_STEPPED, FCurve::fpt, if(), ListBase::last, FCurve::modifiers, NULL, FModifier::prev, and FModifier::type.

Referenced by BKE_fcurve_is_keyframable(), draw_fcurve(), and graphop_visible_keyframes_poll().

BKE_fcurve_bezt_binarysearch_index()

int BKE_fcurve_bezt_binarysearch_index	(	BezTriple	array[],
		float	frame,
		int	arraylen,
		bool *	r_replace
	)

Definition at line 600 of file fcurve.c.

References BEZT_BINARYSEARCH_THRESH, and BKE_fcurve_bezt_binarysearch_index_ex().

Referenced by delete_key_button_exec(), delete_keyframe_fcurve(), fcurve_frame_has_keyframe(), gather_frames_to_render_for_adt(), insert_bezt_fcurve(), pose_propagate_fcurve(), and pyrna_struct_keyframe_delete().

BKE_fcurve_bezt_binarysearch_index_ex()

static int BKE_fcurve_bezt_binarysearch_index_ex ( BezTriple  array[], float  frame, int  arraylen, float  threshold, bool *  r_replace  )

static

Definition at line 513 of file fcurve.c.

References CLOG_ERROR, CLOG_WARN, IS_EQT, LOG, and NULL.

Referenced by BKE_fcurve_bezt_binarysearch_index(), and fcurve_eval_keyframes_interpolate().

BKE_fcurve_bezt_subdivide_handles()

bool BKE_fcurve_bezt_subdivide_handles	(	struct BezTriple *	bezt,
		struct BezTriple *	prev,
		struct BezTriple *	next,
		float *	r_pdelta
	)

Adjust Bezier handles of all three given BezTriples, so that bezt can be inserted between prev and next without changing the resulting curve shape.

Parameters

r_pdelta

return Y difference between bezt and the original curve value at its X position.

Returns

Whether the split was successful.

Definition at line 1714 of file fcurve.c.

References add_v2_v2v2(), BKE_fcurve_correct_bezpart(), copy_v2_v2(), findzero(), interp_v2_v2v2(), next, sub_v2_v2v2(), t, and BezTriple::vec.

Referenced by subdivide_nonauto_handles(), and blender::bke::tests::TEST().

BKE_fcurve_blend_read_data()

void BKE_fcurve_blend_read_data	(	BlendDataReader *	reader,
		ListBase *	fcurves
	)

Definition at line 2436 of file fcurve.c.

References FCurve::bezt, BKE_fmodifiers_blend_read_data(), BLO_read_data_address, BLO_read_list(), FCurve::driver, DRIVER_FLAG_INVALID, DRIVER_TARGETS_LOOPER_BEGIN, DRIVER_TARGETS_LOOPER_END, ChannelDriver::expr_comp, ChannelDriver::expr_simple, FCURVE_DISABLED, ChannelDriver::flag, FCurve::flag, FCurve::fpt, FCurve::grp, LISTBASE_FOREACH, FCurve::modifiers, NULL, FCurve::rna_path, and ChannelDriver::variables.

Referenced by action_blend_read_data(), BKE_animdata_blend_read_data(), and blend_data_read_nla_strips().

BKE_fcurve_blend_read_expand()

void BKE_fcurve_blend_read_expand	(	BlendExpander *	expander,
		ListBase *	fcurves
	)

Definition at line 2521 of file fcurve.c.

References BKE_fmodifiers_blend_read_expand(), BLO_expand, FCurve::driver, DRIVER_TARGETS_LOOPER_BEGIN, DRIVER_TARGETS_LOOPER_END, LISTBASE_FOREACH, FCurve::modifiers, and ChannelDriver::variables.

Referenced by action_blend_read_expand(), BKE_animdata_blend_read_expand(), and blend_read_expand_nla_strips().

BKE_fcurve_blend_read_lib()

void BKE_fcurve_blend_read_lib	(	BlendLibReader *	reader,
		ID *	id,
		ListBase *	fcurves
	)

Definition at line 2491 of file fcurve.c.

References BKE_fmodifiers_blend_read_lib(), BLO_read_id_address, FCurve::driver, DRIVER_TARGETS_LOOPER_BEGIN, DRIVER_TARGETS_LOOPER_END, id, Library::id, ID::lib, LISTBASE_FOREACH, FCurve::modifiers, NULL, and ChannelDriver::variables.

Referenced by action_blend_read_lib(), BKE_animdata_blend_read_lib(), and blend_lib_read_nla_strips().

BKE_fcurve_blend_write()

void BKE_fcurve_blend_write	(	BlendWriter *	writer,
		ListBase *	fcurves
	)

Definition at line 2397 of file fcurve.c.

References FCurve::bezt, BKE_fmodifiers_blend_write(), BLO_write_string(), BLO_write_struct, BLO_write_struct_array, BLO_write_struct_list, FCurve::driver, DRIVER_TARGETS_LOOPER_END, DRIVER_TARGETS_USED_LOOPER_BEGIN, FCurve::fpt, LISTBASE_FOREACH, FCurve::modifiers, FCurve::rna_path, FCurve::totvert, and ChannelDriver::variables.

Referenced by action_blend_write(), BKE_animdata_blend_write(), and blend_write_nla_strips().

BKE_fcurve_calc_bounds()

bool BKE_fcurve_calc_bounds	(	FCurve *	fcu,
		float *	xmin,
		float *	xmax,
		float *	ymin,
		float *	ymax,
		const bool	do_sel_only,
		const bool	include_handles
	)

Definition at line 664 of file fcurve.c.

References FCurve::bezt, BEZT_IPO_BEZ, BEZT_ISSEL_ANY, BLI_assert, FCurve::fpt, G, G_DEBUG, get_fcurve_end_keyframes(), BezTriple::ipo, max_ff(), max_fff(), min_ff(), min_fff(), NULL, FCurve::totvert, FPoint::vec, and BezTriple::vec.

BKE_fcurve_calc_range()

bool BKE_fcurve_calc_range	(	FCurve *	fcu,
		float *	start,
		float *	end,
		const bool	do_sel_only,
		const bool	do_min_length
	)

Definition at line 795 of file fcurve.c.

References FCurve::bezt, BLI_assert, FCurve::fpt, get_fcurve_end_keyframes(), max, max_ff(), min, min_ff(), NULL, FCurve::totvert, FPoint::vec, and BezTriple::vec.

Referenced by calc_action_range(), draw_fcurve_curve(), and get_keyframe_extents().

BKE_fcurve_copy()

FCurve* BKE_fcurve_copy

(

const FCurve *

fcu

)

Definition at line 132 of file fcurve.c.

References FCurve::bezt, copy_fmodifiers(), FCurve::driver, fcurve_copy_driver(), FCurve::fpt, FCurve::grp, MEM_dupallocN, FCurve::modifiers, FCurve::next, NULL, FCurve::prev, and FCurve::rna_path.

Referenced by BKE_fcurves_copy().

BKE_fcurve_correct_bezpart()

void BKE_fcurve_correct_bezpart	(	const float	v1[2],
		float	v2[2],
		float	v3[2],
		const float	v4[2]
	)

The length of each handle is not allowed to be more than the horizontal distance between (v1-v4). This is to prevent curve loops.

This function is very similar to BKE_curve_correct_bezpart(), but allows a steeper tangent for more snappy animations. This is not desired for other areas in which curves are used, though.

Definition at line 1521 of file fcurve.c.

References fabsf, len, v1, and v2.

Referenced by BKE_fcurve_bezt_subdivide_handles(), draw_fcurve_curve_bezts(), fcurve_eval_keyframes_interpolate(), and normalization_factor_get().

BKE_fcurve_create()

FCurve* BKE_fcurve_create

(

void

)

Definition at line 68 of file fcurve.c.

References MEM_callocN.

Referenced by alloc_driver_fcurve(), BKE_nlastrip_validate_fcurves(), ED_action_fcurve_ensure(), icu_to_fcurves(), and blender::bke::tests::TEST().

BKE_fcurve_find()

FCurve* BKE_fcurve_find	(	ListBase *	list,
		const char	rna_path[],
		const int	array_index
	)

Definition at line 274 of file fcurve.c.

References FCurve::array_index, ELEM, ListBase::first, FCurve::next, NULL, FCurve::rna_path, and STREQ.

Referenced by BKE_fcurve_find_by_rna_context_ui(), BKE_nlastrip_validate_fcurves(), delete_key_button_exec(), ED_action_fcurve_ensure(), ED_action_fcurve_find(), followpath_path_animate_exec(), id_data_find_fcurve(), insert_key_button_exec(), make_new_animlistelem(), nla_draw_strip_curves(), pyrna_struct_driver_add(), pyrna_struct_keyframe_delete(), pyrna_struct_keyframe_insert(), seq_convert_transform_animation(), seq_convert_transform_animation_2(), and verify_driver_fcurve().

BKE_fcurve_find_by_rna()

FCurve* BKE_fcurve_find_by_rna	(	PointerRNA *	ptr,
		PropertyRNA *	prop,
		int	rnaindex,
		AnimData **	r_adt,
		bAction **	r_action,
		bool *	r_driven,
		bool *	r_special
	)

Definition at line 378 of file fcurve.c.

References BKE_fcurve_find_by_rna_context_ui(), NULL, and ptr.

Referenced by RNA_property_animated().

BKE_fcurve_find_by_rna_context_ui()

FCurve* BKE_fcurve_find_by_rna_context_ui	(	bContext *	C,
		PointerRNA *	ptr,
		PropertyRNA *	prop,
		int	rnaindex,
		AnimData **	r_animdata,
		bAction **	r_action,
		bool *	r_driven,
		bool *	r_special
	)

Definition at line 390 of file fcurve.c.

References AnimData::action, BKE_animdata_driver_path_hack(), BKE_animdata_from_id(), BKE_fcurve_find(), BKE_nlastrip_has_curves_for_property(), C, bAction::curves, PointerRNA::data, AnimData::drivers, NlaStrip::fcurves, ListBase::first, MEM_freeN, MEM_SAFE_FREE, NULL, PointerRNA::owner_id, ptr, RNA_path_from_ID_to_property(), RNA_property_animateable(), and RNA_property_identifier().

Referenced by add_driver_button_poll(), BKE_fcurve_find_by_rna(), drivers_editor_show_exec(), ED_autokeyframe_property(), graph_panel_drivers_popover(), insert_key_button_exec(), and ui_but_get_fcurve().

BKE_fcurve_foreach_id()

void BKE_fcurve_foreach_id	(	FCurve *	fcu,
		LibraryForeachIDData *	data
	)

Callback used by lib_query to walk over all ID usages (mimics foreach_id callback of IDTypeInfo structure).

Definition at line 188 of file fcurve.c.

References BKE_LIB_FOREACHID_PROCESS, BKE_LIB_FOREACHID_PROCESS_ID, BKE_lib_query_idpropertiesForeachIDLink_callback(), data, FCurve::driver, DRIVER_TARGETS_LOOPER_END, DRIVER_TARGETS_USED_LOOPER_BEGIN, FMODIFIER_TYPE_PYTHON, IDP_foreach_property(), IDP_TYPE_FILTER_ID, IDWALK_CB_NOP, LISTBASE_FOREACH, FCurve::modifiers, NULL, FMod_Python::prop, FMod_Python::script, and ChannelDriver::variables.

Referenced by action_foreach_id(), BKE_animdata_foreach_id(), and BKE_nla_strip_foreach_id().

BKE_fcurve_free()

void BKE_fcurve_free

(

FCurve *

fcu

)

Definition at line 81 of file fcurve.c.

References FCurve::bezt, fcurve_free_driver(), FCurve::fpt, free_fmodifiers(), MEM_freeN, MEM_SAFE_FREE, FCurve::modifiers, NULL, and FCurve::rna_path.

Referenced by ANIM_drivers_copybuf_free(), ANIM_fcurve_delete_from_animdata(), ANIM_remove_driver(), animchannels_delete_exec(), BKE_fcurves_free(), fcurve_path_rename(), fcurve_remove(), fcurves_path_remove_fix(), remove_sequencer_fcurves(), seq_free_animdata(), blender::bke::tests::TEST(), and AnimationImporter::~AnimationImporter().

BKE_fcurve_get_cycle_type()

eFCU_Cycle_Type BKE_fcurve_get_cycle_type

(

FCurve *

fcu

)

Definition at line 1232 of file fcurve.c.

References data, FModifier::data, ELEM, FCM_EXTRAPOLATE_CYCLIC, FCM_EXTRAPOLATE_CYCLIC_OFFSET, FCU_CYCLE_NONE, FCU_CYCLE_OFFSET, FCU_CYCLE_PERFECT, ListBase::first, FModifier::flag, FMODIFIER_FLAG_DISABLED, FMODIFIER_FLAG_MUTED, FMODIFIER_FLAG_RANGERESTRICT, FMODIFIER_FLAG_USEINFLUENCE, FMODIFIER_TYPE_CYCLES, if(), FCurve::modifiers, and FModifier::type.

Referenced by BKE_fcurve_is_cyclic(), insert_bezt_fcurve(), and remap_cyclic_keyframe_location().

BKE_fcurve_is_cyclic()

bool BKE_fcurve_is_cyclic

(

FCurve *

fcu

)

Definition at line 1267 of file fcurve.c.

References BKE_fcurve_get_cycle_type(), and FCU_CYCLE_NONE.

Referenced by ANIM_fmodifiers_paste_from_buf(), calchandles_fcurve_ex(), and fcurve_to_keylist().

BKE_fcurve_is_empty()

bool BKE_fcurve_is_empty

(

FCurve *

fcu

)

Definition at line 2250 of file fcurve.c.

References FCurve::driver, FMI_TYPE_GENERATE_CURVE, list_has_suitable_fmodifier(), FCurve::modifiers, NULL, and FCurve::totvert.

Referenced by animsys_evaluate_action_group(), calculate_fcurve(), clean_fcurve(), delete_action_keys(), delete_graph_keys(), delete_keyframe_fcurve(), draw_seq_fcurve_overlay(), draw_seq_waveform_overlay(), is_fcurve_evaluatable(), seq_convert_transform_animation(), seq_convert_transform_animation_2(), and ui_but_anim_flag().

BKE_fcurve_is_keyframable()

bool BKE_fcurve_is_keyframable

(

FCurve *

fcu

)

Definition at line 1031 of file fcurve.c.

References BKE_fcurve_are_keyframes_usable(), and BKE_fcurve_is_protected().

Referenced by graphkeys_click_insert_exec(), graphop_editable_keyframes_poll(), and insert_keyframe_value().

BKE_fcurve_is_protected()

bool BKE_fcurve_is_protected

(

FCurve *

fcu

)

Definition at line 1023 of file fcurve.c.

References AGRP_PROTECTED, FCURVE_PROTECTED, bActionGroup::flag, FCurve::flag, and FCurve::grp.

Referenced by BKE_fcurve_is_keyframable(), clear_keyframe(), delete_key_button_exec(), delete_key_v3d_exec(), delete_keyframe(), draw_fcurve(), and pyrna_struct_keyframe_delete().

BKE_fcurve_iter_step()

FCurve* BKE_fcurve_iter_step	(	FCurve *	fcu_iter,
		const char	rna_path[]
	)

Definition at line 304 of file fcurve.c.

References ELEM, FCurve::next, NULL, FCurve::rna_path, and STREQ.

Referenced by ANIM_remove_driver().

BKE_fcurve_keyframe_move_value_with_handles()

void BKE_fcurve_keyframe_move_value_with_handles	(	struct BezTriple *	keyframe,
		const float	new_value
	)

Definition at line 947 of file fcurve.c.

References BezTriple::vec.

Referenced by euler_filter_multi_channel(), and blender::bke::tests::TEST().

BKE_fcurves_calc_keyed_frames()

float* BKE_fcurves_calc_keyed_frames	(	FCurve **	fcurve_array,
		int	fcurve_array_len,
		int *	r_frames_len
	)

Definition at line 885 of file fcurve.c.

References BKE_fcurves_calc_keyed_frames_ex().

Referenced by action_flip_pchan().

BKE_fcurves_calc_keyed_frames_ex()

float* BKE_fcurves_calc_keyed_frames_ex	(	FCurve **	fcurve_array,
		int	fcurve_array_len,
		const float	interval,
		int *	r_frames_len
	)

Return an array of keyed frames, rounded to interval.

Parameters

interval

Set to 1.0 to round to whole keyframes, 0.5 for in-between key-frames, etc.

Note

An interval of zero could be supported (this implies no rounding at all), however this risks very small differences in float values being treated as separate keyframes.

Definition at line 850 of file fcurve.c.

References FCurve::bezt, BLI_assert, BLI_gset_add(), BLI_gset_free(), BLI_gset_int_new(), BLI_gset_len(), BLI_gsetIterator_getKey(), BLI_sortutil_cmp_float(), double(), GSET_ITER_INDEX, max_ff(), MEM_mallocN, NULL, POINTER_AS_INT, POINTER_FROM_INT, FCurve::totvert, and BezTriple::vec.

Referenced by BKE_fcurves_calc_keyed_frames().

BKE_fcurves_copy()

void BKE_fcurves_copy	(	ListBase *	dst,
		ListBase *	src
	)

Definition at line 165 of file fcurve.c.

References BKE_fcurve_copy(), BLI_addtail(), BLI_listbase_clear(), ELEM, ListBase::first, FCurve::next, and NULL.

Referenced by BKE_animdata_copy(), BKE_animdata_merge_copy(), BKE_nlastrip_copy(), BKE_object_copy_proxy_drivers(), undocurve_from_editcurve(), and undocurve_to_editcurve().

BKE_fcurves_filter()

int BKE_fcurves_filter	(	ListBase *	dst,
		ListBase *	src,
		const char *	dataPrefix,
		const char *	dataName
	)

Get list of LinkData's containing pointers to the F-Curves which control the types of data indicated.

Lists...

• dst: list of LinkData's matching the criteria returned. List must be freed after use, and is assumed to be empty when passed.
• src: list of F-Curves to search through Filters...
• dataPrefix: i.e. 'pose.bones[' or 'nodes['
• dataName: name of entity within "" immediately following the prefix

Definition at line 336 of file fcurve.c.

References BLI_addtail(), BLI_str_quoted_substrN(), LinkData::data, ELEM, ListBase::first, MEM_callocN, MEM_freeN, FCurve::next, NULL, FCurve::rna_path, and STREQ.

Referenced by updateDuplicateActionConstraintSettings().

BKE_fcurves_free()

void BKE_fcurves_free

(

ListBase *

list

)

Definition at line 103 of file fcurve.c.

References BKE_fcurve_free(), BLI_listbase_clear(), ListBase::first, FCurve::next, and NULL.

Referenced by action_free_data(), BKE_animdata_free(), BKE_nlastrip_free(), BKE_object_copy_proxy_drivers(), cleardrivers_animdata_fn(), do_versions_ipos_to_animato(), graph_free(), graphkeys_clear_ghostcurves_exec(), undocurve_free_data(), and undocurve_to_editcurve().

BKE_fmodifiers_blend_read_data()

void BKE_fmodifiers_blend_read_data	(	BlendDataReader *	reader,
		ListBase *	fmodifiers,
		FCurve *	curve
	)

Definition at line 2336 of file fcurve.c.

References BLO_read_data_address, BLO_read_float_array(), curve, data, FMODIFIER_TYPE_ENVELOPE, FMODIFIER_TYPE_GENERATOR, FMODIFIER_TYPE_PYTHON, IDP_BlendDataRead, and LISTBASE_FOREACH.

Referenced by BKE_fcurve_blend_read_data(), and blend_data_read_nla_strips().

BKE_fmodifiers_blend_read_expand()

void BKE_fmodifiers_blend_read_expand	(	BlendExpander *	expander,
		ListBase *	fmodifiers
	)

Definition at line 2383 of file fcurve.c.

References BLO_expand, data, FMODIFIER_TYPE_PYTHON, and LISTBASE_FOREACH.

Referenced by BKE_fcurve_blend_read_expand(), and blend_read_expand_nla_strips().

BKE_fmodifiers_blend_read_lib()

void BKE_fmodifiers_blend_read_lib	(	BlendLibReader *	reader,
		ID *	id,
		ListBase *	fmodifiers
	)

Definition at line 2369 of file fcurve.c.

References BLO_read_id_address, data, FMODIFIER_TYPE_PYTHON, id, ID::lib, and LISTBASE_FOREACH.

Referenced by BKE_fcurve_blend_read_lib().

BKE_fmodifiers_blend_write()

void BKE_fmodifiers_blend_write	(	BlendWriter *	writer,
		ListBase *	fmodifiers
	)

Definition at line 2286 of file fcurve.c.

References BLO_write_float_array(), BLO_write_struct_array, BLO_write_struct_by_name(), BLO_write_struct_list, data, fmodifier_get_typeinfo(), FMODIFIER_TYPE_ENVELOPE, FMODIFIER_TYPE_GENERATOR, FMODIFIER_TYPE_PYTHON, IDP_BlendWrite(), LISTBASE_FOREACH, and FModifierTypeInfo::structName.

Referenced by BKE_fcurve_blend_write(), and blend_write_nla_strips().

calchandles_fcurve()

void calchandles_fcurve

(

FCurve *

fcu

)

This function recalculates the handles of an F-Curve. Acts based on selection with SELECT flag. To use a different flag, use calchandles_fcurve_ex().

If the BezTriples have been rearranged, sort them first before using this.

Definition at line 1391 of file fcurve.c.

References calchandles_fcurve_ex(), and SELECT.

Referenced by add_fmodifier(), alloc_driver_fcurve(), ANIM_animdata_keyframe_callback(), ANIM_animdata_update(), ANIM_fmodifiers_paste_from_buf(), delete_fcurve_key(), fcurve_samples_to_keyframes(), gpencil_stroke_path_animation(), graphedit_activekey_update_cb(), insert_vert_fcurve(), mirror_action_keys(), mirror_graph_keys(), nlaedit_apply_scale_exec(), paste_animedit_keys_fcurve(), remove_fmodifier(), sample_fcurve(), seteasing_graph_keys(), sethandles_action_keys(), sethandles_graph_keys(), setipo_graph_keys(), smooth_fcurve(), snap_action_keys(), and snap_graph_keys().

calchandles_fcurve_ex()

void calchandles_fcurve_ex	(	FCurve *	fcu,
		eBezTriple_Flag	handle_sel_flag
	)

Variant of calchandles_fcurve() that allows calculating based on a different select flag.

Parameters

handle_sel_flag

The flag (bezt.f1/2/3) value to use to determine selection. Usually SELECT, but may want to use a different one at times (if caller does not operate on selection).

Definition at line 1302 of file fcurve.c.

References Freestyle::a, BezTriple::auto_handle_type, FCurve::auto_smoothing, FCurve::bezt, BEZT_IS_AUTOH, BKE_fcurve_is_cyclic(), BKE_nurb_handle_calc_ex(), BKE_nurb_handle_smooth_fcurve(), cycle_offset_triple(), ELEM, FCurve::extend, FCURVE_EXTRAPOLATE_CONSTANT, FCURVE_SMOOTH_NONE, HD_AUTOTYPE_LOCKED_FINAL, HD_AUTOTYPE_NORMAL, next, NULL, FCurve::totvert, and BezTriple::vec.

Referenced by action_flip_pchan(), calchandles_fcurve(), and testhandles_fcurve().

calculate_fcurve()

float calculate_fcurve	(	PathResolvedRNA *	anim_rna,
		FCurve *	fcu,
		const AnimationEvalContext *	anim_eval_context
	)

Definition at line 2257 of file fcurve.c.

References BKE_fcurve_is_empty(), FCurve::curval, FCurve::driver, AnimationEvalContext::eval_time, evaluate_fcurve(), and evaluate_fcurve_driver().

cycle_offset_triple()

static BezTriple* cycle_offset_triple ( bool  cycle, BezTriple *  out, const BezTriple *  in, const BezTriple *  from, const BezTriple *  to  )

static

Definition at line 1276 of file fcurve.c.

References add_v3_v3(), from, NULL, sub_v3_v3v3(), and BezTriple::vec.

Referenced by calchandles_fcurve_ex().

evaluate_fcurve()

float evaluate_fcurve	(	FCurve *	fcu,
		float	evaltime
	)

Definition at line 2186 of file fcurve.c.

References BLI_assert, FCurve::driver, evaltime, evaluate_fcurve_ex(), and NULL.

Referenced by BCAnimationCurve::adjust_range(), BKE_tracking_track_get_weight_for_marker(), calculate_fcurve(), draw_fcurve_curve(), draw_seq_fcurve_overlay(), draw_seq_waveform_overlay(), AnimationImporter::evaluate_animation(), fcurve_samplingcb_evalcurve(), fetch_from_fcurve(), get_animated_weight(), BCAnimationCurve::get_value(), insert_action_keys(), libmv_tracks_new(), new_key_needed(), nla_draw_strip_curves(), nlasnapshot_from_action(), pose_slide_apply_quat(), pose_slide_apply_val(), sample_fcurve(), seq_effect_speed_rebuild_map(), seq_render_effect_strip_impl(), and blender::bke::tests::TEST().

evaluate_fcurve_driver()

float evaluate_fcurve_driver	(	PathResolvedRNA *	anim_rna,
		FCurve *	fcu,
		ChannelDriver *	driver_orig,
		const AnimationEvalContext *	anim_eval_context
	)

Definition at line 2201 of file fcurve.c.

References BLI_assert, FCurve::driver, FModifier::efra, AnimationEvalContext::eval_time, evaltime, evaluate_driver(), evaluate_fcurve_ex(), ListBase::first, FModifier::flag, FMODIFIER_FLAG_RANGERESTRICT, FCurve::modifiers, FModifier::next, NULL, FModifier::sfra, and FCurve::totvert.

Referenced by calculate_fcurve().

evaluate_fcurve_ex()

static float evaluate_fcurve_ex ( FCurve *  fcu, float  evaltime, float  cvalue  )

static

Definition at line 2150 of file fcurve.c.

References FCurve::bezt, BLI_listbase_count(), FModifiersStackStorage::buffer, evaltime, evaluate_fmodifiers_storage_size_per_modifier(), evaluate_time_fmodifiers(), evaluate_value_fmodifiers(), fcurve_eval_keyframes(), fcurve_eval_samples(), FCURVE_INT_VALUES, FCurve::flag, floorf, FCurve::fpt, FModifiersStackStorage::modifier_count, FCurve::modifiers, and FModifiersStackStorage::size_per_modifier.

Referenced by evaluate_fcurve(), evaluate_fcurve_driver(), and evaluate_fcurve_only_curve().

evaluate_fcurve_only_curve()

float evaluate_fcurve_only_curve	(	FCurve *	fcu,
		float	evaltime
	)

Definition at line 2193 of file fcurve.c.

References evaltime, and evaluate_fcurve_ex().

Referenced by action_flip_pchan_cache_init(), insert_graph_keys(), and normalization_factor_get().

fcurve_eval_keyframes()

static float fcurve_eval_keyframes ( FCurve *  fcu, BezTriple *  bezts, float  evaltime  )

static

Definition at line 2090 of file fcurve.c.

References evaltime, fcurve_eval_keyframes_extrapolate(), fcurve_eval_keyframes_interpolate(), FCurve::totvert, and BezTriple::vec.

Referenced by evaluate_fcurve_ex().

fcurve_eval_keyframes_extrapolate()

static float fcurve_eval_keyframes_extrapolate ( FCurve *  fcu, BezTriple *  bezts, float  evaltime, int  endpoint_offset, int  direction_to_neighbor  )

static

Definition at line 1781 of file fcurve.c.

References BEZT_IPO_CONST, BEZT_IPO_LIN, evaltime, FCurve::extend, FCURVE_DISCRETE_VALUES, FCURVE_EXTRAPOLATE_CONSTANT, FCurve::flag, BezTriple::ipo, FCurve::totvert, and BezTriple::vec.

Referenced by fcurve_eval_keyframes().

fcurve_eval_keyframes_interpolate()

static float fcurve_eval_keyframes_interpolate ( FCurve *  fcu, BezTriple *  bezts, float  evaltime  )

static

Definition at line 1828 of file fcurve.c.

References Freestyle::a, BezTriple::amplitude, BezTriple::back, berekeny(), BEZT_IPO_BACK, BEZT_IPO_BEZ, BEZT_IPO_BOUNCE, BEZT_IPO_CIRC, BEZT_IPO_CONST, BEZT_IPO_CUBIC, BEZT_IPO_EASE_IN, BEZT_IPO_EASE_IN_OUT, BEZT_IPO_EASE_OUT, BEZT_IPO_ELASTIC, BEZT_IPO_EXPO, BEZT_IPO_LIN, BEZT_IPO_QUAD, BEZT_IPO_QUART, BEZT_IPO_QUINT, BEZT_IPO_SINE, BKE_fcurve_bezt_binarysearch_index_ex(), BKE_fcurve_correct_bezpart(), BLI_easing_back_ease_in(), BLI_easing_back_ease_in_out(), BLI_easing_back_ease_out(), BLI_easing_bounce_ease_in(), BLI_easing_bounce_ease_in_out(), BLI_easing_bounce_ease_out(), BLI_easing_circ_ease_in(), BLI_easing_circ_ease_in_out(), BLI_easing_circ_ease_out(), BLI_easing_cubic_ease_in(), BLI_easing_cubic_ease_in_out(), BLI_easing_cubic_ease_out(), BLI_easing_elastic_ease_in(), BLI_easing_elastic_ease_in_out(), BLI_easing_elastic_ease_out(), BLI_easing_expo_ease_in(), BLI_easing_expo_ease_in_out(), BLI_easing_expo_ease_out(), BLI_easing_linear_ease(), BLI_easing_quad_ease_in(), BLI_easing_quad_ease_in_out(), BLI_easing_quad_ease_out(), BLI_easing_quart_ease_in(), BLI_easing_quart_ease_in_out(), BLI_easing_quart_ease_out(), BLI_easing_quint_ease_in(), BLI_easing_quint_ease_in_out(), BLI_easing_quint_ease_out(), BLI_easing_sine_ease_in(), BLI_easing_sine_ease_in_out(), BLI_easing_sine_ease_out(), BezTriple::easing, eps, evaltime, fabsf, FCURVE_DISCRETE_VALUES, findzero(), FCurve::flag, G, G_DEBUG, BezTriple::ipo, BezTriple::period, time, FCurve::totvert, v1, v2, and BezTriple::vec.

Referenced by fcurve_eval_keyframes().

fcurve_eval_samples()

static float fcurve_eval_samples ( FCurve *  fcu, FPoint *  fpts, float  evaltime  )

static

Definition at line 2105 of file fcurve.c.

References evaltime, fabsf, floorf, interpf(), t, FCurve::totvert, and FPoint::vec.

Referenced by evaluate_fcurve_ex().

fcurve_samples_to_keyframes()

void fcurve_samples_to_keyframes	(	FCurve *	fcu,
		const int	start,
		const int	end
	)

Definition at line 1156 of file fcurve.c.

References FCurve::bezt, calchandles_fcurve(), CLOG_ERROR, copy_v2_v2(), float(), FCurve::fpt, init_unbaked_bezt_data(), LOG, MEM_callocN, MEM_freeN, MEM_SAFE_FREE, NULL, FCurve::totvert, FPoint::vec, and BezTriple::vec.

Referenced by unbake_graph_curves().

fcurve_samplingcb_evalcurve()

float fcurve_samplingcb_evalcurve	(	FCurve *	fcu,
		void *	UNUSEDdata,
		float	evaltime
	)

Definition at line 1099 of file fcurve.c.

References evaltime, and evaluate_fcurve().

fcurve_store_samples()

void fcurve_store_samples	(	FCurve *	fcu,
		void *	data,
		int	start,
		int	end,
		FcuSampleFunc	sample_cb
	)

Definition at line 1108 of file fcurve.c.

References FCurve::bezt, CLOG_ERROR, data, ELEM, float(), FCurve::fpt, LOG, MEM_callocN, MEM_freeN, NULL, FCurve::totvert, and FPoint::vec.

Referenced by bake_graph_curves(), and fcurve_bake_modifiers().

findzero()

static int findzero ( float  x, float  q0, float  q1, float  q2, float  q3, float *  o  )

static

Definition at line 1680 of file fcurve.c.

References q1, solve_cubic(), and x.

Referenced by BKE_fcurve_bezt_subdivide_handles(), and fcurve_eval_keyframes_interpolate().

get_fcurve_end_keyframes()

static short get_fcurve_end_keyframes ( FCurve *  fcu, BezTriple **  first, BezTriple **  last, const bool  do_sel_only  )

static

Definition at line 613 of file fcurve.c.

References ARRAY_LAST_ITEM, FCurve::bezt, BEZT_ISSEL_ANY, NULL, and FCurve::totvert.

Referenced by BKE_fcurve_calc_bounds(), and BKE_fcurve_calc_range().

id_data_find_fcurve()

FCurve* id_data_find_fcurve	(	ID *	id,
		void *	data,
		StructRNA *	type,
		const char *	prop_name,
		int	index,
		bool *	r_driven
	)

Definition at line 221 of file fcurve.c.

References AnimData::action, BKE_animdata_from_id(), BKE_fcurve_find(), bAction::curves, data, AnimData::drivers, ELEM, ListBase::first, MEM_freeN, NULL, ptr, RNA_path_from_ID_to_property(), RNA_pointer_create(), RNA_struct_find_property(), and type.

Referenced by BKE_tracking_track_get_weight_for_marker(), draw_seq_fcurve_overlay(), draw_seq_waveform_overlay(), libmv_tracks_new(), retrieve_stab_animation(), retrieve_track_weight_animation(), seq_effect_speed_rebuild_map(), seq_render_effect_strip_impl(), sound_update_animation_flags(), and sound_update_animation_flags_fn().

init_unbaked_bezt_data()

static void init_unbaked_bezt_data ( BezTriple *  bezt )

static

Definition at line 1147 of file fcurve.c.

References BEZT_IPO_LIN, BezTriple::f1, BezTriple::f2, BezTriple::f3, BezTriple::h1, BezTriple::h2, HD_AUTO_ANIM, BezTriple::ipo, and SELECT.

Referenced by fcurve_samples_to_keyframes().

solve_cubic()

static int solve_cubic ( double  c0, double  c1, double  c2, double  c3, float *  o  )

static

Find roots of cubic equation (c0 x³ + c1 x² + c2 x + c3)

Returns

number of roots in o.

Note

it is up to the caller to allocate enough memory for o.

Definition at line 1568 of file fcurve.c.

References Freestyle::a, KDL::acos(), Freestyle::c, KDL::cos(), float(), SMALL, sqrt(), sqrt3d(), and t.

Referenced by findzero().

sort_time_fcurve()

void sort_time_fcurve

(

FCurve *

fcu

)

Definition at line 1429 of file fcurve.c.

References Freestyle::a, FCurve::bezt, CLAMP_MAX, CLAMP_MIN, NULL, SWAP, swap_v2_v2(), FCurve::totvert, and BezTriple::vec.

Referenced by ANIM_animdata_update(), graphedit_activekey_update_cb(), and remake_graph_transdata().

test_time_fcurve()

bool test_time_fcurve

(

FCurve *

fcu

)

Definition at line 1472 of file fcurve.c.

References Freestyle::a, FCurve::bezt, FCurve::fpt, NULL, FCurve::totvert, FPoint::vec, and BezTriple::vec.

testhandles_fcurve()

void testhandles_fcurve	(	FCurve *	fcu,
		eBezTriple_Flag	sel_flag,
		const bool	use_handle
	)

Update handles, making sure the handle-types are valid (e.g. correctly deduced from an "Auto" type), and recalculating their position vectors. Use when something has changed handle positions.

Parameters

sel_flag	The flag (bezt.f1/2/3) value to use to determine selection. Usually SELECT, but may want to use a different one at times (if caller does not operate on selection).
use_handle	Check selection state of individual handles, otherwise always update both handles if the key is selected.

Definition at line 1407 of file fcurve.c.

References Freestyle::a, FCurve::bezt, BKE_nurb_bezt_handle_test(), calchandles_fcurve_ex(), ELEM, and NULL.

Referenced by posttrans_fcurve_clean(), and remake_graph_transdata().

Variable Documentation

LOG

CLG_LogRef LOG = {"bke.fcurve"}

static

Definition at line 62 of file fcurve.c.

Referenced by BKE_fcurve_bezt_binarysearch_index_ex(), fcurve_samples_to_keyframes(), and fcurve_store_samples().