---

Animation.C

Go to the documentation of this file.

/***************************************************************************
 *cr                                                                       
 *cr            (C) Copyright 1995-2008 The Board of Trustees of the           
 *cr                        University of Illinois                       
 *cr                         All Rights Reserved                        
 *cr                                                                   
 ***************************************************************************/

/***************************************************************************
 * RCS INFORMATION:
 *
 *      $RCSfile: Animation.C,v $
 *      $Author: johns $        $Locker:  $             $State: Exp $
 *      $Revision: 1.51 $       $Date: 2008/03/27 19:36:34 $
 *
 ***************************************************************************
 * DESCRIPTION:
 *
 * The Animation class, which stores a list of pointers to Timestep objects
 * that contain 3D coordinates and other data that varies with time.
 *
 ***************************************************************************/

#include "Animation.h"
#include "VMDApp.h"
#include "CmdAnimate.h"
#include <stdio.h>

// strings describing animation styles
const char *animationStyleName[Animation::ANIM_TOTAL_STYLES] = {
        "Once", "Loop", "Rock" 
};
const char *animationDirName[Animation::ANIM_TOTAL_DIRS] = {
  "forward", "next", "reverse", "prev", "pause"
};

// constructor
Animation::Animation(VMDApp *app_) 
: UIObject(app_), mlist(*app->moleculeList) {

  lastTime = time_of_day();       // get the current time for determining speed
  speed(1.0);                         // set initial speed to maximum
  skip(1);                                // don't skip any frames yet
  anim_dir(ANIM_PAUSE);           // not yet animating
  anim_style(ANIM_LOOP);          // loop back to beginning when end reached
}

void Animation::goto_frame(int fr) {
    for (int i=0; i<mlist.num(); i++) {
        Molecule *m = mlist.molecule(i);
        if (m->active) {
            // XXX backward compatibility lameness
            int theframe = fr;
            if (fr == -1) theframe = 0;
            else if (fr == -2) theframe = m->numframes();
            m->override_current_frame(theframe);
            m->change_ts();
        }
    }
}

// update the animation list based on current mode; return if curr frame change
int Animation::check_event() {
    // if we're paused, do nothing
    if (animDir == ANIM_PAUSE) return 0;

    // other animation modes depend on the delay.  Check if a sufficient
    // delay has elapsed.
    double curTime = time_of_day();
    double dt = curTime - lastTime;
    if (dt <= (SPEED_FACTOR - Speed)) return 0;


    // time to update frames.  Cache the current time before proceeding.
    lastTime = curTime;
    int curframe = frame();
    int n = num();

    // nothing to do if there are fewer than two frames
    if (n < 2) return 0;

    // skip the current frame ahead the proper amount
    for (int i=0; i < frameSkip; i++) {
        if (animDir == ANIM_REVERSE || animDir == ANIM_REVERSE1) {
            if (curframe <= 0) {
                if (animStyle == ANIM_LOOP || animDir == ANIM_REVERSE1) {
                    curframe = n-1;
                } else if (animStyle == ANIM_ROCK) {
                    animDir = ANIM_FORWARD;
                } else if (animStyle == ANIM_ONCE) {
                    animDir = ANIM_PAUSE;
                }
            } else {
                --curframe;
            }

        } else if (animDir == ANIM_FORWARD || animDir == ANIM_FORWARD1) {
            if (curframe >= n-1) {
                if (animStyle == ANIM_LOOP || animDir == ANIM_FORWARD1) {
                    curframe = 0;
                } else if (animStyle == ANIM_ROCK) {
                    animDir = ANIM_REVERSE;
                } else if (animStyle == ANIM_ONCE) {
                    animDir = ANIM_PAUSE;
                }
            } else {
                ++curframe;
            }
        }
    }
    goto_frame(curframe);
    // we generated an event, so let other UIs know about it.
    runcommand(new CmdAnimNewFrame);

    // these two modes stop after one action
    if (animDir == ANIM_FORWARD1 || animDir == ANIM_REVERSE1)
        animDir = ANIM_PAUSE;
  
    return 1;
}

void Animation::skip(int newsk) { 
  frameSkip = ( newsk >= 1 ? newsk : 1);
}

float Animation::speed(float newsp)  {
  if (newsp < 0.0)
    Speed = 0.0;
  else if (newsp > 1.0)
    Speed = SPEED_FACTOR;
  else
    Speed = newsp*SPEED_FACTOR;

  return Speed;
}

void Animation::anim_style(AnimStyle as) 
{ 
  animStyle = as; 
}

---