View source for ParaView:AnimationTutorial

<font color="red">'''OBSOLETE: This refers to ParaView 2.* and is not applicable for ParaView 3+.'''</font>

The '''Parameters''' tab on the property sheet for any source or sphere shows the parameters of the source/filter than can changed. The '''Display''' tab shows properties that affect the [http://www.essaywriters.net writing online] rendering of the data. In ParaView, an animation can be created by changing some of these parameters or display properties for the sources/filters over time. Thus, creation/deletion of sources/filters cannot be included in an animation.

=The Interface=

[[Image:AnimationInterface.jpg|Keyframe Animation Interface.|400px]]

The '''Keyframe Animation Interface''' has two panels: the '''Animation Panel''' shown on the left panel and the '''Track Editor''' shown on the bottom panel. Selecting '''View | Keyframe Animation''' shows the '''Animation Panel''', while selecting '''Window | Show Bottom Panel''' shows the '''Track Editor'''. All animation settings can be adjusted using the '''Animation Panel''' alone. The '''Track Editor''' provides an interface to easily create/delete/adjust individual keyframes; however, all this can also be done using the '''Animation Panel'''.

==Animation Panel==

[[Image:AnimationPanel.jpg|Animation Panel|200px]]

===Animation Control===
The '''Animation Control''' can be used to control running of the animation. 


[[Image:VCRControl.jpg|VCR Control|200px]]

The VCR-like buttons in the control can be used to play/stop the animation or change the current time. 
* : Go to the beginning of the animation.
* : Go to the previous frame in the animation.
* : Play the animation.
* : Stop playing the animation.
* : Go to the next frame in the animation.
* : Go to the last frame in the animation.
* : When pressed, the animation is played in a loop.
* : Record an animation.
* : Record current state for animation.
* : Save animation as a movie/images.

The current time can also be changed by using the '''Current Time''' slider. 

The animation can be played in two modes: '''Sequence''' mode and '''Real Time''' mode. The mode can be changed by selecting the appropriate mode in the '''Play Mode''' selection list. In '''Sequence''' mode, the animation is played as a sequence of images(or frames) generated one after the other rendered in immediate succession. The number of frames is controlled by the '''Duration''' entry. Note that the frames are rendered as fast as possible. Thus the viewing frame rate depends on the time needed to generate and render each frame. In '''Real Time''' mode, the '''Duration''' entry indicates the time in seconds for which the animation should be run. Each frame is rendered using the current wallclock time in seconds relative to the start time. The animation runs for exactly ''duration'' seconds. The number of frame actually generated/rendered in turn depends on the time for to generate/render each frame.

===Tracks===

The animation sequence for every source (or filter) and all the properties of the source that can be animated are called '''Tracks'''. The user creates keyframes in a track for a particular property of a given source. The values of the keyframes (and the keyframe interpolation type) control how the property value is modified over time, when the animation is played. The '''Tracks''' widget provides a means to select a particular track for editing. Tracks can also be edited using the '''Track Editor''' (discussed later).

All created sources (or filters) are listed in the '''Source''' menu. Once a source (or filter) is choosen, all the available properties of the selected source (or filter) that can be animated are listed in the '''Property''' menu. Both '''Source''' and '''Property''' must be selected to edit the keyframes. [http://www.bestessayhelp.com/essay-help/buy-essay buy essay]


===Active Key Frame Properties===

This frame shows the properties of the selected (or active) key frame in the choosen '''Track'''. If the track has no keyframes added to it, we see a GUI as under.

[[Image:ActiveKF1.jpg|Active Key Frame Properties with no keyframe in track|200px]]

The '''Add KeyFrame''' '''Delete KeyFrame''' buttons can be used to add and delete active keyframe from the track. When the '''Add KeyFrame''' button is pressed on track with no keyframes, two keyframes are added. The first keyframe is called the ''anchor''. The '''Anchor''' cannot be moved, it has to be at time 0, and cannot be deleted unless it's the only keyframe on the track. 

Following figure shows a track with 3 key frames.

[[Image:ActiveKF2.jpg|Active Key Frame Properties with 3 keyframes in track|200px]]

The different keyframe on the track can be selected using the '''Index''' slider. '''Time''' entry is used to change the time at which the key frame takes effect. The '''Interpolation''' control how the value is interpolated once the key frame take ''effect'' (i.e. current time >= key time) until the immediately following keyframe takes effect. Consequently, interpolation for the last keyframe has no effect and is disabled. The '''Value''' widget depends on the type of the property being animated by the current track. '''Min''' and/or '''Max''' buttons become available next to the '''Value''' widget if the property being animated has min and/or max bounds. [http://www.bestessayhelp.com essay help]

===Animation Settings===

[[Image:AnimationSettings.jpg|Animation Settings|200px]]

'''Cache Geometry''' check enables/disables if caching is to be used while playing the animation. Note that caching has any effect only when playing in '''Sequence''' mode. When enabled, the geometry is cached and used whenever available which playing the animation.

'''Record All properties''' controls when recording an animation (explained later), if all property changes are recorded or only those in the property controlled by the '''Current Track'''.

'''Show all animatable properties''': to minimize the tracks shown in the track editor, when this check is off, a small subset of the tracks are visible in the '''Track Editor'''. When enabled, tracks for all animatable properties are shown. As of 2.2, this does not affect the source/properties shown in '''Source''' '''Property''' menus, only the tracks shown in the '''Track Editor'''.

==Track Editor==

[[Image:AnimationTracks1.jpg|The Track Editor|500px]]

The '''Track Editor''' provides a GUI to edit/adjust keyframe in tracks. The tree on the leff-hand side of the '''Track Editor''' lists the name of the source/filter or its property which the track adjacent to it animates. Thus the track adjacent to ''Sphere1 | Radius'' is track for animating raduis of source with name Sphere1.

To animate a property, first locate the property by expanding/collapsing the tree. Once the appropriate property is located, simply left-click on the track adjacent to it. A key frame will be added at that location. If this is the first keyframe in the track, an '''anchor''' keyframe may also get added. A keyframe is shown as a bubble on the tracks. A key frame can be selected by clicking on the bubble. The selected keyframe's properties are shown in the '''Active Key Frame Properties''' frame on the '''Animation Panel'''. The keyframe time (i.e. the time at which the keyframe takes effect) can be changed by clicking and dragging the keyframe horizontally. To delete a keyframe, click-and-drag is outside the horizontal interface. Note that the '''anchor''' keyframe can be deleted only if it is the only key frame in the track.

All tracks adjacent to leaf labels in the tree represent animatable property tracks to which keyframes can be added. The tracks adjacnet to non-leaf labels are used for grouping the tracks for all its children. No key frames can be added to such tracks. However anchor tags get added to such tracks when keyframes are added to any of its children. When the anchor tracks are moved, the key times of for the keyframes of all its children are scaled to match the anchor tags.

The widget at the top of the tracks, adjacent to the label '''Animation Tracks''' can be used for horizontal-zooming of the tracks. Move the ends of the widget to change the zoom and move the widget horizontally to adjust the visible section of the tracks.

The '''Track Editor''' also provides a quick way of changing the current time. Simple right-click (or right-click-and-drag) in the tracks. A vertical current time marker will appear. The current time will be updated when the mouse button is released.

=Tutorials=

Each example assumes that you begin with a fresh paraview (i.e. newly started paraview), otherwise, the source names etc may be different.

==Animating a dataset with timesteps==

# Start ParaView.
# Select '''File''' | '''Open Data'''. '''Open ParaView File''' dialog will pop-up in which you can choose the dataset to load. Open '''multicomb_0.vts''' from the sample datasets provided. 
# The dataset information will be loaded and the '''Accept''' button will get green. We choose the default options, hence, just click '''Accept''', and the dataset will to loaded. The '''Selection Window''' shows the loaded dataset as a source with label '''multicomb_0.vts'''.
# Select '''Filter''' | '''Contour''' to create a contour filter. Hit '''Accept''', and the filter will be applied with a single iso-surface at 
# Enable the '''Animation Toolbar''', if not already visible from '''Window''' | '''Toolbars''' | '''Animation'''.
# Once the '''Animation Toolbar''' is made visible, it will appear under the '''3D View''' window.
# Click '''Window''' | '''Show Botton Panel''' (or F6) and the '''Animation Tracks''' window will be visible. You'll notice that there are already some animation keyframes added.
# Click on the '''+''' adjacent to '''multicomb_0.vts''' to open the tracks for the dataset source. ParaView added keyframes automatically when a dataset with timesteps is loaded to animate over the dataset with changing time. It also changes the duration of the animation to match the number of timesteps in the dataset, so that when playing in '''Sequence''' mode, each frame will show a new timestep in the dataset. The '''multicomb''' dataset has 3 timesteps. Select '''View''' | '''Keyframe Animation''' to open up the '''Animation Panel''' and verify that the '''Animation Control''' shows the duration to be ''2''.
# Change '''Current Time''' to 1 (or hit '''Go to next Frame''' button on the VCR control).
# You'll see the outline for the data at timestep 1.
# Use the VCR control to play the animation.
# Click on the keyframes in the '''multicomb_0.vts''' | '''FileName''' track to see the properties of the keyframes. Notice that the value for the keyframes is shown as a selection list with the filenames for each timestep.

==Using ''Record Animation'' to animate contours==

# Follow the steps 1-5 from '''Animating a dataset with timesteps'''.
# Hide the '''Animation Tracks''', if they are visible.
# Select '''Edit''' | '''Delete All Keyframes'''. If a confirmation dialog appears, select '''yes'''. This will remove the default animation added when the dataset was loaded i.e. it will remove all the keyframes currently in the animation.
# Hit the '''Start/Stop Recording''' button on the '''Animation Toolbar'''. This begins the recording. ParaView starts monitoring the changes that you make to the source/filter properties. All the ''accepted'' changes will get ''keyframed'' on clicking '''Record a frame''' button.
# Select '''Select'''|'''Coutour0''' to show the properties page for the Coutour filter.
# '''Delete All''' contour values.
# Using the '''Add Value''' widget, add two new iso-surface values: 0.25 and 0.59 in that order.
# Hit '''Accept'''.
# Now click '''Record a frame''' button on the VCR control. This will record the changes to contour values in a keyframe.
# '''Delete All''' contour values again and add three new iso-surface values: 0.2, 0.57 and 0.71. And hit '''Accept'''.
# Move the camera to a suitable view.
# Click '''Record a frame''' button again. This will record the changes to contour values and also the camera in a keyframe.
# Click '''Start/Stop Recording''' button again to stop recording.
# In the '''Animation Panel''' (select '''View''' | '''Keyframe Animation''') change the '''Duration''' to ''100''.
# Move the '''Current Time''' slider to 0 (it is not already at 0) and hit '''Play'''
# Go to [http://mg-trans.com.ua жд перевозки вагонами]

{{ParaView/Template/Footer}}