1animate(1gv)                    Geomview Module                   animate(1gv)
2
3
4

NAME

6       animate - animate a sequence of geomview files
7

SYNOPSIS

9       animate [-p] [-b] [-s speed] [-o] [-S script] [-hide] [-f file1 file2 ...]
10

DESCRIPTION

12       Animate  is  an  interactive animation tool specifically designed to be
13       used with Geomview. It provides several simple animation controls  such
14       as  looping, bouncing, and single frame stepping, as well as adjustable
15       speed playing. The program works by  telling  geomview  to  read  in  a
16       sequence  of  geomview  files and then telling geomview to display each
17       frame of the sequence in order.
18
19       There are two methods that Animate provides for specifying which frames
20       one  wants to have in the sequence being viewed. The first method is to
21       enter the name of every frame into the text input box and press  return
22       or  click on load. The name of each frame must correspond with the name
23       of a geomview file existing in the file system.
24
25       EXAMPLES
26
27              pict1 pict2 pict3 pict4
28              pict*
29              pic??
30
31       The second method of loading frames is to  first  create  an  animation
32       script  file  outside  of animate and then load the script in by typing
33       its name in the input box and clicking on the script button. The advan‐
34       tage of this method is that you can more easily specify the exact order
35       in which you want the frames to be shown. The format of the script file
36       is a list of frame names each followed by a newline. Comments prepended
37       by a # sign are allowed.
38
39       EXAMPLE SCRIPT FILE
40
41              # list of frames for
42              # my rotating cube movie
43              cube.02
44              cube.04
45              cube.03 # get rid of this frame later
46              cube.01
47                .
48                .
49                .
50              cube.90
51
52
53       Loading frames into memory may take a little time, especially  if  each
54       frame  is  a  particularly large file. Be sure the machine you're using
55       has sufficient memory to load all  the  frames  you  desire.  Once  all
56       frames  have  been  loaded,  an  'animate'  object  will  appear in the
57       geomview object browser. It is now possible to begin animating.
58
59       Scrolling through frames can be accomplished in several different ways.
60       The first, and most obvious way is by 'playing' the frames. Clicking on
61       the Play button causes animate to begin playing through the  frames  in
62       order,  starting  with  the  first  frame  or  whichever frame has been
63       selected.  The corresponding name of each frame being shown is shown in
64       the pink text-entry box.  Click on Stop to cease playing.
65
66       Animation  speed  depends  on  the size and complexity of the object in
67       each frame. Thus different sequences can  have  considerably  different
68       top  playing  speeds. Use the Speed slider to set an upper limit to the
69       animation rate.  You can also play slowly through the frames  can  also
70       by clicking repeatedly on either step button.
71
72       Press  the  Bounce  button to enter bounce mode.  While in bounce mode,
73       direction of play reverses whenever the first or last frame is reached.
74       Clicking on either Step button determines the playing direction.
75
76       Clicking on Once puts animate in 'once' mode.  While in this mode, upon
77       reaching the first or last frame (depending on which direction you  are
78       going)  of  a  specified  sequence,  animate will stop playing.  Normal
79       playing can be resumed by clicking on Once again to exit this mode.
80
81       The Info button will bring up a short menu containing helpful hints for
82       program  usage.  Clicking  on the exit button will cause the program to
83       exit.
84

OPTIONS

86       -p     Start playing through the frames right away upon startup.
87
88       -b     Go into bounce mode upon startup.
89
90       -s speed
91              Set the speed of play upon startup. The value of speed may be an
92              integer between 0 and 100 which roughly signifies the percentage
93              of top playing speed.
94
95       -o     Set animation to play through only once upon startup.
96
97       -S script
98              Specify name of script containing filenames for  objects  to  be
99              read  in  upon  startup.  Takes  precedence  over  -f  option if
100              present.
101
102       -hide  Makes animate invisible upon startup. *Warning* all animate com‐
103              mands  must be specified on the command line when this option is
104              used since there is no way to access the main window.
105
106       -f file1 file2 ...
107              Specify names of files containing objects to  be  read  in  upon
108              startup.
109

BUGS

111       When  loading sequences one after another, geomview will often not load
112       a sequence on the first try. This can often be remedied by telling ani‐
113       mate to load the sequence yet again.
114

SEE ALSO

116       geomview(1) oogl(5)
117

AUTHOR

119       Daeron Meyer
120       The Geometry Center
121
122
123
124                               December 12, 1994                  animate(1gv)
Impressum