action.c File Reference

#include <math.h>
#include <stddef.h>
#include <stdlib.h>
#include <string.h>
#include "MEM_guardedalloc.h"
#include "DNA_anim_types.h"
#include "DNA_armature_types.h"
#include "DNA_constraint_types.h"
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "BLI_blenlib.h"
#include "BLI_ghash.h"
#include "BLI_math.h"
#include "BLI_session_uuid.h"
#include "BLI_string_utils.h"
#include "BLI_utildefines.h"
#include "BLT_translation.h"
#include "BKE_action.h"
#include "BKE_anim_data.h"
#include "BKE_anim_visualization.h"
#include "BKE_animsys.h"
#include "BKE_armature.h"
#include "BKE_constraint.h"
#include "BKE_deform.h"
#include "BKE_fcurve.h"
#include "BKE_icons.h"
#include "BKE_idprop.h"
#include "BKE_idtype.h"
#include "BKE_lib_id.h"
#include "BKE_lib_query.h"
#include "BKE_main.h"
#include "BKE_object.h"
#include "DEG_depsgraph.h"
#include "DEG_depsgraph_build.h"
#include "BIK_api.h"
#include "RNA_access.h"
#include "BLO_read_write.h"
#include "CLG_log.h"

Go to the source code of this file.

Macros
#define	DNA_DEPRECATED_ALLOW

Functions
static void	action_copy_data (Main *UNUSED(bmain), ID *id_dst, const ID *id_src, const int flag)
static void	action_free_data (struct ID *id)
static void	action_foreach_id (ID *id, LibraryForeachIDData *data)
static void	action_blend_write (BlendWriter *writer, ID *id, const void *id_address)
static void	action_blend_read_data (BlendDataReader *reader, ID *id)
static void	blend_read_lib_constraint_channels (BlendLibReader *reader, ID *id, ListBase *chanbase)
static void	action_blend_read_lib (BlendLibReader *reader, ID *id)
static void	blend_read_expand_constraint_channels (BlendExpander *expander, ListBase *chanbase)
static void	action_blend_read_expand (BlendExpander *expander, ID *id)
bAction *	BKE_action_add (Main *bmain, const char name[])
bActionGroup *	get_active_actiongroup (bAction *act)
void	set_active_action_group (bAction *act, bActionGroup *agrp, short select)
void	action_group_colors_sync (bActionGroup *grp, const bActionGroup *ref_grp)
bActionGroup *	action_groups_add_new (bAction *act, const char name[])
void	action_groups_add_channel (bAction *act, bActionGroup *agrp, FCurve *fcurve)
void	BKE_action_groups_reconstruct (bAction *act)
void	action_groups_remove_channel (bAction *act, FCurve *fcu)
bActionGroup *	BKE_action_group_find_name (bAction *act, const char name[])
void	action_groups_clear_tempflags (bAction *act)
void	BKE_pose_channel_session_uuid_generate (bPoseChannel *pchan)
bPoseChannel *	BKE_pose_channel_find_name (const bPose *pose, const char *name)
bPoseChannel *	BKE_pose_channel_verify (bPose *pose, const char *name)
bool	BKE_pose_channels_is_valid (const bPose *pose)
bPoseChannel *	BKE_pose_channel_active (Object *ob)
bPoseChannel *	BKE_pose_channel_active_or_first_selected (struct Object *ob)
bPoseChannel *	BKE_pose_channel_get_mirrored (const bPose *pose, const char *name)
const char *	BKE_pose_ikparam_get_name (bPose *pose)
void	BKE_pose_copy_data_ex (bPose **dst, const bPose *src, const int flag, const bool copy_constraints)
void	BKE_pose_copy_data (bPose **dst, const bPose *src, const bool copy_constraints)
void	BKE_pose_itasc_init (bItasc *itasc)
void	BKE_pose_ikparam_init (bPose *pose)
static bool	pose_channel_in_IK_chain (Object *ob, bPoseChannel *pchan, int level)
bool	BKE_pose_channel_in_IK_chain (Object *ob, bPoseChannel *pchan)
void	BKE_pose_channels_hash_make (bPose *pose)
void	BKE_pose_channels_hash_free (bPose *pose)
static void	pose_channels_remove_internal_links (Object *ob, bPoseChannel *unlinked_pchan)
void	BKE_pose_channels_remove (Object *ob, bool(*filter_fn)(const char *bone_name, void *user_data), void *user_data)
void	BKE_pose_channel_free_ex (bPoseChannel *pchan, bool do_id_user)
void	BKE_pose_channel_runtime_reset (bPoseChannel_Runtime *runtime)
void	BKE_pose_channel_runtime_reset_on_copy (bPoseChannel_Runtime *runtime)
void	BKE_pose_channel_runtime_free (bPoseChannel_Runtime *runtime)
void	BKE_pose_channel_free_bbone_cache (bPoseChannel_Runtime *runtime)
void	BKE_pose_channel_free (bPoseChannel *pchan)
void	BKE_pose_channels_free_ex (bPose *pose, bool do_id_user)
void	BKE_pose_channels_free (bPose *pose)
void	BKE_pose_free_data_ex (bPose *pose, bool do_id_user)
void	BKE_pose_free_data (bPose *pose)
void	BKE_pose_free_ex (bPose *pose, bool do_id_user)
void	BKE_pose_free (bPose *pose)
void	BKE_pose_channel_copy_data (bPoseChannel *pchan, const bPoseChannel *pchan_from)
void	BKE_pose_update_constraint_flags (bPose *pose)
void	BKE_pose_tag_update_constraint_flags (bPose *pose)
bActionGroup *	BKE_pose_add_group (bPose *pose, const char *name)
void	BKE_pose_remove_group (bPose *pose, bActionGroup *grp, const int index)
void	BKE_pose_remove_group_index (bPose *pose, const int index)
bool	action_has_motion (const bAction *act)
void	calc_action_range (const bAction *act, float *start, float *end, short incl_modifiers)
short	action_get_item_transforms (bAction *act, Object *ob, bPoseChannel *pchan, ListBase *curves)
void	BKE_pose_rest (bPose *pose, bool selected_bones_only)
void	BKE_pose_copy_pchan_result (bPoseChannel *pchanto, const bPoseChannel *pchanfrom)
bool	BKE_pose_copy_result (bPose *to, bPose *from)
void	BKE_pose_tag_recalc (Main *bmain, bPose *pose)
void	what_does_obaction (Object *ob, Object *workob, bPose *pose, bAction *act, char groupname[], const AnimationEvalContext *anim_eval_context)
void	BKE_pose_check_uuids_unique_and_report (const bPose *pose)
void	BKE_pose_blend_write (BlendWriter *writer, bPose *pose, bArmature *arm)
void	BKE_pose_blend_read_data (BlendDataReader *reader, bPose *pose)
void	BKE_pose_blend_read_lib (BlendLibReader *reader, Object *ob, bPose *pose)
void	BKE_pose_blend_read_expand (BlendExpander *expander, bPose *pose)

