op_vuanim Program
The op_vuanim program is a GUI-based, license-controlled application used to view 2-D animation flows from an executing simulation or an animation history file.
Description
Animation flows are dynamic sequences of graphics operations that depict the changing state of a simulation. Animation flows are generated by simulations, but can only be viewed within the GUI environment of the op_vuanim program. One simulation run is limited to generating one corresponding animation flow. An executing simulation can store its animation flow in an animation history file or directly communicate it to an executing op_vuanim process via the IP communication protocol.
Animation flows define one or more viewers, which are rectangular areas in which graphics operations (termed animation requests) are done. Animation requests always depict dynamic elements in the context of a model diagram.
The op_vuanim program supports several operations for manipulating animation flows. Most of these operations can be applied to an animation flow from either an executing simulation or a history file. This program allows you to do the following:
- Specify an animation history file to be read.
- Start, stop, or pause playback of the current animation flow.
- Restart playback of the current animation flow.
- Increase or decrease the speed of the current animation flow’s playback.
- Step forward to the current animation flow’s next request or to the current animation’s request associated with the next simulation event or time.
- Clear out the current animation flow.
- Limit display of animation requests to the current viewer.
- Print the state of the animation flow playback to the standard output device for diagnostic purposes.
- Standard GUI-based operations (such as capturing a screen bitmap in a TIFF, GIF, or EPSI file).
Instructions for using op_vuanim are presented in Using the 2-D Animation Viewer.
Preferences
The op_vuanim program uses the following preference sets:
- “Standard Preferences“
- “Development“ preferences—core_dump, mem_track, mem_track_object, prof_track, prof_track_func, and prof_track_recurse only
- “Diagnostics“ preferences
- “Licensing Preferences“
- “GUI“ preferences—all except creation_mode, drag_obj_threshold, editor_config, move_delta, and show_units
The op_vuanim program uses the following program-specific preferences. To set these preferences, choose Edit > Preferences in an Animation Viewer window.
anim_event_gap
Specifies the initial gap (in seconds) between animation events for animation playback. The smaller the gap, the faster the animation plays. The op_vuanim controls let you can change animation speed during playback.
Note: op_vuanim defines a discrete set of event gap values. The event gap actually used will be the pre-defined value closest to the value specified by this preference. The pre-defined values are 10, 7.5, 5, 2.5, 1, 0.75, 0.5, 0.25, 0.1, 0.075, 0.05, 0.025, 0.01, 0.005, 0.001, 0.0005, and 0.0001.
Changes to this preference take effect after application restart.
- Type: double
- Default Value: 0.1
- Units: seconds
anim_port
Specifies the animation port, the numeric ID of a communication port that is established by an op_vuanim process. To send animation requests to a op_vuanim process, an executing simulation must be informed of the host on which the process is executing and the animation port established by the process. The animation port is based on the port mechanism of the UDP/IP protocol stack used as the communication channel between simulations and op_vuanim processes. The value of this numeric ID is an offset applied to the UDP port ID of the default animation port (which is 3211).
Changes to this preference take effect after application restart.
- Type: integer
- Default Value: 0
auto_play
Specifies that animation should be played automatically when the program starts.
Changes to this preference take effect after application restart.
- Type: boolean
- Default Value: FALSE
m
Specifies the base name of an animation history file to be pre-loaded as the initial animation flow within op_vuanim. The program searches for the specified animation history file in the model directories. Do not include the file path or file type suffix in the value of this preference.
Changes to this preference take effect after application restart.
- Type: string
- Default Value: “”
vector_buf_size
Specifies the number of vector entries per allocated buffer.
- Type: integer
- Default Value: 1024