The vseries command displays an ordered sequence of volume data sets. It is the command-line implementation of Volume Series. See also: vop morph, movie-related commands
The Volume Series dialog must be used to open the series. The volume-spec is the model number of any member of the series. Examples:
vseries play #0 loop trueThe members of a series are indexed 0, 1, 2, ... and these indices are referred to as the time. Any numbers in the individual filenames are not used.
vseries stop #0
Option keywords for vseries can be truncated to unique strings and their case does not matter. A vertical bar “|” designates mutually exclusive options, and default values are indicated with bold. Synonyms for true: True, 1. Synonyms for false: False, 0.
direction mode
Specify the playback mode:
loop true | false
Whether to loop playback continuously until it is halted with vseries stop.
maxFrameRate rate
Specify a maximum playback rate in steps per second. By default, playback is as fast as possible, which can be fairly slow for large data. This option is used to slow playback when it is too fast.
normalize true | false
Whether to adjust the thresholds (contour levels) to keep the enclosed volume constant throughout the series. This is useful when the signal level in the data changes over time or between states.
showMarkers true | false
Whether to display markers previously created with Volume Tracer to trace spatial and temporal paths. Each marker is labeled with the time of the data set on which it was placed. The labels are not shown. They are used by vseries to display only the markers for the currently displayed time. Markers for specified numbers of earlier and later time points can also be shown using the precedingMarkerFrames and followingMarkerFrames options, respectively.
precedingMarkerFrames N
When showing markers, for how many earlier time points (default 0) the markers should also be shown.
followingMarkerFrames M
When showing markers, for how many later time points (default 0) the markers should also be shown.
colorRange cutoff
Whether to color volume contour surfaces to match markers within a specified distance cutoff (regardless of whether the markers are shown). All of the markers associated with the current time are used to color the current surface. The coloring does not apply to solid displays.
cacheFrames K
Whether to store volume rendering (surface triangle or solid voxel) information for the K most recent displays (default 1). This can speed playback because less time is spent recalculating display information. There is no hard limit to the memory used to cache rendering information. Surface renderings use memory proportional to the number of triangles composing the surface. Solid renderings use memory proportional to the number of data voxels displayed, and it is generally only feasible to cache solid display information for small data sets.