Animation View: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
No edit summary
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Animation View''' is used to set up animations in ParaView. It's is accessible through '''View | Animation View'''. This article describes this view and how to use it to create simple animations.  
'''Animation View''' is used to set up animations in ParaView. It's is accessible through '''View | Animation View'''. This article describes this view and how to use it to create simple animations.  
The '''Animation View''' is intended to be a replacement for the '''Animation Inspector''' in ParaView 3.0. The '''Animation Inspector''' will be deprecated in future versions.


=User Interface=
=User Interface=


[[Image:AnimationViewGUI.png|400px|thumb|'''Figure 1''': Animation View]]


<table>
<tr>
<td valign="top">
Figure 1 shows the the animation view. It is a standard dockable widget. There are three major portions to this panel:
Figure 1 shows the the animation view. It is a standard dockable widget. There are three major portions to this panel:
* Scene Properties:
* Scene Properties:
Line 15: Line 14:
* Animate more Paramaters:
* Animate more Paramaters:
: Provides means to add animation tracks for other available parameters.
: Provides means to add animation tracks for other available parameters.
</td>
<td>[[Image:AnimationViewGUI.png|400px|thumb|'''Figure 1''': Animation View]]</td>
</tr>
</table>


=Animate Parameters=
<table>
<tr>
<td valign="top">
One of the simplest animation set up is where the user wants to change a parameter on a filter or source through the course of the animation. Consider the simplest case, we have a sphere source and we want to create an animation where the radius of the sphere goes from 0.1 to 1.


=Use Cases=
Say the sphere source we want to animate is called "Sphere1" in the pipeline browser. Now to add an animation track to animate the radius of this sphere, select the '''Sphere1''' in the ''Object'' combo-box and then select '''Radius''' in the ''Parameter'' combo-box. Then hit the [[Image:AddTrackButton.png]] to add the animation track for Sphere1's Radius. Once the track is added it will be shown in the '''Animated Parameters''' section. Now, we need to change the radius value to go from 0.1 to 1. So, simply double click on the track, the '''Animation Keyframes''' editor dialog will pop-up (Figure 2). ParaView tries to initialize new animation tracks with some default values, hence this track has been initialized to animate the raduis from 0 to 0.5. To change any parameter, simply double-click on any column and enter the new values.
We will now see a few use-cases which will illustrate the use of this panel and each of its components.


==Animate Parameters==
ParaView's animation engine is key-frame based. Hence one can add more than two keyframes, change the interpolation function for the value between two keyframes etc. using this dialog. Double-clicking on the '''Interpolation''' column will show the available interpolation functions for the given parameter type. Note that there's no interpolation function for the last key-frame since interpolation is defined between two keyframes.
[[Image:AnimationKeyFramesDialog.png|thumb|'''Figure 2''': Animation Keyframes editor dialog used to edit the keyframes and their properties for each animation track.]]


One of the simplest animation set up is where the user wants to change a parameter on a filter or source through the course of the animation. Consider the simplest case, we have a sphere source and we want to create an animation where the radius of the sphere goes from 0.1 to 1.
To remove an animation track, simply hit the [[Image:RemoveTrackButton.png]] next to that animation track.
</td>
<td>
[[Image:AnimationKeyFramesDialog.png|thumb|300px|'''Figure 2''': Animation Keyframes editor dialog used to edit the keyframes and their properties for each animation track.]]
</td>
</tr>
</table>
 
==Animate Opacity/Visibility==
 
Similar to animating any filter/source paramters, it is possible to animate the opacity or visibility of the object in all the views that it's shown. In the '''Parameter''' combo simply choose '''Opacity''' or '''Visibility''' when adding the animation track.
 
=Time in ParaView=
Before we delve any further into the world of animation, we need to understand time as ParaView implements it.
 
There are three types of times in ParaView:
* Animation Time:
** This is the time that changes as an animation is played.
** The VCR buttons in the toolbar, moving the time cursor on the animation view changes this animation time.
** The time-toolbar (Figure 3) shows the animation time.
<table><tr><td>[[Image:AnimationTimeToolbar.png|thumb|'''Figure 3''': Animation time toolbar and VCR control for playing animation.]]</td></tr></table>
 
* Reader Time:
** Certain file formats support associating time with datasets eg. exodus, XML VTK formats etc. This is referred to as a the reader time.
** The information tab shows the timesteps provided by any reader/data source (Figure 4).
** Note that when multiple sources provide time, ParaView assumes that they are all in the same time units.
<table><tr><td>[[Image:TimeInformationTab.png|thumb|'''Figure 4''': Information tab showing the time steps provided by a reader.]]</td></tr></table>
 
* Application (TimeKeeper) Time
** This refers to the application wide time. This is the time value that ParaView requests from the readers/sources for showing data in any of the views.
** By default, this is linked with the animation time i.e. it's same as the animation time. However that can be changed by using the '''TimeKeeper-Time''' animation track on the '''Animation View'''. Double click on the track to pop-up the key-frames editor dialog which allows for setting this to a constant time value (useful in making animations where the data time should not change) or add explicit keyframes (Figure 5).
<table><tr><td>[[Image:TimeKeyFrames.png|thumb|'''Figure 5''': Key-frame editor for the '''TimeKeeper - Time''' animation track]]</td></tr></table>
 
=Play Modes=
ParaView has three animation play-back modes. The mode as well as the parameters for each mode can be set in the ''scene properties'' section of '''Animation View''' (Figure 1).
* Sequence
: In this mode the animation is played as a sequence of frames evenly spaced in the specified ''Start Time'' and ''End Time'' for the animation. The ''No. Frames'' controls the number of frames in the animation. During playback, the animation time goes from ''Start Time'' to ''End Time'' incremented by (end time-start time)/(no. of frames) for every consecutive frame.


Say the sphere source we want to animate is called "Sphere1" in the pipeline browser. Now to add an animation track to animate the radius of this sphere, select the '''Sphere1''' in the ''Object'' combo-box and then select '''Radius''' in the ''Parameter'' combo-box. Then hit the [[Image:AddTrackButton.png]] to add the animation track for Sphere1's Radius. Once the track is added it will be shown in the '''Animated Parameters''' section. Now, we need to change the radius value to go from 0.1 to 1. So, simply double click on the track, the '''Animation Keyframes''' editor dialog will pop-up (Figure 2). ParaView tries to initialize new animation tracks with some default values, hence this track has been initialized to animate the raduis from 0 to 0.5. To change any parameter, simply double-click on any column and enter the new values.
:[[Image:SequenceMode.png|500px]]


* Real Time
: In this mode the animation is played for the specified ''Duration'' in seconds (approx.). The animation time increases from ''Start Time'' to ''End Time''. The number of frames actually rendered depends on how long each frame takes to render since the entire animation has to be done within the specified duration.


:[[Image:RealTimeMode.png|500px]]


ParaView's animation engine is key-frame based. Hence one can add more than two keyframes, change the interpolation function for the value between two keyframes etc. using this dialog.
* Snap To TimeSteps
: This mode is useful when a file with data at different timesteps is opened. When in this mode, the animation time increases from ''Start Time'' to ''End Time'' producing exactly as many frames at the number of timesteps, with each frame corresponding to a timestep. One can think of this mode as going through the time-steps in a sequence.
:[[Image:SnapToTimeSteps.png|500px]]


=Animate Data Timesteps=
When a dataset with timesteps is loaded, ParaView detects it, updates the start and end times for the animation scene to match those provided by the reader and then switches the play mode to ''Snap To TimeSteps''. Thus, there's no explicit setup that the user needs to do to cycle through the timesteps; simply hit play and ParaView will run through the time steps.


{{ParaView/Template/Footer}}
{{ParaView/Template/Footer}}

Latest revision as of 03:06, 8 May 2009

Animation View is used to set up animations in ParaView. It's is accessible through View | Animation View. This article describes this view and how to use it to create simple animations.

User Interface

Figure 1 shows the the animation view. It is a standard dockable widget. There are three major portions to this panel:

  • Scene Properties:
Show/Edit properties associated with the scene which affect the playback/saving animation.
  • Animated Parameters:
Shows the animation tracks for each of the filter/source/camera paramters being animated in this setup.
  • Animate more Paramaters:
Provides means to add animation tracks for other available parameters.
Figure 1: Animation View

Animate Parameters

One of the simplest animation set up is where the user wants to change a parameter on a filter or source through the course of the animation. Consider the simplest case, we have a sphere source and we want to create an animation where the radius of the sphere goes from 0.1 to 1.

Say the sphere source we want to animate is called "Sphere1" in the pipeline browser. Now to add an animation track to animate the radius of this sphere, select the Sphere1 in the Object combo-box and then select Radius in the Parameter combo-box. Then hit the AddTrackButton.png to add the animation track for Sphere1's Radius. Once the track is added it will be shown in the Animated Parameters section. Now, we need to change the radius value to go from 0.1 to 1. So, simply double click on the track, the Animation Keyframes editor dialog will pop-up (Figure 2). ParaView tries to initialize new animation tracks with some default values, hence this track has been initialized to animate the raduis from 0 to 0.5. To change any parameter, simply double-click on any column and enter the new values.

ParaView's animation engine is key-frame based. Hence one can add more than two keyframes, change the interpolation function for the value between two keyframes etc. using this dialog. Double-clicking on the Interpolation column will show the available interpolation functions for the given parameter type. Note that there's no interpolation function for the last key-frame since interpolation is defined between two keyframes.

To remove an animation track, simply hit the RemoveTrackButton.png next to that animation track.

Figure 2: Animation Keyframes editor dialog used to edit the keyframes and their properties for each animation track.

Animate Opacity/Visibility

Similar to animating any filter/source paramters, it is possible to animate the opacity or visibility of the object in all the views that it's shown. In the Parameter combo simply choose Opacity or Visibility when adding the animation track.

Time in ParaView

Before we delve any further into the world of animation, we need to understand time as ParaView implements it.

There are three types of times in ParaView:

  • Animation Time:
    • This is the time that changes as an animation is played.
    • The VCR buttons in the toolbar, moving the time cursor on the animation view changes this animation time.
    • The time-toolbar (Figure 3) shows the animation time.
Figure 3: Animation time toolbar and VCR control for playing animation.
  • Reader Time:
    • Certain file formats support associating time with datasets eg. exodus, XML VTK formats etc. This is referred to as a the reader time.
    • The information tab shows the timesteps provided by any reader/data source (Figure 4).
    • Note that when multiple sources provide time, ParaView assumes that they are all in the same time units.
Figure 4: Information tab showing the time steps provided by a reader.
  • Application (TimeKeeper) Time
    • This refers to the application wide time. This is the time value that ParaView requests from the readers/sources for showing data in any of the views.
    • By default, this is linked with the animation time i.e. it's same as the animation time. However that can be changed by using the TimeKeeper-Time animation track on the Animation View. Double click on the track to pop-up the key-frames editor dialog which allows for setting this to a constant time value (useful in making animations where the data time should not change) or add explicit keyframes (Figure 5).
Figure 5: Key-frame editor for the TimeKeeper - Time animation track

Play Modes

ParaView has three animation play-back modes. The mode as well as the parameters for each mode can be set in the scene properties section of Animation View (Figure 1).

  • Sequence
In this mode the animation is played as a sequence of frames evenly spaced in the specified Start Time and End Time for the animation. The No. Frames controls the number of frames in the animation. During playback, the animation time goes from Start Time to End Time incremented by (end time-start time)/(no. of frames) for every consecutive frame.
SequenceMode.png
  • Real Time
In this mode the animation is played for the specified Duration in seconds (approx.). The animation time increases from Start Time to End Time. The number of frames actually rendered depends on how long each frame takes to render since the entire animation has to be done within the specified duration.
RealTimeMode.png
  • Snap To TimeSteps
This mode is useful when a file with data at different timesteps is opened. When in this mode, the animation time increases from Start Time to End Time producing exactly as many frames at the number of timesteps, with each frame corresponding to a timestep. One can think of this mode as going through the time-steps in a sequence.
SnapToTimeSteps.png

Animate Data Timesteps

When a dataset with timesteps is loaded, ParaView detects it, updates the start and end times for the animation scene to match those provided by the reader and then switches the play mode to Snap To TimeSteps. Thus, there's no explicit setup that the user needs to do to cycle through the timesteps; simply hit play and ParaView will run through the time steps.



ParaView: [Welcome | Site Map]