#include <cstring>
#include "DNA_anim_types.h"
#include "DNA_scene_types.h"
#include "DNA_space_types.h"
#include "MEM_guardedalloc.h"
#include "BLT_translation.hh"
#include "BLI_blenlib.h"
#include "BLI_utildefines.h"
#include "BKE_context.hh"
#include "BKE_fcurve.hh"
#include "BKE_screen.hh"
#include "WM_api.hh"
#include "WM_types.hh"
#include "RNA_access.hh"
#include "RNA_prototypes.hh"
#include "UI_interface.hh"
#include "UI_resources.hh"
#include "ED_anim_api.hh"
#include "ED_undo.hh"
#include "DEG_depsgraph.hh"

Classes
struct	FModifierDeleteContext

Typedefs
using	PanelDrawFn = void ()(const bContext , Panel *)

Functions
Panel Registering and Panel Callbacks
static ListBase *	fmodifier_list_space_specific (const bContext *C)

static PointerRNA *	fmodifier_get_pointers (const bContext C, const Panel panel, ID **r_owner_id)

static void	fmodifier_reorder (bContext C, Panel panel, int new_index)

static short	get_fmodifier_expand_flag (const bContext , Panel panel)

static void	set_fmodifier_expand_flag (const bContext , Panel panel, short expand_flag)

static PanelType *	fmodifier_panel_register (ARegionType region_type, eFModifier_Types type, PanelDrawFn draw, PanelTypePollFn poll, const char id_prefix)

static PanelType *	fmodifier_subpanel_register (ARegionType region_type, const char name, const char label, PanelDrawFn draw_header, PanelDrawFn draw, PanelTypePollFn poll, PanelType parent)

Generator Modifier
static void	generator_panel_draw (const bContext C, Panel panel)

