This sample data was provided by Keith Refson of the Oxford University, to be used with the fast_animate module on the ftp site. The text file included with this module is included below: FAST ANIMATE(6) CONTRIBUTED MODULES FAST ANIMATE(6) NAME fast animate - AVS module to animate a sequence of geometries SUMMARY Name fast animate Type data Inputs None Outputs Geometry Parameters _N_a_m_e _T_y_p_e GeomFiles browser min integer max integer cur integer step oneshot back oneshot go toggle DESCRIPTION The _f_a_s_t _a_n_i_m_a_t_e module implements an animation of a sequence of AVS _g_e_o_m_e_t_r_y files by reading them into memory and sending the geometries in rapid succession to its output port. By storing the geometries in memory it can achieve substantially better animation rates than the use of a _c_y_c_l_e object in a script would. Furthermore the animation rate is independent of the length of the sequence until physical memory is exhausted. The module was developed for visuali- zation of molecular dynamics simulations where the geometries are "ball and stick" representations of molecular assemblies, but is not restricted to such. The module may be in either of two states called the _r_e_a_d state and the _r_u_n state which it alternates between. Some of the controls have different meanings in the two states. In the _r_e_a_d state the _m_i_n and _m_a_x parameters should be set to delimit the frame numbers of the geometry files to be read in, and the name of one of the files should be selected using the browser. Pressing the _g_o button at this point will initiate reading of the whole sequence (which may take some time) during which the button will remain illuminated. On completion the _g_o button will extinguish and the module will change to the _r_u_n state. In the _r_u_n state the meanings of the _m_i_n, _m_a_x and _g_o buttons change. _M_i_n and _m_a_x now delimit the range of geometries which will be cycled through (which must be a subset of For sample data to try out this module, see the fast_animate directory on the International AVS Center's anonymous ftp site. Keith Refson Last change: 20/09/90 1 FAST ANIMATE(6) CONTRIBUTED MODULES FAST ANIMATE(6) those just read in) and _g_o becomes a toggle whose effect is to start and stop the animation. The _s_t_e_p and _b_a_c_k buttons become active and may be used to single-step through the frame in either direction. Clicking on a new filename in the browser will return the module to the _r_e_a_d state ready to read in a new sequence of files. PARAMETERS GeomFiles The sequence of AVS _g_e_o_m_e_t_r_y files is specified using a file browser. Each file is considered to contain one frame. This requires that the files are named according to the convention _r_o_o_tnnnn._g_e_o_m where _r_o_o_t is some arbitrary base filename and nnnn is a decimal integer (without leading zeros ) indicating the frame number of the file. Clicking on any one of these files will read in the whole sequence. What happens is that the file name returned by the browser is examined and any digits preceding ._g_e_o_m are discarded. They are replaced in turn by a frame number which cycles from _m_i_n to _m_a_x whereupon the corresponding file is read in. Alternatively, if the file name returned contains a _p_r_i_n_t_f(_3_S) format code such as %_d, %_o or %_x this code is used to insert frame numbers into the file name which therefore need not conform to the above conven- tion. A suitable name may be input either by directly typing it in to the browser or by creating a dummy file of that name. This feature may be of use to hackers who cannot read decimal notation. min and max In the _r_e_a_d state these delimit the range of files to be read in. In the _r_u_n state they set the limits of frames to cycle over. cur This parameter indicates the current frame number. If it is altered the sequence number is reset to the new value. step and back These parameters single-step through frames either for- wards or backwards. go In _r_e_a_d mode this button is pressed to indicate that the _m_i_n, _m_a_x and _G_e_o_m_F_i_l_e_s parameters are correctly set and that reading may begin. In _r_u_n mode it starts or stops animation. Keith Refson Last change: 20/09/90 2 FAST ANIMATE(6) CONTRIBUTED MODULES FAST ANIMATE(6) OUTPUT geometry The output consists of a sequence of _g_e_o_m_e_t_r_y _e_d_i_t _l_i_s_t_s presented in rapid succession representing frames in the animation. Note that this is a coroutine module and is designed to drive a network. EXAMPLE FAST ANIMATE | RENDER GEOMETRY | DISPLAY PIXMAP RELATED MODULES shrink, offset, render geometry, tube LIMITATIONS Once the total memory of the machine is exceeded, perfor- mance becomes very poor due to paging of the X server. With geometry files of approximately 24 kilobytes it is reason- able to animate 1500 frames in a 64 megabyte machine. Keith Refson Last change: 20/09/90 3