source: orxonox.OLD/trunk/src/util/animation/animation_player.cc @ 9869

/*
   orxonox - the future of 3D-vertical-scrollers

   Copyright (C) 2004 orx

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   ### File Specific:
   main-programmer: Benjamin Grauer
   co-programmer: ...
*/

#define DEBUG_SPECIAL_MODULE DEBUG_MODULE_ANIM

#include "animation_player.h"

#include "compiler.h"



ObjectListDefinition(AnimationPlayer);
/**
 *  standard constructor
*/
AnimationPlayer::AnimationPlayer ()
{
  this->registerObject(this, AnimationPlayer::_objectList);
  this->setName("AnimationPlayer");

  this->play();
}

/**
 *  the singleton reference to this class
*/
AnimationPlayer* AnimationPlayer::singletonRef = NULL;

/**
 *  standard deconstructor

   !! DANGER !! when unloading the AnimationPlayer no other Function
   should reference any Animations, from the animationList because it
   automatically deletes them.
   This usually happens when unloading a World.
*/
AnimationPlayer::~AnimationPlayer ()
{
  // deleting the Animation List AND all the elements of the List
  this->flush();

  AnimationPlayer::singletonRef = NULL;
}

/**
 *  adds an Animation to the AnimationList.
 * @param animation the Animation to handle

   when adding a Animation the Animation will too be deleted when
   the AnimationPlayer gets deleted. Consider not adding it, or
   unadding it with animation->notHandled();
*/
void AnimationPlayer::addAnimation(Animation* animation)
{
  this->animationList.push_back(animation);
}

/**
 *  removes an Animation from the Animation List, WITHOUT deleting it.
 * @param animation the Anmination to remove from the List
*/
void AnimationPlayer::removeAnimation(Animation* animation)
{
  this->animationList.remove(animation);
}

/**
 *  empties the list AND deletes all the Animations
*/
void AnimationPlayer::flush()
{
  // deleting the Animation List AND all the elements of the List
  while(this->animationList.size() > 0)
  {
    Animation* anim = this->animationList.front();
    this->animationList.pop_front();
    delete anim;
  }
}

/**
 *  Ticks all the animations in animationList
 * @param timePassed the time passed since the last tick.
 */
void AnimationPlayer::tick(float timePassed)
{
  if (this->bRunning)
  {
      // iterate through all the animations and tick them.
    std::list<Animation*>::iterator anim;
    for (anim = this->animationList.begin(); anim != this->animationList.end(); anim++)
    {
      (*anim)->tick(timePassed);
      if(unlikely((*anim)->ifDelete()))
      {
        this->animationList.remove(*anim);
        delete *anim;
      }
    }
  }
}
/**
 *  starts playing the AnimationPlayer
 */
void AnimationPlayer::play()
{
  this->bRunning = true;
}

/**
 *  pauses playing of the AnimationPlayer
 */
void AnimationPlayer::pause()
{
  this->bRunning = false;
}

/**
 * @returns the animation from a certain baseobject
   if multiple are found, it just retruns the first one
   if none is found it returns NULL
*/
Animation* AnimationPlayer::getAnimationFromBaseObject(const BaseObject* baseObject) const
{
  std::list<Animation*>::const_iterator anim;
  for (anim = this->animationList.begin(); anim != this->animationList.end(); anim++)
    if((*anim)->getBaseObject() == baseObject)
      return *anim;
  return NULL;
}



/**
 *  Outputs some nice debug-information
*/
void AnimationPlayer::debug()
{
  PRINT(0)("+------------------------------------+\n");
  PRINT(0)("+ ANIMATION PLAYER DEBUG INFORMATION +\n");
  PRINT(0)("+------------------------------------+\n");
  PRINT(0)("| Reference: %p\n", this);
  PRINT(0)("| CountOfAnims %d\n", this->animationList.size());
  PRINT(0)("-Animation Information---------------+\n");
  // Per ANIMATION DEBUG
  std::list<Animation*>::iterator anim;
  for (anim = this->animationList.begin(); anim != this->animationList.end(); anim++)
    {
      //      anim->debug();
    }
  PRINT(0)("+--------------------------------AP--+\n");
}