Viewing an Animation
Before you can view an animation, you must read in an animation history file (unless you are using the direct viewing option). After a history file has been loaded, the animation flow is active, but paused. op_vuanim does not begin playing back the flow until you start it with an appropriate Playback operation or a Step operation.
Procedure 1: Loading an Animation
-
Choose Open... from the File menu.
A dialog box opens with a list of available animation history files (which store a scenario’s animation results).
-
Select an animation to display and click OK.
op_vuanim reads in the animation.
Using Playback Operations
The playback operations control the basic display of an animation sequence. These operations allow you to start, pause (stop), and restart an animation, as described in the following table.
Table 10: Playback Operations
| Button | Name | Description |
|---|---|---|
![]() |
Play | Activates any animation flow that has been established. |
![]() |
Pause | Pauses (stops) an animation indefinitely, until another operation reactivates it. You can also pause an animation sequence by moving the cursor. However, this method only pauses the sequence for a few seconds before animation automatically resumes. |
![]() |
Restart | Restarts an animation flow from its beginning. |
To pause (stop) an animation, left-click the Pause button or choose the item from the Controls menu.
Procedure 2: Starting a Paused Animation
-
Left-click one of the following buttons or choose the item from the Controls menu:
-
Play
The animation resumes from the current point in the animation history file.
-
Restart
The animation restarts from simulation time 0. Any viewer that was moved or resized returns to its original size and position.
-
Any Step operation
The animation advances to the next event, time, or animation request, depending on the button activated. Refer to Stepping Through an Animation for more information.
-
Adjusting Animation Speed
Sometimes it is necessary to speed up or slow down the animation flow to view particular aspects of the animation. Two operations adjust animation speed, as listed in the following table.
Table 11: Animation Speed Operations
| Button | Name | Description |
|---|---|---|
![]() |
Slow Down Animation | Slows down the animation sequence in increments. |
![]() |
Speed Up Animation | Speeds up the animation sequence in increments. |
You can invoke these operations before an animation flow is read in or during playback. When invoked during playback, these operations cause op_vuanim to slow down or speed up animation in all open viewers. After the flow rate is changed, op_vuanim maintains it for the entire session or until the rate is changed again. The rate does not revert to the default between animation viewing sequences.
Animations run at a default speed of 0.1 second, meaning there is a pause lasting 0.1 second (real time) between successive animation events. This interval, called the animation event gap, is shown in op_vuanim’s mode display. The largest event gap (corresponding to the slowest animation) is 10 seconds. The smallest event gap (corresponding to the fastest animation) is 0.01 second.
Procedure 3: Adjusting Animation Speed
-
Left-click a Rate operation button or choose the item from the Controls menu.
The animation speeds up or slows down to the next incremental value. The mode display shows the new event gap.
-
To further slow down or speed up animation, repeat step 1.
Stepping Through an Animation
At times, simply slowing down an animation is not enough to allow close examination. Thus, op_vuanim allows you to step through an animation, pausing at each simulation event, time, or animation request. The three operations that step through an animation are listed in the following table.
Table 12: Step Operations
| Button | Name | Description |
|---|---|---|
![]() |
Step to Next Event | Steps to the next simulation event (which may not necessarily correspond to a graphical change). |
![]() |
Step to Next Time | Steps to the next simulation time. Because multiple events may occur at each simulation time, this operation may carry out more animation requests than the Step to Next Sim. Event operation. |
![]() |
Step to Next Animation Request | Steps to the next animation request. When the animation sequence begins, it stops after the first animation request received by op_vuanim. Typically the first request will pop up a blank animation viewer. |
Each of these operations causes a paused animation to advance one step, then pause again after the first simulation event, time, or animation request. You can continue activating toolbar buttons to step through an animation.
Controlling Viewer Display
The following operations can be invoked to control viewer windows.
Table 13: Viewer Operations
| Name | Description |
|---|---|
| Toggle Background Freezing | Enables and disables animation display in background (inactive) viewers. |
| Print Diagnostics | Prints viewer, model, and drawing information associated with all viewers in the current animation flow. |
Background Freezing
When multiple viewers are open, op_vuanim displays animation such that viewers become momentarily active to display the current state of animation (as generated by the simulation). Viewers that are inactive during this time will not display animation until the simulation generates animation data related to the objects in them. Multiple viewers will change from inactive to active throughout the course of a simulation so that you can view animation throughout different parts of a system model.
Background freezing refers to op_vuanim’s ability to suspend animation when multiple viewers are on the screen, so that only one viewer is active. When background freezing is on, only one viewer will display animation; other windows will remain frozen in the background. When background freezing is off, all viewers display animation sequences, which allows you to monitor multiple animations. The background freezing status is indicated in op_vuanim’s mode display. It is turned on by default.
The Toggle Background Freezing operation can be invoked at any time before, during, or after an animation sequence has started. If this operation is invoked when background freezing is on, op_vuanim toggles it off. Viewers that were frozen in the background become active and their time bars are updated with the current simulation time. If background freezing was off, op_vuanim toggles it on. This causes the viewer in the foreground to display animation and remain active; viewers in the background become inactive and their animation sequences are suspended.
Diagnostic Information
Information related to the animation viewer and the model it contains can be generated using the Print Diagnostic Information operation. This can be used to examine areas of interest within an animation for troubleshooting and analysis. This operation can be invoked any time during animation playback. The data is printed to the command shell window that spawned op_vuanim and will reflect the current time in the animation viewers.
Procedure 4: Viewing Diagnostic Information
-
Choose Print Diagnostics from the File menu.
-
Information on all viewers in displayed in the window that spawned op_vuanim. The information reflects the current status of all viewers and is grouped into the following categories:
- Viewer Count—lists the number of viewers associated with the animation history file. This number includes any viewers that have been closed during animation playback.
- Viewer State—lists information about the viewer such as viewer ID, name, position, and size. The viewer status will either be visible, meaning that it is currently open in the window, or closed. The name of the model inside the viewer is also provided.
- Model State—lists information about the model inside the viewer, such as object names and packet IDs.
- Drawing Count—lists the number of drawings and the information associated with each drawing. Drawings are the result of animation requests. For example, one drawing could be an actual model, comprised of a series of animation requests. Drawing information listed includes a time stamp for when the drawing was created, an event ID indicating the order in which the drawing occurred, and the type of drawing.