Variables
static CLG_LogRef	LOG = {"bke.action"}
IDTypeInfo	IDType_ID_AC

Macro Definition Documentation

DNA_DEPRECATED_ALLOW

#define DNA_DEPRECATED_ALLOW

Definition at line 32 of file action.c.

Function Documentation

action_blend_read_data()

static void action_blend_read_data ( BlendDataReader *  reader, ID *  id  )

static

Definition at line 207 of file action.c.

References BKE_fcurve_blend_read_data(), BKE_previewimg_blend_read(), BLO_read_data_address, BLO_read_list(), bAction::curves, bAction::groups, LISTBASE_FOREACH, bAction::markers, and bAction::preview.

action_blend_read_expand()

static void action_blend_read_expand ( BlendExpander *  expander, ID *  id  )

static

Definition at line 269 of file action.c.

References BKE_fcurve_blend_read_expand(), blend_read_expand_constraint_channels(), BLO_expand, bAction::curves, LISTBASE_FOREACH, and bAction::markers.

action_blend_read_lib()

static void action_blend_read_lib ( BlendLibReader *  reader, ID *  id  )

static

Definition at line 242 of file action.c.

References BKE_fcurve_blend_read_lib(), blend_read_lib_constraint_channels(), BLO_read_id_address, bAction::curves, bAction::id, ID::lib, LISTBASE_FOREACH, and bAction::markers.

action_blend_write()

static void action_blend_write ( BlendWriter *  writer, ID *  id, const void *  id_address  )

static

Definition at line 186 of file action.c.

References BKE_fcurve_blend_write(), BKE_id_blend_write(), BKE_previewimg_blend_write(), BLO_write_id_struct, BLO_write_is_undo(), BLO_write_struct, bAction::curves, bAction::groups, bAction::id, LISTBASE_FOREACH, bAction::markers, bAction::preview, and ID::us.

action_copy_data()

static void action_copy_data ( Main *  UNUSEDbmain, ID *  id_dst, const ID *  id_src, const int  flag  )

static

Only copy internal data of Action ID from source to already allocated/initialized destination. You probably never want to use that directly, use BKE_id_copy or BKE_id_copy_ex for typical needs.

WARNING! This function will not handle ID user count!

Parameters

