/usr/include/avogadro/animation.h is in libavogadro-dev 1.2.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | /**********************************************************************
Animation - Basic animation interface
Copyright (c) 2009 Tim Vandermeersch
Copyright (c) 2009 Geoff Hutchison
Copyright (c) 2009 Marcus D. Hanwell
This file is part of the Avogadro molecular editor project.
For more information, see <http://avogadro.cc/>
Some code is based on Open Babel
For more information, see <http://openbabel.sourceforge.net/>
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 version 2 of the License.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
***********************************************************************/
#ifndef ANIMATION_H
#define ANIMATION_H
#include "config.h"
#include "global.h"
#include <QObject>
#include <Eigen/Core>
#include <vector>
class QTimeLine;
namespace Avogadro {
class Molecule;
/**
* @class Animation animation.h <avogadro/animation.h>
* @brief Simple frame-based animation for Molecule primitives
* @author Geoffrey R. Hutchison
*
* The animation class supports simple frame-based animations for molecules.
* It can handle trajectories, vibrations, geometry optimizations and many other common
* molecular animations.
*
* It assumes constant atom lists throughout. If you want more complicated animations,
* you can accomplish this using your own Extension.
*
* An Animation object works by changing conformers inside a Molecule. Consequently,
* you can either read in the conformers from a file, or call Animation::setFrames()
* to set the coordinates for the animation. The latter works well for generated coordinates,
* for example, vibrations.
*/
class AnimationPrivate;
class A_EXPORT Animation : public QObject
{
Q_OBJECT
public:
/**
* Constructor.
*
* @param parent The object parent. Should be the widget viewing the
* animation or a child of that widget (e.g., an Extension).
*/
Animation(QObject *parent=0);
/**
* Deconstructor.
*/
virtual ~Animation();
/**
* Set the molecule to animate.
*/
void setMolecule(Molecule *molecule);
/**
* Set the frames for the animation. By default, the conformers in the
* molecule are used as animation frames. However, for trajectory files
* that don't contain any topology, it is needed to read in the the
* molecule topology before the trajectory. The trajectory frames can
* be used to call setFrames() later.
*/
void setFrames(std::vector< std::vector< Eigen::Vector3d> *> frames);
/**
* @return The number of frames per second.
*/
int fps() const;
/**
* @return The loopCount (0 = repeat forever).
*/
int loopCount() const;
/**
* @return The total number of frames in the animation.
*/
int numFrames() const;
/**
* @return True if dynamic bond detection is enabled.
*/
bool dynamicBonds() const;
Q_SIGNALS:
/**
* This signal is emitted when the current frame is changed (i.e. setFrame() called)
*/
void frameChanged(int);
public Q_SLOTS:
/**
* Set the number of frames per second.
*/
void setFps(int fps);
/**
* Set the loop count. (0 = repeat forever)
*/
void setLoopCount(int loops);
/**
* Set the current frame.
*/
void setFrame(int i);
/**
* Enable/disable dynamic bond detection. For QM reactions for example.
*/
void setDynamicBonds(bool enable);
/**
* Start the animation (at current frame).
*/
void start();
/**
* Pause the animation.
*/
void pause();
/**
* Stop the animation (and return to first frame).
*/
void stop();
private:
AnimationPrivate * const d;
Molecule *m_molecule;
QTimeLine *m_timeLine;
std::vector< std::vector< Eigen::Vector3d> *> m_originalConformers;
std::vector< std::vector< Eigen::Vector3d> *> m_frames;
};
} // end namespace Avogadro
#endif
|