static void	panel_register_generator (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Function Generator Modifier
static void	fn_generator_panel_draw (const bContext C, Panel panel)

static void	panel_register_fn_generator (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Cycles Modifier
static void	cycles_panel_draw (const bContext C, Panel panel)

static void	panel_register_cycles (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Noise Modifier
static void	noise_panel_draw (const bContext C, Panel panel)

static void	panel_register_noise (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Envelope Modifier
static void	fmod_envelope_addpoint_cb (bContext C, void fcm_dv, void *)

static void	fmod_envelope_deletepoint_cb (bContext , void fcm_dv, void *ind_v)

static void	envelope_panel_draw (const bContext C, Panel panel)

static void	panel_register_envelope (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Limits Modifier
static void	limits_panel_draw (const bContext C, Panel panel)

static void	panel_register_limits (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Stepped Interpolation Modifier
static void	stepped_panel_draw (const bContext C, Panel panel)

static void	panel_register_stepped (ARegionType region_type, const char id_prefix, PanelTypePollFn poll_fn)

Panel Creation
void	ANIM_fmodifier_panels (const bContext C, ID owner_id, ListBase *fmodifiers, uiListPanelIDFromDataFunc panel_id_fn)

void	ANIM_modifier_panels_register_graph_and_NLA (ARegionType region_type, const char modifier_panel_prefix, PanelTypePollFn poll_function)

void	ANIM_modifier_panels_register_graph_only (ARegionType region_type, const char modifier_panel_prefix, PanelTypePollFn poll_function)

General UI Callbacks and Drawing
#define	B_REDR 1

#define	B_FMODIFIER_REDRAW 20

static void	fmodifier_panel_header (const bContext C, Panel panel)

static void	delete_fmodifier_cb (bContext C, void ctx_v, void *fcm_v)

static void	fmodifier_influence_draw (uiLayout layout, PointerRNA ptr)

static void	fmodifier_frame_range_header_draw (const bContext C, Panel panel)

static void	fmodifier_frame_range_draw (const bContext C, Panel panel)

Copy / Paste Buffer Code
For now, this is also defined in this file so that it can be shared between the graph editor and the NLA editor.
static ListBase	fmodifier_copypaste_buf = {nullptr, nullptr}

void	ANIM_fmodifiers_copybuf_free ()

bool	ANIM_fmodifiers_copy_to_buf (ListBase *modifiers, bool active)

bool	ANIM_fmodifiers_paste_from_buf (ListBase modifiers, bool replace, FCurve curve)

Macro Definition Documentation

◆ B_FMODIFIER_REDRAW

#define B_FMODIFIER_REDRAW 20

Definition at line 228 of file fmodifier_ui.cc.

Referenced by envelope_panel_draw().

◆ B_REDR

#define B_REDR 1

Definition at line 227 of file fmodifier_ui.cc.

Referenced by fmodifier_panel_header().

Typedef Documentation

◆ PanelDrawFn

using PanelDrawFn = void (*)(const bContext *, Panel *)

User Interface for F-Modifiers

This file defines templates and some editing callbacks needed by the interface for F-Modifiers, as used by F-Curves in the Graph Editor and NLA-Strips in the NLA Editor.

Definition at line 47 of file fmodifier_ui.cc.

Function Documentation

◆ ANIM_fmodifier_panels()

void ANIM_fmodifier_panels	(	const bContext *	C,
		ID *	owner_id,
		ListBase *	fmodifiers,
		uiListPanelIDFromDataFunc	panel_id_fn )

Checks if the panels match the active strip / curve, rebuilds them if they don't.

Definition at line 869 of file fmodifier_ui.cc.

References BLI_assert, CTX_wm_region(), PanelType::flag, LISTBASE_FOREACH, MAX_NAME, MEM_mallocN, Panel::next, PANEL_TYPE_INSTANCED, RNA_pointer_create(), Panel::type, UI_panel_add_instanced(), UI_panel_custom_data_set(), UI_panel_list_matches_data(), and UI_panels_free_instanced().

Referenced by graph_panel_modifiers(), and nla_panel_modifiers().

◆ ANIM_fmodifiers_copy_to_buf()

bool ANIM_fmodifiers_copy_to_buf	(	ListBase *	modifiers,
		bool	active )

Copy the given F-Modifiers to the buffer, returning whether anything was copied or not assuming that the buffer has been cleared already with ANIM_fmodifiers_copybuf_free()

Parameters

active Only copy the active modifier.

Definition at line 951 of file fmodifier_ui.cc.

References BLI_addtail(), copy_fmodifier(), copy_fmodifiers(), ELEM, find_active_fmodifier(), ListBase::first, and fmodifier_copypaste_buf.

Referenced by graph_fmodifier_copy_exec(), and nla_fmodifier_copy_exec().

◆ ANIM_fmodifiers_copybuf_free()

void ANIM_fmodifiers_copybuf_free ( )

Free the copy/paste buffer.

Definition at line 945 of file fmodifier_ui.cc.

References fmodifier_copypaste_buf, and free_fmodifiers().

Referenced by graph_fmodifier_copy_exec(), nla_fmodifier_copy_exec(), and WM_exit_ex().

◆ ANIM_fmodifiers_paste_from_buf()

bool ANIM_fmodifiers_paste_from_buf	(	ListBase *	modifiers,
		bool	replace,
		FCurve *	curve )

'Paste' the F-Modifier(s) from the buffer to the specified list

Parameters

replace Free all the existing modifiers to leave only the pasted ones.

Definition at line 980 of file fmodifier_ui.cc.

References BKE_fcurve_handles_recalc(), BKE_fcurve_is_cyclic(), BLI_addtail(), copy_fmodifier(), curve, FModifier::curve, FModifier::flag, fmodifier_copypaste_buf, free_fmodifiers(), and LISTBASE_FOREACH.

Referenced by graph_fmodifier_paste_exec(), and nla_fmodifier_paste_exec().

◆ ANIM_modifier_panels_register_graph_and_NLA()

void ANIM_modifier_panels_register_graph_and_NLA	(	ARegionType *	region_type,
		const char *	modifier_panel_prefix,
		PanelTypePollFn	poll_function )

Definition at line 912 of file fmodifier_ui.cc.

References panel_register_envelope(), panel_register_fn_generator(), panel_register_generator(), panel_register_limits(), panel_register_noise(), and panel_register_stepped().

Referenced by graph_buttons_register(), and nla_buttons_register().

◆ ANIM_modifier_panels_register_graph_only()

void ANIM_modifier_panels_register_graph_only	(	ARegionType *	region_type,
		const char *	modifier_panel_prefix,
		PanelTypePollFn	poll_function )

Definition at line 924 of file fmodifier_ui.cc.

References panel_register_cycles().

Referenced by graph_buttons_register().

◆ cycles_panel_draw()

static void cycles_panel_draw	(	const bContext *	C,
		Panel *	panel )

static

Definition at line 486 of file fmodifier_ui.cc.

References col, fmodifier_get_pointers(), fmodifier_influence_draw(), IFACE_, Panel::layout, ptr, UI_ITEM_NONE, uiItemR(), uiLayoutColumn(), uiLayoutSetPropDecorate(), and uiLayoutSetPropSep().

Referenced by panel_register_cycles().

◆ delete_fmodifier_cb()

static void delete_fmodifier_cb	(	bContext *	C,
		void *	ctx_v,
		void *	fcm_v )

static

Definition at line 236 of file fmodifier_ui.cc.

References DEG_id_tag_update(), ED_undo_push(), ID_RECALC_ANIMATION, FModifierDeleteContext::modifiers, NA_EDITED, NC_ANIMATION, ND_KEYFRAME, FModifierDeleteContext::owner_id, remove_fmodifier(), and WM_event_add_notifier().

Referenced by fmodifier_panel_header().

◆ envelope_panel_draw()

static void envelope_panel_draw	(	const bContext *	C,
		Panel *	panel )

static

◆ fmod_envelope_addpoint_cb()

static void fmod_envelope_addpoint_cb	(	bContext *	C,
		void *	fcm_dv,
		void *	)

static

Definition at line 573 of file fmodifier_ui.cc.

References BKE_fcm_envelope_find_index(), CTX_data_scene(), FMod_Envelope::data, FCM_EnvelopeData::f1, FCM_EnvelopeData::f2, float, FCM_EnvelopeData::max, MEM_callocN, MEM_freeN(), FCM_EnvelopeData::min, FCM_EnvelopeData::time, and FMod_Envelope::totvert.

Referenced by envelope_panel_draw().

◆ fmod_envelope_deletepoint_cb()

static void fmod_envelope_deletepoint_cb	(	bContext *	,
		void *	fcm_dv,
		void *	ind_v )

static

Definition at line 631 of file fmodifier_ui.cc.

References FMod_Envelope::data, MEM_callocN, MEM_freeN(), MEM_SAFE_FREE, POINTER_AS_INT, and FMod_Envelope::totvert.

Referenced by envelope_panel_draw().

◆ fmodifier_frame_range_draw()

static void fmodifier_frame_range_draw	(	const bContext *	C,
		Panel *	panel )

static

Definition at line 273 of file fmodifier_ui.cc.

References col, PointerRNA::data, FModifier::flag, FMODIFIER_FLAG_RANGERESTRICT, fmodifier_get_pointers(), IFACE_, Panel::layout, ptr, UI_ITEM_NONE, uiItemR(), uiLayoutColumn(), uiLayoutSetActive(), uiLayoutSetPropDecorate(), and uiLayoutSetPropSep().

Referenced by panel_register_cycles(), panel_register_envelope(), panel_register_fn_generator(), panel_register_generator(), panel_register_limits(), panel_register_noise(), and panel_register_stepped().

◆ fmodifier_frame_range_header_draw()

static void fmodifier_frame_range_header_draw	(	const bContext *	C,
		Panel *	panel )

static

Definition at line 264 of file fmodifier_ui.cc.

References fmodifier_get_pointers(), Panel::layout, ptr, UI_ITEM_NONE, and uiItemR().

Referenced by panel_register_cycles(), panel_register_envelope(), panel_register_fn_generator(), panel_register_generator(), panel_register_limits(), panel_register_noise(), and panel_register_stepped().

◆ fmodifier_get_pointers()

static PointerRNA * fmodifier_get_pointers	(	const bContext *	C,
		const Panel *	panel,
		ID **	r_owner_id )

static

Get a pointer to the panel's FModifier, and also its owner ID if r_owner_id is not nullptr. Also in the graph editor, gray out the panel if the FModifier's FCurve has modifiers turned off.

Definition at line 80 of file fmodifier_ui.cc.

References ANIM_graph_context_fcurve(), CTX_wm_space_graph(), FCURVE_MOD_OFF, FCurve::flag, Panel::layout, PointerRNA::owner_id, ptr, UI_panel_custom_data_get(), and uiLayoutSetActive().

Referenced by cycles_panel_draw(), envelope_panel_draw(), fmodifier_frame_range_draw(), fmodifier_frame_range_header_draw(), fmodifier_panel_header(), fmodifier_reorder(), fn_generator_panel_draw(), generator_panel_draw(), get_fmodifier_expand_flag(), limits_panel_draw(), noise_panel_draw(), set_fmodifier_expand_flag(), and stepped_panel_draw().

◆ fmodifier_influence_draw()

static void fmodifier_influence_draw	(	uiLayout *	layout,
		PointerRNA *	ptr )

static

Definition at line 251 of file fmodifier_ui.cc.

References PointerRNA::data, FModifier::flag, FMODIFIER_FLAG_USEINFLUENCE, IFACE_, ptr, UI_ITEM_NONE, uiItemR(), uiItemS(), uiLayoutRow(), uiLayoutRowWithHeading(), and uiLayoutSetActive().

Referenced by cycles_panel_draw(), envelope_panel_draw(), fn_generator_panel_draw(), generator_panel_draw(), limits_panel_draw(), noise_panel_draw(), and stepped_panel_draw().

◆ fmodifier_list_space_specific()

static ListBase * fmodifier_list_space_specific ( const bContext * C )

static

Get the list of FModifiers from the context (either the NLA or graph editor).

Definition at line 57 of file fmodifier_ui.cc.

References ANIM_graph_context_fcurve(), ANIM_nla_context_strip(), BLI_assert, CTX_wm_area(), FCurve::modifiers, NlaStrip::modifiers, SPACE_GRAPH, and SPACE_NLA.

Referenced by fmodifier_panel_header(), and fmodifier_reorder().

◆ fmodifier_panel_header()

static void fmodifier_panel_header	(	const bContext *	C,
		Panel *	panel )

static

◆ fmodifier_panel_register()

static PanelType * fmodifier_panel_register	(	ARegionType *	region_type,
		eFModifier_Types	type,
		PanelDrawFn	draw,
		PanelTypePollFn	poll,
		const char *	id_prefix )

static

◆ fmodifier_reorder()

static void fmodifier_reorder	(	bContext *	C,
		Panel *	panel,
		int	new_index )

static

Move an FModifier to the index it's moved to after a drag and drop.

Definition at line 99 of file fmodifier_ui.cc.

References BLI_assert, BLI_findindex(), BLI_listbase_link_move(), PointerRNA::data, DEG_id_tag_update(), ED_undo_push(), ListBase::first, FMI_REQUIRES_ORIGINAL_DATA, fmodifier_get_pointers(), fmodifier_list_space_specific(), get_fmodifier_typeinfo(), ID_RECALC_ANIMATION, NA_EDITED, NC_ANIMATION, ND_KEYFRAME, ptr, FModifierTypeInfo::requires_flag, RPT_ERROR, FModifier::type, WM_event_add_notifier(), and WM_report().

Referenced by fmodifier_panel_register().

◆ fmodifier_subpanel_register()

static PanelType * fmodifier_subpanel_register	(	ARegionType *	region_type,
		const char *	name,
		const char *	label,
		PanelDrawFn	draw_header,
		PanelDrawFn	draw,
		PanelTypePollFn	poll,
		PanelType *	parent )