flag	Copying options (see BKE_lib_id.h's LIB_ID_COPY_... flags for more).

Definition at line 105 of file action.c.

References BKE_fcurve_copy(), BKE_previewimg_id_copy(), BLI_addtail(), BLI_duplicatelist(), BLI_listbase_clear(), bActionGroup::channels, bAction::curves, ListBase::first, bAction::groups, FCurve::grp, bAction::id, ListBase::last, LIB_ID_COPY_NO_PREVIEW, bAction::markers, bActionGroup::next, FCurve::next, NULL, and bAction::preview.

action_foreach_id()

static void action_foreach_id ( ID *  id, LibraryForeachIDData *  data  )

static

Definition at line 173 of file action.c.

References BKE_fcurve_foreach_id(), BKE_LIB_FOREACHID_PROCESS, bAction::curves, data, IDWALK_CB_NOP, LISTBASE_FOREACH, and bAction::markers.

action_free_data()

static void action_free_data ( struct ID *  id )

static

Free (or release) any data used by this action (does not free the action itself).

Definition at line 156 of file action.c.

References BKE_fcurves_free(), BKE_previewimg_free(), BLI_freelistN(), bAction::curves, bAction::groups, bAction::markers, and bAction::preview.

action_get_item_transforms()

short action_get_item_transforms	(	bAction *	act,
		Object *	ob,
		bPoseChannel *	pchan,
		ListBase *	curves
	)

Definition at line 1503 of file action.c.

References ACT_TRANS_ALL, ACT_TRANS_BBONE, ACT_TRANS_LOC, ACT_TRANS_PROP, ACT_TRANS_ROT, ACT_TRANS_SCALE, BLI_addtail(), BLI_genericNodeN(), bAction::curves, ListBase::first, MEM_freeN, FCurve::next, NULL, ptr, RNA_id_pointer_create(), FCurve::rna_path, RNA_path_from_ID_to_struct(), RNA_pointer_create(), and RNA_PoseBone.

Referenced by fcurves_to_pchan_links_get().

action_group_colors_sync()

void action_group_colors_sync	(	bActionGroup *	grp,
		const bActionGroup *	ref_grp
	)

Definition at line 371 of file action.c.

References ThemeWireColor::active, bActionGroup::cs, bActionGroup::customCol, rgba_uchar_args_set(), ThemeWireColor::select, ThemeWireColor::solid, and bTheme::tarm.

action_groups_add_channel()

void action_groups_add_channel	(	bAction *	act,
		bActionGroup *	agrp,
		FCurve *	fcurve
	)

Definition at line 431 of file action.c.

References BLI_insertlinkafter(), BLI_insertlinkbefore(), BLI_listbase_is_empty(), bActionGroup::channels, bAction::curves, ELEM, ListBase::first, FCurve::grp, ListBase::last, FCurve::next, NULL, bActionGroup::prev, and FCurve::prev.

Referenced by action_move_fcurves_by_basepath(), AnimationImporter::add_bone_fcurve(), animchannels_group_channels(), ED_action_fcurve_ensure(), fcurve_add_to_list(), and updateDuplicateActionConstraintSettings().

action_groups_add_new()

bActionGroup* action_groups_add_new	(	bAction *	act,
		const char	name[]
	)

Definition at line 402 of file action.c.

References AGRP_SELECTED, BLI_addtail(), BLI_strncpy(), BLI_uniquename(), DATA_, ELEM, bActionGroup::flag, bAction::groups, MEM_callocN, bActionGroup::name, and NULL.

Referenced by action_move_fcurves_by_basepath(), animchannels_group_channels(), ED_action_fcurve_ensure(), and updateDuplicateActionConstraintSettings().

action_groups_clear_tempflags()

void action_groups_clear_tempflags

(

bAction *

act

)

Definition at line 591 of file action.c.

References AGRP_TEMP, ELEM, ListBase::first, bActionGroup::flag, bAction::groups, bActionGroup::next, and NULL.

Referenced by action_move_fcurves_by_basepath().

action_groups_remove_channel()

void action_groups_remove_channel	(	bAction *	act,
		FCurve *	fcu
	)

Definition at line 538 of file action.c.

References BLI_listbase_clear(), BLI_remlink(), bActionGroup::channels, bAction::curves, ELEM, ListBase::first, FCurve::grp, ListBase::last, FCurve::next, NULL, and FCurve::prev.

Referenced by action_move_fcurves_by_basepath(), ANIM_fcurve_delete_from_animdata(), animchannels_delete_exec(), animchannels_group_channels(), animchannels_ungroup_exec(), fcurve_path_rename(), fcurve_remove(), and remove_sequencer_fcurves().

action_has_motion()

bool action_has_motion

(

const bAction *

act

)

Definition at line 1395 of file action.c.

References bAction::curves, ListBase::first, FCurve::next, and FCurve::totvert.

BKE_action_add()

bAction* BKE_action_add	(	Main *	bmain,
		const char	name[]
	)

Definition at line 320 of file action.c.

References BKE_id_new(), and ID_AC.

Referenced by action_create_new(), BKE_animdata_transfer_by_basepath(), do_versions_ipos_to_animato(), ED_id_action_ensure(), ipo_to_animdata(), and poselib_init_new().

BKE_action_group_find_name()

bActionGroup* BKE_action_group_find_name	(	bAction *	act,
		const char	name[]
	)

Definition at line 579 of file action.c.

References BLI_findstring(), ELEM, ListBase::first, bAction::groups, and NULL.

Referenced by action_move_fcurves_by_basepath(), AnimationImporter::add_bone_fcurve(), animviz_calc_motionpaths(), ED_action_fcurve_ensure(), fcurve_add_to_list(), updateDuplicateActionConstraintSettings(), and what_does_obaction().

BKE_action_groups_reconstruct()

void BKE_action_groups_reconstruct

(

bAction *

act

)

Definition at line 505 of file action.c.

References BLI_listbase_clear(), bActionGroup::channels, bAction::curves, ELEM, ListBase::first, bAction::groups, ListBase::last, LISTBASE_FOREACH, and NULL.

Referenced by curve_rename_fcurves().

BKE_pose_add_group()

bActionGroup* BKE_pose_add_group	(	bPose *	pose,
		const char *	name
	)

Definition at line 1322 of file action.c.

References bPose::active_group, bPose::agroups, BLI_addtail(), BLI_listbase_count(), BLI_strncpy(), BLI_uniquename(), DATA_, MEM_callocN, and bActionGroup::name.

Referenced by pose_group_add_exec(), and pose_group_assign_exec().

BKE_pose_blend_read_data()

void BKE_pose_blend_read_data	(	BlendDataReader *	reader,
		bPose *	pose
	)

Definition at line 1894 of file action.c.

References bPose::agroups, animviz_motionpath_blend_read_data(), BKE_constraint_blend_read_data(), BKE_pose_channel_runtime_reset(), BKE_pose_channel_session_uuid_generate(), BLI_listbase_clear(), BLO_read_data_address, BLO_read_list(), bPose::chan_array, bPose::chanbase, bPose::chanhash, CLAMP, IDP_BlendDataRead, bPose::ikdata, bPose::ikparam, LISTBASE_FOREACH, NULL, ROT_MODE_MAX, and ROT_MODE_MIN.

Referenced by object_blend_read_data().

BKE_pose_blend_read_expand()

void BKE_pose_blend_read_expand	(	BlendExpander *	expander,
		bPose *	pose
	)

Definition at line 2000 of file action.c.

References BKE_constraint_blend_read_expand(), BLO_expand, bPose::chanbase, IDP_BlendReadExpand(), and LISTBASE_FOREACH.

Referenced by object_blend_read_expand().

BKE_pose_blend_read_lib()

void BKE_pose_blend_read_lib	(	BlendLibReader *	reader,
		Object *	ob,
		bPose *	pose
	)

Definition at line 1942 of file action.c.

References bArmature::act_bone, BKE_armature_find_bone_name(), BKE_constraint_blend_read_lib(), BKE_pose_tag_recalc(), BLO_read_id_address, BLO_read_lib_get_main(), BLO_read_lib_is_undo(), BONE_SELECTED, bPose::chanbase, Object::constraints, Object::data, DEG_id_tag_update_ex(), bArmature::id, Object::id, ID_RECALC_ANIMATION, ID_RECALC_GEOMETRY, ID_RECALC_TRANSFORM, IDP_BlendReadLib(), bArmature::layer, ID::lib, LISTBASE_FOREACH, NULL, Object::proxy, bPose::proxy_act_bone, bPose::proxy_layer, and UNLIKELY.

Referenced by object_blend_read_lib().

BKE_pose_blend_write()

void BKE_pose_blend_write	(	BlendWriter *	writer,
		bPose *	pose,
		bArmature *	arm
	)

Definition at line 1842 of file action.c.

References bPose::agroups, animviz_motionpath_blend_write(), BKE_armature_find_bone_name(), BKE_constraint_blend_write(), BKE_pose_ikparam_get_name(), BLI_assert, BLO_write_struct, BLO_write_struct_by_name(), BONE_SELECTED, bPose::chanbase, bPose::flag, Bone::flag, IDP_BlendWrite(), bPose::ikparam, LISTBASE_FOREACH, NULL, and POSE_RECALC.

Referenced by object_blend_write().

BKE_pose_channel_active()

bPoseChannel* BKE_pose_channel_active

(

Object *

ob

)

Find the active pose-channel for an object (we can't just use pose, as layer info is in armature)

Note

Object, not bPose is used here, as we need layer info from Armature.

Definition at line 708 of file action.c.

References bArmature::act_bone, bPose::chanbase, Object::data, ELEM, ListBase::first, if(), bArmature::layer, NULL, and Object::pose.

Referenced by add_hook_object(), BKE_pose_channel_active_or_first_selected(), constraint_add_exec(), draw_constraint_header(), ED_object_calc_active_center_for_posemode(), ED_object_constraint_active_list(), ED_object_parent_set(), get_new_constraint_target(), getTransformOrientation_ex(), gimbal_axis(), pose_ik_add_invoke(), pose_select_hierarchy_exec(), screen_ctx_active_pose_bone(), v3d_posearmature_buts(), view_lock_to_active_exec(), WIDGETGROUP_armature_spline_poll(), WIDGETGROUP_armature_spline_refresh(), and WIDGETGROUP_armature_spline_setup().

BKE_pose_channel_active_or_first_selected()

bPoseChannel* BKE_pose_channel_active_or_first_selected

(

struct Object *

ob

)

Use this when detecting the "other selected bone", when we have multiple armatures in pose mode.

In this case the active-selected is an obvious choice when finding the target for a constraint for eg. however from the users perspective the active pose bone of the active object is the real active bone, so any other non-active selected bone is a candidate for being the other selected bone, see: T58447.

Definition at line 736 of file action.c.

References BKE_pose_channel_active(), bPoseChannel::bone, BONE_SELECTED, bPose::chanbase, Object::data, ELEM, ListBase::first, Bone::flag, if(), bPoseChannel::next, NULL, PBONE_VISIBLE, and Object::pose.

Referenced by get_new_constraint_target().

BKE_pose_channel_copy_data()

void BKE_pose_channel_copy_data	(	bPoseChannel *	pchan,
		const bPoseChannel *	pchan_from
	)

Copy the internal members of each pose channel including constraints and ID-Props, used when duplicating bones in editmode. (unlike copy_pose_channel_data which only does posing-related stuff).

Note

use when copying bones in editmode (on returned value from BKE_pose_channel_verify)

Definition at line 1196 of file action.c.

References bPoseChannel::agrp_index, bPoseChannel::bbone_next, bPoseChannel::bbone_prev, BKE_constraints_copy(), bPoseChannel::constraints, copy_v3_v3(), bPoseChannel::custom, bPoseChannel::custom_scale, bPoseChannel::drawflag, Object::id, id_us_plus(), IDP_CopyProperty(), IDP_FreeProperty(), bPoseChannel::ikflag, bPoseChannel::iklinweight, bPoseChannel::ikrotweight, bPoseChannel::ikstretch, bPoseChannel::limitmax, bPoseChannel::limitmin, NULL, bPoseChannel::prop, bPoseChannel::protectflag, bPoseChannel::rotmode, and bPoseChannel::stiffness.

BKE_pose_channel_find_name()

bPoseChannel* BKE_pose_channel_find_name	(	const bPose *	pose,
		const char *	name
	)

Return a pointer to the pose channel of the given name from this pose.

Definition at line 617 of file action.c.

References BLI_findstring(), BLI_ghash_lookup(), bPose::chanbase, bPose::chanhash, ELEM, and NULL.

Referenced by BKE_pose_channel_get_mirrored(), BKE_pose_channel_verify(), BKE_pose_copy_data_ex(), BKE_pose_copy_result(), and pose_channel_in_IK_chain().

BKE_pose_channel_free()

void BKE_pose_channel_free

(

bPoseChannel *

pchan

)

Definition at line 1117 of file action.c.

References BKE_pose_channel_free_ex().

Referenced by armature_symmetrize_exec(), BKE_pose_channels_remove(), pose_proxy_sync(), and separate_armature_bones().

BKE_pose_channel_free_bbone_cache()

void BKE_pose_channel_free_bbone_cache

(

bPoseChannel_Runtime *

runtime

)

Deallocates runtime cache of a pose channel's B-Bone shape.

Definition at line 1108 of file action.c.

References bPoseChannel_Runtime::bbone_deform_mats, bPoseChannel_Runtime::bbone_dual_quats, bPoseChannel_Runtime::bbone_pose_mats, bPoseChannel_Runtime::bbone_rest_mats, bPoseChannel_Runtime::bbone_segments, and MEM_SAFE_FREE.

Referenced by allocate_bbone_cache(), BKE_pchan_bbone_segments_cache_copy(), BKE_pose_bone_done(), BKE_pose_channel_runtime_free(), and BKE_pose_eval_init().

BKE_pose_channel_free_ex()

void BKE_pose_channel_free_ex	(	bPoseChannel *	pchan,
		bool	do_id_user
	)

Deallocates a pose channel. Does not free the pose channel itself.

Definition at line 1059 of file action.c.

References animviz_free_motionpath(), BKE_constraints_free_ex(), BKE_pose_channel_runtime_free(), bPoseChannel::constraints, bPoseChannel::custom, bPoseChannel::draw_data, Object::id, id_us_min(), IDP_FreeProperty_ex(), MEM_SAFE_FREE, bPoseChannel::mpath, NULL, bPoseChannel::prop, and bPoseChannel::runtime.

Referenced by BKE_pose_channel_free(), BKE_pose_channels_clear_with_null_bone(), and BKE_pose_channels_free_ex().

BKE_pose_channel_get_mirrored()

bPoseChannel* BKE_pose_channel_get_mirrored	(	const bPose *	pose,
		const char *	name
	)

See also

ED_armature_ebone_get_mirrored (edit-mode, matching function)

Definition at line 762 of file action.c.

References BKE_pose_channel_find_name(), BLI_string_flip_side_name(), MAXBONENAME, NULL, and STREQ.

BKE_pose_channel_in_IK_chain()

bool BKE_pose_channel_in_IK_chain	(	Object *	ob,
		bPoseChannel *	pchan
	)

Definition at line 939 of file action.c.

References pose_channel_in_IK_chain().

BKE_pose_channel_runtime_free()

void BKE_pose_channel_runtime_free

(

bPoseChannel_Runtime *

runtime

)

Deallocates runtime cache of a pose channel

Definition at line 1102 of file action.c.

References BKE_pose_channel_free_bbone_cache().

Referenced by BKE_pose_channel_free_ex(), and blender::deg::ObjectRuntimeBackup::restore_pose_channel_runtime_data().

BKE_pose_channel_runtime_reset()

void BKE_pose_channel_runtime_reset

(

bPoseChannel_Runtime *

runtime

)

Clears the runtime cache of a pose channel without free.

Definition at line 1088 of file action.c.

Referenced by blender::deg::ObjectRuntimeBackup::backup_pose_channel_runtime_data(), and BKE_pose_blend_read_data().

BKE_pose_channel_runtime_reset_on_copy()

void BKE_pose_channel_runtime_reset_on_copy

(

bPoseChannel_Runtime *

runtime

)

Definition at line 1094 of file action.c.

References bPoseChannel_Runtime::session_uuid.

Referenced by BKE_pose_copy_data_ex(), and pose_proxy_sync().

BKE_pose_channel_session_uuid_generate()

void BKE_pose_channel_session_uuid_generate

(

bPoseChannel *

pchan

)

Definition at line 608 of file action.c.

References BLI_session_uuid_generate(), bPoseChannel::runtime, and bPoseChannel_Runtime::session_uuid.

Referenced by BKE_pose_blend_read_data(), BKE_pose_channel_verify(), and BKE_pose_copy_data_ex().

BKE_pose_channel_verify()

bPoseChannel* BKE_pose_channel_verify	(	bPose *	pose,
		const char *	name
	)

Looks to see if the channel with the given name already exists in this pose - if not a new one is allocated and initialized.

Note

Use with care, not on Armature poses but for temporal ones.

(currently used for action constraints and in rebuild_pose).

Definition at line 638 of file action.c.

References BKE_pose_channel_find_name(), BKE_pose_channel_session_uuid_generate(), BLI_addtail(), BLI_ghash_insert(), BLI_strncpy(), bPose::chanbase, bPose::chanhash, bPoseChannel::constinv, bPoseChannel::custom_scale, bPoseChannel::iklinweight, bPoseChannel::ikrotweight, bPoseChannel::limitmax, bPoseChannel::limitmin, M_PI, MEM_callocN, bPoseChannel::name, NULL, OB_LOCK_ROT4D, bPoseChannel::protectflag, bPoseChannel::quat, bPoseChannel::rotAngle, bPoseChannel::rotAxis, bPoseChannel::scale_in_x, bPoseChannel::scale_in_y, bPoseChannel::scale_out_x, bPoseChannel::scale_out_y, bPoseChannel::size, bPoseChannel::stiffness, unit_axis_angle(), unit_m4(), and unit_qt().

Referenced by actcon_get_tarmat(), armature_symmetrize_exec(), copy_pchan(), rebuild_pose_bone(), updateDuplicateConstraintSettings(), updateDuplicateCustomBoneShapes(), and updateDuplicateSubtarget().

BKE_pose_channels_free()

void BKE_pose_channels_free

(

bPose *

pose

)

Definition at line 1143 of file action.c.

References BKE_pose_channels_free_ex().

BKE_pose_channels_free_ex()

void BKE_pose_channels_free_ex	(	bPose *	pose,
		bool	do_id_user
	)

Removes and deallocates all channels from a pose. Does not free the pose itself.

Definition at line 1126 of file action.c.

References BKE_pose_channel_free_ex(), BKE_pose_channels_hash_free(), BLI_freelistN(), bPose::chan_array, bPose::chanbase, ListBase::first, MEM_SAFE_FREE, and bPoseChannel::next.

Referenced by BKE_pose_channels_free(), and BKE_pose_free_data_ex().

BKE_pose_channels_hash_free()

void BKE_pose_channels_hash_free

(

bPose *

pose

)

Definition at line 960 of file action.c.

References BLI_ghash_free(), bPose::chanhash, and NULL.

Referenced by BKE_pose_channels_clear_with_null_bone(), BKE_pose_channels_free_ex(), ED_armature_join_objects_exec(), postEditBoneDuplicate(), and separate_armature_bones().

BKE_pose_channels_hash_make()

void BKE_pose_channels_hash_make

(

bPose *

pose

)

Removes the hash for quick lookup of channels, must be done when adding/removing channels.

Definition at line 948 of file action.c.

References BLI_ghash_insert(), BLI_ghash_str_new(), bPose::chanbase, bPose::chanhash, ListBase::first, bPoseChannel::name, and bPoseChannel::next.

Referenced by BKE_object_handle_update_ex(), BKE_pose_copy_data_ex(), BKE_pose_rebuild(), blender::deg::DepsgraphNodeBuilder::build_proxy_rig(), blender::deg::DepsgraphNodeBuilder::build_rig(), postEditBoneDuplicate(), and what_does_obaction().

BKE_pose_channels_is_valid()

bool BKE_pose_channels_is_valid

(

const bPose *

pose

)

Definition at line 686 of file action.c.

References BLI_ghash_lookup(), bPose::chanbase, bPose::chanhash, ListBase::first, bPoseChannel::name, and bPoseChannel::next.

BKE_pose_channels_remove()

void BKE_pose_channels_remove	(	Object *	ob,
		bool(*)(const char *bone_name, void *user_data)	filter_fn,
		void *	user_data
	)

Selectively remove pose channels.

Definition at line 986 of file action.c.

References bPoseChannel::bbone_next, bPoseChannel::bbone_prev, BKE_constraint_typeinfo_get(), BKE_pose_channel_free(), BLI_freelinkN(), BLI_ghash_remove(), bPose::chanbase, bPose::chanhash, CONSTRAINT_DISABLE, bPoseChannel::constraints, bPoseChannel::custom_tx, ListBase::first, bConstraint::flag, bConstraintTypeInfo::flush_constraint_targets, bConstraintTypeInfo::get_constraint_targets, bPoseChannel::name, bPoseChannel::next, bConstraint::next, bConstraintTarget::next, NULL, Object::pose, pose_channels_remove_internal_links(), bConstraintTarget::subtarget, bConstraintTarget::tar, and user_data.

Referenced by armature_delete_selected_exec(), and armature_dissolve_selected_exec().

BKE_pose_check_uuids_unique_and_report()

void BKE_pose_check_uuids_unique_and_report

(

const bPose *

pose

)

Definition at line 1815 of file action.c.

References BLI_gset_free(), BLI_gset_insert(), BLI_gset_lookup(), BLI_gset_new(), BLI_session_uuid_ghash_compare(), BLI_session_uuid_ghash_hash(), BLI_session_uuid_is_generated(), bPose::chanbase, LISTBASE_FOREACH, and NULL.

BKE_pose_copy_data()

void BKE_pose_copy_data	(	bPose **	dst,
		const bPose *	src,
		const bool	copy_constraints
	)

Definition at line 874 of file action.c.

References BKE_pose_copy_data_ex().

BKE_pose_copy_data_ex()

void BKE_pose_copy_data_ex	(	bPose **	dst,
		const bPose *	src,
		const int	flag,
		const bool	copy_constraints
	)

Allocate a new pose on the heap, and copy the src pose and its channels into the new pose. *dst is set to the newly allocated structure, and assumed to be NULL.

Parameters

dst	Should be freed already, makes entire duplicate.

Definition at line 794 of file action.c.

References bPose::agroups, animviz_copy_motionpath(), bPose::avs, bPoseChannel::bbone_next, bPoseChannel::bbone_prev, BKE_constraints_copy_ex(), BKE_pose_channel_find_name(), BKE_pose_channel_runtime_reset_on_copy(), BKE_pose_channel_session_uuid_generate(), BKE_pose_channels_hash_make(), BLI_duplicatelist(), bPose::chanbase, bPose::chanhash, bPoseChannel::constraints, bPoseChannel::custom, bPoseChannel::custom_tx, bPoseChannel::draw_data, ListBase::first, id_us_plus(), IDP_CopyProperty_ex(), bPose::ikdata, bPose::ikparam, bPose::iksolver, ListBase::last, LIB_ID_CREATE_NO_MAIN, LIB_ID_CREATE_NO_USER_REFCOUNT, MEM_callocN, MEM_dupallocN, bPoseChannel::mpath, bPoseChannel::name, bPoseChannel::next, NULL, bPoseChannel::prop, and bPoseChannel::runtime.

Referenced by BKE_pose_copy_data().

BKE_pose_copy_pchan_result()

void BKE_pose_copy_pchan_result	(	bPoseChannel *	pchanto,
		const bPoseChannel *	pchanfrom
	)

Definition at line 1668 of file action.c.

References bPoseChannel::chan_mat, copy_m4_m4(), copy_qt_qt(), copy_v3_v3(), bPoseChannel::curve_in_x, bPoseChannel::curve_in_y, bPoseChannel::curve_out_x, bPoseChannel::curve_out_y, bPoseChannel::ease1, bPoseChannel::ease2, bPoseChannel::eul, bPoseChannel::flag, bPoseChannel::loc, bPoseChannel::pose_head, bPoseChannel::pose_mat, bPoseChannel::pose_tail, bPoseChannel::protectflag, bPoseChannel::quat, bPoseChannel::roll1, bPoseChannel::roll2, bPoseChannel::rotmode, bPoseChannel::scale_in_x, bPoseChannel::scale_in_y, bPoseChannel::scale_out_x, bPoseChannel::scale_out_y, and bPoseChannel::size.

Referenced by BKE_pose_copy_result().

BKE_pose_copy_result()

bool BKE_pose_copy_result	(	bPose *	to,
		bPose *	from
	)

Definition at line 1701 of file action.c.

References BKE_pose_channel_find_name(), BKE_pose_copy_pchan_result(), CLOG_ERROR, from, LOG, bPoseChannel::name, bPoseChannel::next, and NULL.

Referenced by BKE_object_handle_data_update().

BKE_pose_free()

void BKE_pose_free

(

bPose *

pose

)

Definition at line 1184 of file action.c.

References BKE_pose_free_ex().

Referenced by object_blend_read_lib().

BKE_pose_free_data()

void BKE_pose_free_data

(

bPose *

pose

)

Definition at line 1167 of file action.c.

References BKE_pose_free_data_ex().

Referenced by actcon_get_tarmat().

BKE_pose_free_data_ex()

void BKE_pose_free_data_ex	(	bPose *	pose,
		bool	do_id_user
	)

Definition at line 1148 of file action.c.

References bPose::agroups, BIK_clear_data(), BKE_pose_channels_free_ex(), BLI_freelistN(), ListBase::first, bPose::ikparam, and MEM_freeN.

Referenced by BKE_pose_free_data(), and BKE_pose_free_ex().

BKE_pose_free_ex()

void BKE_pose_free_ex	(	bPose *	pose,
		bool	do_id_user
	)

Removes and deallocates all data from a pose, and also frees the pose.

Definition at line 1175 of file action.c.

References BKE_pose_free_data_ex(), and MEM_freeN.

Referenced by BKE_pose_free(), and object_free_data().

BKE_pose_ikparam_get_name()

const char* BKE_pose_ikparam_get_name

(

bPose *

pose

)

Definition at line 775 of file action.c.

References bPose::iksolver, IKSOLVER_ITASC, IKSOLVER_STANDARD, and NULL.

Referenced by BKE_pose_blend_write().

BKE_pose_ikparam_init()

void BKE_pose_ikparam_init

(

bPose *

pose

)

Definition at line 896 of file action.c.

References BKE_pose_itasc_init(), bPose::ikparam, bPose::iksolver, IKSOLVER_ITASC, IKSOLVER_STANDARD, MEM_callocN, and NULL.

BKE_pose_itasc_init()

void BKE_pose_itasc_init

(

bItasc *

itasc

)

Definition at line 879 of file action.c.

References bItasc::dampeps, bItasc::dampmax, bItasc::feedback, bItasc::flag, bItasc::iksolver, IKSOLVER_ITASC, ITASC_AUTO_STEP, ITASC_INITIAL_REITERATION, ITASC_SOLVER_SDLS, bItasc::maxstep, bItasc::maxvel, bItasc::minstep, bItasc::numiter, bItasc::numstep, bItasc::precision, and bItasc::solver.

Referenced by BKE_pose_ikparam_init(), and get_ikdata().

BKE_pose_remove_group()

void BKE_pose_remove_group	(	bPose *	pose,
		bActionGroup *	grp,
		const int	index
	)

Definition at line 1342 of file action.c.

References bPose::active_group, bPose::agroups, bPoseChannel::agrp_index, BLI_assert, BLI_findindex(), BLI_freelinkN(), BLI_listbase_is_empty(), bPose::chanbase, ListBase::first, and bPoseChannel::next.

Referenced by BKE_pose_remove_group_index().

BKE_pose_remove_group_index()

void BKE_pose_remove_group_index	(	bPose *	pose,
		const int	index
	)

Definition at line 1381 of file action.c.

References bPose::agroups, BKE_pose_remove_group(), BLI_findlink(), and NULL.

Referenced by pose_group_remove_exec().

BKE_pose_rest()

void BKE_pose_rest	(	bPose *	pose,
		bool	selected_bones_only
	)

Zero the pose transforms for the entire pose or only for selected bones.

Definition at line 1636 of file action.c.

References bPoseChannel::bone, BONE_SELECTED, bPose::chanbase, bPoseChannel::curve_in_x, bPoseChannel::curve_in_y, bPoseChannel::curve_out_x, bPoseChannel::curve_out_y, bPose::cyclic_offset, bPoseChannel::ease1, bPoseChannel::ease2, bPoseChannel::eul, ListBase::first, bPoseChannel::flag, Bone::flag, bPoseChannel::loc, bPoseChannel::next, NULL, POSE_BBONE_SHAPE, POSE_LOC, POSE_ROT, POSE_SIZE, bPoseChannel::quat, bPoseChannel::roll1, bPoseChannel::roll2, bPoseChannel::rotAngle, bPoseChannel::rotAxis, bPoseChannel::scale_in_x, bPoseChannel::scale_in_y, bPoseChannel::scale_out_x, bPoseChannel::scale_out_y, bPoseChannel::size, bPose::stride_offset, unit_axis_angle(), unit_qt(), and zero_v3().

Referenced by BKE_object_make_proxy(), pose_clear_user_transforms_exec(), and pose_proxy_sync().

BKE_pose_tag_recalc()

void BKE_pose_tag_recalc	(	Main *	bmain,
		bPose *	pose
	)

Definition at line 1726 of file action.c.

References DEG_relations_tag_update(), bPose::flag, and POSE_RECALC.

Referenced by armature_delete_selected_exec(), BKE_object_duplicate(), BKE_pose_blend_read_lib(), blo_do_versions_pre250(), constraint_add_exec(), object_pose_tag_update(), and pose_constraint_copy_exec().

BKE_pose_tag_update_constraint_flags()

void BKE_pose_tag_update_constraint_flags

(

bPose *

pose

)

Definition at line 1314 of file action.c.

References bPose::flag, and POSE_CONSTRAINTS_NEED_UPDATE_FLAGS.

Referenced by ED_object_constraint_tag_update().

BKE_pose_update_constraint_flags()

void BKE_pose_update_constraint_flags

(

bPose *

pose

)

Definition at line 1247 of file action.c.

References bPoseChannel::bone, BONE_CONNECTED, bPose::chanbase, bPoseChannel::constflag, CONSTRAINT_IK_TIP, CONSTRAINT_TYPE_FOLLOWPATH, CONSTRAINT_TYPE_KINEMATIC, CONSTRAINT_TYPE_SPLINEIK, bPoseChannel::constraints, data, bConstraint::data, ListBase::first, bPose::flag, Bone::flag, if(), bPoseChannel::next, bConstraint::next, NULL, OB_ARMATURE, OB_CURVE, bPoseChannel::parent, PCHAN_HAS_CONST, PCHAN_HAS_IK, PCHAN_HAS_SPLINEIK, PCHAN_HAS_TARGET, POSE_CONSTRAINTS_NEED_UPDATE_FLAGS, POSE_CONSTRAINTS_TIMEDEPEND, and bConstraint::type.

Referenced by BKE_object_handle_update_ex(), BKE_pose_rebuild(), blender::deg::DepsgraphNodeBuilder::build_proxy_rig(), blender::deg::DepsgraphNodeBuilder::build_rig(), constraint_add_exec(), ED_object_constraint_update(), and what_does_obaction().

blend_read_expand_constraint_channels()

static void blend_read_expand_constraint_channels ( BlendExpander *  expander, ListBase *  chanbase  )

static

Definition at line 262 of file action.c.

References BLO_expand, and LISTBASE_FOREACH.

Referenced by action_blend_read_expand().

blend_read_lib_constraint_channels()

static void blend_read_lib_constraint_channels ( BlendLibReader *  reader, ID *  id, ListBase *  chanbase  )

static

Definition at line 235 of file action.c.

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

Referenced by action_blend_read_lib().

calc_action_range()

void calc_action_range	(	const bAction *	act,
		float *	start,
		float *	end,
		short	incl_modifiers
	)

Definition at line 1413 of file action.c.

References FMod_Cycles::after_mode, FMod_Cycles::before_mode, BKE_fcurve_calc_range(), bAction::curves, FModifier::data, FCM_EXTRAPOLATE_NONE, FCM_LIMIT_XMAX, FCM_LIMIT_XMIN, ListBase::first, FMod_Limits::flag, FMODIFIER_TYPE_CYCLES, FMODIFIER_TYPE_LIMITS, if(), ListBase::last, max, max_ff(), MAXFRAMEF, min, min_ff(), MINAFRAMEF, FCurve::modifiers, FCurve::next, FMod_Limits::rect, FCurve::totvert, FModifier::type, rctf::xmax, and rctf::xmin.

get_active_actiongroup()

bActionGroup* get_active_actiongroup

(

bAction *

act

)

Definition at line 334 of file action.c.

References AGRP_ACTIVE, ListBase::first, bActionGroup::flag, bAction::groups, bActionGroup::next, and NULL.

pose_channel_in_IK_chain()

static bool pose_channel_in_IK_chain ( Object *  ob, bPoseChannel *  pchan, int  level  )

static

Definition at line 913 of file action.c.

References BKE_pose_channel_find_name(), bPoseChannel::bone, Bone::childbase, CONSTRAINT_IK_AUTO, CONSTRAINT_TYPE_KINEMATIC, bPoseChannel::constraints, data, bConstraint::data, ListBase::first, Bone::name, Bone::next, bConstraint::next, Object::pose, and bConstraint::type.

Referenced by BKE_pose_channel_in_IK_chain().

pose_channels_remove_internal_links()

static void pose_channels_remove_internal_links ( Object *  ob, bPoseChannel *  unlinked_pchan  )

static

Definition at line 968 of file action.c.

References bPose::chanbase, LISTBASE_FOREACH, NULL, and Object::pose.

Referenced by BKE_pose_channels_remove().

set_active_action_group()

void set_active_action_group	(	bAction *	act,
		bActionGroup *	agrp,
		short	select
	)

Definition at line 350 of file action.c.

References AGRP_ACTIVE, ListBase::first, bActionGroup::flag, bAction::groups, bActionGroup::next, NULL, and select().

what_does_obaction()

void what_does_obaction	(	Object *	ob,
		Object *	workob,
		bPose *	pose,
		bAction *	act,
		char	groupname[],
		const AnimationEvalContext *	anim_eval_context
	)

Definition at line 1738 of file action.c.

References AnimData::action, Object::adt, ADT_RECALC_ANIM, animsys_evaluate_action_group(), BKE_action_group_find_name(), BKE_animdata_action_ensure_idroot(), BKE_animsys_evaluate_animdata(), BKE_object_workob_clear(), BKE_pose_channels_hash_make(), BKE_pose_update_constraint_flags(), BLI_strncpy(), bPose::chanbase, Object::constinv, Object::constraints, copy_m4_m4(), ListBase::first, bPose::flag, Object::id, ListBase::last, ID::name, NULL, Object::obmat, Object::par1, Object::par2, Object::par3, Object::parent, Object::parentinv, Object::parsubstr, Object::partype, Object::pose, POSE_CONSTRAINTS_NEED_UPDATE_FLAGS, RNA_id_pointer_create(), Object::rotmode, Object::trackflag, and Object::upflag.

Variable Documentation

IDType_ID_AC

IDTypeInfo IDType_ID_AC

Initial value:

= {
    .id_code = ID_AC,
    .id_filter = FILTER_ID_AC,
    .main_listbase_index = INDEX_ID_AC,
    .struct_size = sizeof(bAction),
    .name = "Action",
    .name_plural = "actions",
    .translation_context = BLT_I18NCONTEXT_ID_ACTION,
    .flags = IDTYPE_FLAGS_NO_ANIMDATA,
 
    .init_data = NULL,
    .copy_data = action_copy_data,
    .free_data = action_free_data,
    .make_local = NULL,
    .foreach_id = action_foreach_id,
    .foreach_cache = NULL,
    .owner_get = NULL,
 
    .blend_write = action_blend_write,
    .blend_read_data = action_blend_read_data,
    .blend_read_lib = action_blend_read_lib,
    .blend_read_expand = action_blend_read_expand,
 
    .blend_read_undo_preserve = NULL,
 
    .lib_override_apply_post = NULL,
}

Definition at line 290 of file action.c.

LOG

CLG_LogRef LOG = {"bke.action"}

static

Definition at line 76 of file action.c.

Referenced by BKE_pose_copy_result().