第04章-VTK基础（7）

【译者：这个系列教程是以Kitware公司出版的《VTK User’s Guide -11th edition》一书作的中文翻译（出版时间2010年。ISBN: 978-1-930934-23-8）。因为时间关系，我们不能保证每周都能更新本书内容，但尽量做到一周更新一篇到两篇内容。敬请期待^_^。欢迎转载，另请转载时注明本文出处，谢谢合作！

同一时候。因为译者水平有限，出错之处在所难免，欢迎指出订正！

】

【本小节内容相应原书的第83页至第87页】

4.16 动画

动画是可视化等系统的重要模块。
通过编写改动某个Filter和渲染器Render參数的循环，能够实现简单的动画效果。可是一旦有多个參数须要改动时。这样的方法就会变得比較复杂。
VTK提供了一个由vtkAnimationCue和vtkAnimationScene等类所组成的框架，支持动画场景的创建和回放。
vtkAnimationCue相应一个可随时间改变的实体，比方Actor的空间位置；vtkAnimationScene则表示一个场景或者由vtkAnimationCue实例所组成的动画场景。

动画场景（vtkAnimationScene）

vtkAnimationScene表示一个场景或者是动画场景的建立。动画场景通常是通过渲染一系列的帧，在渲染每一帧时改变某些可视化參数来建立的。所渲染的每一帧都关联一个动画时间，这个时间用来确定动画中每一帧的位置。基于不同的播放模式，动画时间在动画播放过程中是一个计数不断添加的简单变量。

下面列出了类vtkAnimationScene中一些比較重要的方法：

SetStartTime()/SetEndTime()

设置动画场景的開始和结束时间。也是动画回放时的时间范围。

SetPlayMode()

用于控制动画回放的模式，也就是动画时间是怎样改变的。有两种模式能够设置。

SequenceMode (PLAYMODE_SEQUENCE)

这样的模式下，每帧的动画时间添加(1/frame-rate)的间隔。直至达到所设置的EndTime。因此。所渲染的总帧数是固定的，与渲染每一帧时所用的时间的长短无关。

RealTimeMode (PLAYMODE_REALTIME)

这样的模式下，整个动画的执行时间大约是(EndTime-StartTime)秒，当中第n帧的执行时间是：第(n-1)帧的执行时间+渲染第(n-1)帧所用的时间。因此。所渲染的总帧数随着渲染每一帧所用时间的不同而不同。

SetFrameRate()

帧率是指单位时间内渲染的帧数。主要用于Sequence模式。

AddCue(),RemoveCue(), RemoveAllCue()

加入vtkAnimationCue实例到场景中或者从场景中移除vtkAnimationCue实例。

SetAnimationTime()

指定某一帧的动画时间。

GetAnimationTime()

动画回放时。获取动画的时钟时间。

Play()

開始播放动画。

SetLoop()

假设设置为true。则调用Play()方法后将进入动画循环。

AnimationCue (vtkAnimationCue)

vtkAnimationCue相应动画场景中随时间改变的实体。vtkAnimationCue实例本身并不知道与动画相关的參数是假设改变的。

因此，用户必须从vtkAnimationCue中派生出子类或者使用观察者模式监听事件。来改变动画过程中须要改变的參数。

动画场景中的Cue实体都有一个開始时间（start-time）和结束时间（end-time）。动画回放时，当场景的动画时间是处于所指定的開始时间与结束时间的范围内时，Cue实体就会被激活。Cue实体一旦激活后，它本身会发出vtkCommand::StartAnimationCueEvent事件。而对于动画系列中的每一帧。则发出vtkCommand::AnimationCueTickEvent事件，当动画时间递增至Cue实体的结束时间时，会发出vtkCommand::EndAnimationCueEvent事件。下面是vtkAnimationCue类中一些比較重要的方法：

SetTimeMode

TimeMode定义了Cue实体的起始时间和结束时间是怎样指定的，有两种模式可选。

Relative (TIMEMODE_RELATIVE)

这样的模式下，动画场景中的Cue实体的时间是相对动画场景的開始时间来指定的。

Normalized (TIMEMODE_NORMALIZED)

这样的模式下，Cue实体的開始时间和结束时间的取值范围为[0,1]，当中0相应动画场景的開始。1相应结束。

SetStartTime/SetEndTime

这两个方法主要是当Cue实体被激活时，标识动画时间的范围。

