seqview - to view several tracks simultaneously and easily navigate through data.
NAME
seqview
seqview
[
options
]
1. The main goals
The main objective was to develop a viewer of sequences that would allow to
view several tracks simultaneously and easily navigate through data.
2. Main features
The application uses a set of IP commands to view and manipulate the
sequences. A sequence is defined by a set of files containing
individual frames of the sequence. Format yet supported is a pgm file
format. Names of files containing individual frames are composed of
a fixed parts and an index that designates the order of the frame in
a sequence.
The names are defined by a template, that determines the fixed
parts of the filename and a position of the index, as well as the upper
and lower bounds of the index. The form of the template is 'ab#cd.efg,1-12'
or 'ab[1-12]cd.efg'. These templates define files ab1cd.efg, ab2cd.efg, to
ab12cd.efg. Only the first form is applicable for a command line specification
of sequences (see Command line options).
If a directory contains only files named in the manner described above,
i.e. all files containing a frame are defined by one template, only the name
of the directory can be supplied as an identifier of a sequence and the
template is determined automaticaly. When opening a sequence in the interactive
mode the user can specify all numbered images in a directory by supplying
an asterix '*' insted of the numbers.
A user can open an arbitrary number of sequences. The sequences are
displayed simultaneously, i.e. frames with the same number at the
same time. This means that the synchronisation is determined by indices
of frames given by their filenames. Thus, the playable part of sequences
is given by the greatest common intersection of lower and upper bounds
of the individual sequences.
The user can set the start and end values of the played frames as well as
a step by which the frames are played. If the loop option is set, the frames
form a loop that is played over and over. Otherwise the player is stoped at
the end of the sequence.
The windows with individual sequences support basic operations of IP images.
They can be zoomed by an arbitrary scale, a selection can be made and
a value at a given position can be watched throughout the replaying. These
operations can be applied either to a single sequence or to all opened
sequences at the same time.
The frame rate is limited by the speed of displaying individual frames.
When invoked without command line options (seqview) a main application window
is displayed. By default, only one panel is visible. It contains the main
control elements of the player that can be used to set numbers of the first
and the last frame to play (start and end values), toggle the loop switch and
control the replay of sequences.
By using the lower value box (named Current) the user can display
an arbitrary frame of a sequence.
The command line options can be used to set the startup state of the application.
This feature is especially useful for presentation purposes. The user can on the
command line specify what sequences would be loaded, what positions would
windows be placed on, etc. Virtually all parameters that can be set in the
interactive mode can be set from the command line.
- -dir directory
- -directory directory
Specifies directory that is used as root directory for following file o
perations. The default is current working directory.
- -f file_specification
- Specifies files that compose a sequence. The path is relative to
working directory, i.e. to the directory specified by -dir option. There are
two possible ways to specify a sequence:
a) filename is in form of "<prefix>#<suffix>,<from>-<to>" - the character # in the
filename is replaced by number in the range of <from, to>. For example,
"tom#.pgm,8-12" specifies sequence tom8.pgm, tom9.pgm, tom10.pgm, tom11.pgm,
and tom12.pgm.
b) file_specification is a name of a directory. The directory must contain only
files with a number in their names. The prefix, suffix and the range is
determined automaticaly.
Following options are applied only to the most recently specified sequence:
- [+|-]zoom <x_zoom>[,|x]<y_zoom>
- Sets initial zoom values for the sequence. If the option starts with '+', a popup zoom dialog is displayed, otherways it remains withdrawn.
- -value <x_pos>,<y_pos>
- Displays a value box and respective cursor at given position.
- -select <x1>,<y1>,<x2>,<y2>
- Selects rectangular area defined by given positions.
Global options:
- -from <value>
- Sets the start value for the player. By default, the player will
start at the lowest possible value.
- -to <value>
- Sets the end value for the player. By default, the player would
end at the highest possible value.
- -step <value>
- Sets the step of the player, i.e. the step between two frames
during the playback. The default value is 1.
- -fps <value>
- Sets frame rate in frame per second. The default value is 6.
- +play
- The viewer will start playing after loading of all sequences
and processing of all command line options.
- [+|-]loop
- Sets | resets looping of sequences during playback, default
value is on.
The next options are used to customize arrangement of windows
on screen, the windows are tiled.
- -posx <value>
- Sets the x position in pixels of the left edge the first column
of windows. The default value is 20.
- -posy <value>
- Sets the y position in pixels of the top edge the first row
of windows. The default value is 20.
- -columns <value>
- Sets the number of columns in which windows are tiled. The
default value is 3.
- [+|-]panel
- Displays | hides the application's main panel. By default, the main
panel is visible.
- [+|-]sb
- [+|-]scrollbars
Displays or hides scroll bars in all tracks. By default, the scroll
bars are hidden.
seqview
29-Jan-98. Automatically converted by man2html,
written by G.Matas (g.matas@ee.surrey.ac.uk)