NAME
     WriteSeqAnim  - generate a files name sequence for animation, for
		     modules that write a file to disk

SUMMARY
     Name          WriteSeqAnim 

     Type          data 

     Inputs        none

     Outputs       string

     Parameters    Name                Type      Defaults
      		   ----                ----      --------
		   File name           string     -

		   File suffix         string     ""

	           Animation On/Off    boolean    On

		   Decimal precision   integer    4

	   	   Current frame       integer    1

		   Nr.frames           integer    1

DESCRIPTION
     The WriteSeqAnim  module sends a sequence of files' names, to
     a string parameter ports.
     Its purpose is to generate a sequence of files's names, sequence
     which will be used as input for different DATA OUTPUT  modules.
    
     Before you can connect the character string to the receiving module,you
     must make that receiving module's parameter port visible.  To make a
     parameter port visible, call up the module's Editor Window panel by
     pressing the middle or right mouse button on the module icon dimple.
     Next, look under the "Parameters" list to find the parameter you want
     to plug into.  Position the mouse cursor over that parameter's button
     and press any mouse button.  When the Parameter's Editor Window
     appears, click any mouse button over its "Port Visible" switch.  A
     blue-green (teal) parameter port should appear on the module icon.
     Connect this parameter port to the character string module icon in the
     usual way one connects modules.

     The  user has to specify the base name and the suffix of the files. 

PARAMETERS
     
     File name (string)
	   The name of the base output file.

     File suffix (string)
	   The suffix of the output file

     Decimal precision
	   The number of digits used to represent the sequence

     Animation On/Off (boolean)
	   Specifies whether or not to animate the sequence.
	   Defaults is Off.
	   The user has to trigger the animation.
     
     Current frame(integer)
	   Defaults is 1
	   Allows the user to see the current frame.
	   This parameter is updated with a new frame.
    
     Nr. frames(integer)
	   Defaults is 256
	   Specifies the numbers of the frames to be generated.
	   Animation stops after the last frame.
EXAMPLES 
     The following  networks shows example of how the WriteSeqAnim module can 
     be used: 
NOTE:
    For the sincronization, when the WriteSeqAnim is used with ReadSeqAnim
    the user has to use the BOOLEAN module.
    First, make the Animation On/Off port visible for ReadSeqAnim and
    WriteSeqAnim modules, and then connect the ports with the output
    port of the BOOLEAN module.

    To trigger the animation, the user has to use the boolean switch
    of the BOOLEAN module.

EXEMPLE 1

                                            BOOLEAN
                                               |
			    --------------------
			    |                  | 
                            |                  |
                       ReadSeqAnim             |
			    |                  |
			    |                  |
			 READ UCD              |
			    |                  |
GENERATE COLORMAP	    |                  |
       |		 UCD VECMAG            |
       |		    |                  --------
       |              ------|------------             |
       |--------      |            	|             |
	        |     |			|             |
	      UCD CONTOUR	        |             |
		    |                   |             |
		    |----------------|  |             |
				     |  |             |
				  UCD TO GEOM    WriteSeqAnim
	            			|
		   		        |              |
				  GEOMETRY VIEWER      |
				        |              |
					|   ------------ 
					|   |
				  WRITE_ANY_IMAGE


EXAMPLE 2
                                  BOOLEAN
                                     |
                                     |
			    -----------------------|
                            |                      |
                            |                      |
                        ReadSeqAnim                |
			    |                      |
			    |                WriteSeqAnim
			READ ANY IMAGE             |
			    |                      |
			    |----------------------|
			    |                      |
			    |                 WRITE IMAGE
		     DISPLAY  IMAGE

RELATED MODULES

      Any moudule that has as input port a string.

      See, also the ReadSeqAnim  module.

AUTHOR:

      ION   BAROSAN
      COMPUTING  CENTER
      EINDHOVEN UNIVERSITY OF TECHNOLOGY  EINDHOVEN, 
      P.O. Box 513,
      5600 MB Eindhoven,
      THE NETHERLANDS

      internet: rcion@urc.tue.nl
      fax:      +31 (0)40 434438
      phone:    +31 (0)40 472154