当TimeMode取值为TIMEMODE_RELATIVE时。与动画场景的起始和结束时间有同样的单位。当TimeMode取值为TIMEMODE_NORMALIZED时。Cue实体的開始时间和结束时间的取值范围为[0,1]，当中0相应动画场景的開始，1相应结束。

GetAnimationTime()

用于vtkCommand::AnimationCueTickEvent事件的处理。

处理事件时。可用来确定动画场景中的当前帧。其值依赖于TimeMode。假设TimeMode取值为TIMEMODE_RELATIVE时，其值是Cue实体激活后的时间单位的倍数；TimeMode取值为TIMEMODE_NORMALIZED时。Cue实体的開始时间和结束时间的取值范围为[0,1]，当中0相应动画场景的開始，1相应结束。

GetClockTime()

该方法与vtkAnimationScene::GetAnimationTime()中的动画时钟时间相似。

仅仅有当处理vtkCommand::AnimationCueTickEvent事件时才有效。

TickInternal (double currenttime, doubledeltatime, double clocktime)

正如前面所提的。我们能够派生一个vtkAnimationCue子类来取代编写处理动画事件的函数。子类派生时，须要重载该函数。当中该函数的參数分别相应GetAnimationTime()，GetDeltaTime()和GetClockTime()的返回值。

StartCueInternal(), EndCueInternal()

这两个方法可在子类中重载。主要做一些创建、清除等工作以及动画回放时控制Cue实体的開始和结束。用户也能够加入事件观察者，通过监听vtkCommand::StartAnimationCueEvent和vtkCommand::EndAnimationCueEvent事件来实现相似的功能。

下面的演示样例中，我们创建了一个简单的动画：vtkSphereSource的StartTheta随着动画时间而改变。

演示样例中的Cue实体使用Normalized时间模式，因此，能够通过改变场景时间或者Cue实体的时间来改变StartTheta的值。

class vtkCustomAnimationCue : public vtkAnimationCue

{

public:

       static vtkCustomAnimationCue* New();

       vtkTypeRevisionMacro (vtkCustomAnimationCue,vtkAnimationCue);

       vtkRenderWindow *RenWin;

       vtkSphereSource *Sphere;

protected:

       vtkCustomAnimationCue()

       {

              this->RenWin = 0;

              this->Sphere = 0;

       }

       // Overridden to adjust the sphere'sradius depending on the frame we

       // are rendering. In this animation wewant to change the StartTheta

       // of the sphere from 0 to 180 over thelength of the cue.

       virtual void TickInternal(doublecurrenttime, double deltatime, double clocktime)

       {

              double new_st = currenttime * 180;

              // since the cue is in normalizedmode, the currenttime will be in the

              // range[0,1], where 0 is start ofthe cue and 1 is end of the cue.

              this->Sphere->SetStartTheta(new_st);

              this->RenWin->Render();

       }

};

vtkStandardNewMacro(vtkCustomAnimationCue);

vtkCxxRevisionMacro(vtkCustomAnimationCue,"$Revision$");

int main(int argc, char *argv[])

{

       // Create the graphics sturctures. Therenderer renders into the

       // render window.

       vtkRenderer *ren1 = vtkRenderer::New();

       vtkRenderWindow *renWin =vtkRenderWindow::New();

       renWin->SetMultiSamples(0);

       renWin->AddRenderer(ren1);

       vtkSphereSource *sphere =vtkSphereSource::New();

       vtkPolyDataMapper *mapper =vtkPolyDataMapper::New();

       mapper->SetInputConnection(sphere->GetOutputPort());

       vtkActor *actor = vtkActor::New();

       actor->SetMapper(mapper);

       ren1->AddActor(actor);

       ren1->ResetCamera();

       renWin->Render();

       //Create an Animation Scene

       vtkAnimationScene *scene =vtkAnimationScene::New();

       scene->SetModeToSequence();

       scene->SetFrameRate(30);

       scene->SetStartTime(0);

       scene->SetEndTime(60);

       // Create an Animation Cue to animate thecamera.

       vtkCustomAnimationCue *cue1 =vtkCustomAnimationCue::New();

       cue1->Sphere = sphere;

       cue1->RenWin = renWin;

       cue1->SetTimeModeToNormalized();

       cue1->SetStartTime(0);

       cue1->SetEndTime(1.0);

       scene->AddCue(cue1);

       scene->Play();

       scene->Stop();

       ren1->Delete();

       renWin->Delete();

       scene->Delete();

       cue1->Delete();

       return 0;

}

【第4章-VTK基础所有翻译完毕】