impeller::scene::AnimationPlayer Class Reference

#include <animation_player.h>

Public Member Functions
	AnimationPlayer ()
	~AnimationPlayer ()
	AnimationPlayer (AnimationPlayer &&)
AnimationPlayer &	operator= (AnimationPlayer &&)
AnimationClip *	AddAnimation (const std::shared_ptr< Animation > &animation, Node *bind_target)
AnimationClip *	GetClip (const std::string &name) const
void	Update ()
	Advanced all clips and updates animated properties in the scene. More...

Detailed Description

Definition at line 20 of file animation_player.h.

Constructor & Destructor Documentation

AnimationPlayer() [1/2]

impeller::scene::AnimationPlayer::AnimationPlayer ( )

default

~AnimationPlayer()

impeller::scene::AnimationPlayer::~AnimationPlayer ( )

default

AnimationPlayer() [2/2]

impeller::scene::AnimationPlayer::AnimationPlayer ( AnimationPlayer &&  )

default

Member Function Documentation

AddAnimation()

AnimationClip * impeller::scene::AnimationPlayer::AddAnimation	(	const std::shared_ptr< Animation > &	animation,
		Node *	bind_target
	)

Definition at line 23 of file animation_player.cc.

                       {
  if (!animation) {
    VALIDATION_LOG << "Cannot add null animation.";
    return nullptr;
  }
 
  AnimationClip clip(animation, bind_target);
 
  // Record all of the unique default transforms that this AnimationClip
  // will mutate.
  for (const auto& binding : clip.bindings_) {
    auto decomp = binding.node->GetLocalTransform().Decompose();
    if (!decomp.has_value()) {
      continue;
    }
    target_transforms_.insert(
        {binding.node, AnimationTransforms{.bind_pose = decomp.value()}});
  }
 
  auto result = clips_.insert({animation->GetName(), std::move(clip)});
  return &result.first->second;
}

GetClip()

AnimationClip * impeller::scene::AnimationPlayer::GetClip

(

const std::string &

name

)

const

Definition at line 48 of file animation_player.cc.

                                                                   {
  auto result = clips_.find(name);
  if (result == clips_.end()) {
    return nullptr;
  }
  return const_cast<AnimationClip*>(&result->second);
}

operator=()

AnimationPlayer & impeller::scene::AnimationPlayer::operator= ( AnimationPlayer &&  )

default

Update()

void impeller::scene::AnimationPlayer::Update

(

)

Advanced all clips and updates animated properties in the scene.

Definition at line 56 of file animation_player.cc.

                             {
  if (!previous_time_.has_value()) {
    previous_time_ = Clock::now();
  }
  auto new_time = Clock::now();
  auto delta_time = new_time - previous_time_.value();
  previous_time_ = new_time;
 
  // Reset the animated pose state.
  for (auto& [node, transforms] : target_transforms_) {
    transforms.animated_pose = transforms.bind_pose;
  }
 
  // Compute a weight multiplier for normalizing the animation.
  Scalar total_weight = 0;
  for (auto& [_, clip] : clips_) {
    total_weight += clip.GetWeight();
  }
  Scalar weight_multiplier = total_weight > 1 ? 1 / total_weight : 1;
 
  // Update and apply all clips to the animation pose state.
  for (auto& [_, clip] : clips_) {
    clip.Advance(delta_time);
    clip.ApplyToBindings(target_transforms_, weight_multiplier);
  }
 
  // Apply the animated pose to the bound joints.
  for (auto& [node, transforms] : target_transforms_) {
    node->SetLocalTransform(Matrix(transforms.animated_pose));
  }
}

---

The documentation for this class was generated from the following files:

• impeller/scene/animation/animation_player.h
• impeller/scene/animation/animation_player.cc