== Richard Albrecht ========== albrecht@vms.biochem.mpg.de ==

NAME
	r_tifvol_ra - reads a serie of TIFF-files *.nnn

SUMMARY
	Name	r_tifvol_ra
	Type	Input
	Inputs	NONE
	Outputs	vol_rgba - 	field 3D 3-space 1-vector uniform byte

	Parameters
	Name		Type	Default	Choices
	fieldfile	browser		File Type	Filename
	report	toggle	off	off	on

DESCRIPTION
        This is a special reader for uncompressed TIFF-files. 
        It reads only 8 bit grey TIFF-images. A Colormap is ignored.
        With a modification of the normal AVS-field descriptor '*.fld'
        a complete image serie is read in. The filenames must be in 
        MS-DOS style ( cccccccc.nnn ). The 3 characters after the dot 
        are the file number ( *.000, *.001 ... ).
        The output is an AVS-field.


         Example field description for t_tif_vol_ra:

         # AVS field file
         # written from DAVS (R. Albrecht, MPI f. Biochemistry)
         #
         # norm voxel =   0.170
         # vox x =        0.104
         # vox y =        0.104
         # vox z =        0.200
         #
         #
         #
         dim1 = 256
         dim2 = 256
         dim3 = 30


        The following lines are important and must be present:
                # norm voxel =   0.170
                # vox x =        0.104
                # vox y =        0.104
                # vox z =        0.200
                dim1 = 256
                dim2 = 256
                dim3 = 30

        All other lines are ignored.
        vox_x ... is used for scaling of the internal points field.

        points[0] = 0
        points[1] = ( vox x / norm voxel) * dim1 - 0.5
        ...
        If you don't want this scaling, then set to 1.0.

        dim1 and dim2 must be equal to the image size in the TIFF-files.
        dim3 is the number of files.

        All other entries are ignored.
        At first the module tries to read 'fldfile.vol' 
         in the current directory.
        This file contains the data in raw bytes without a header.
        If this fails, it tries to read 'fldfile.000'.
        If this fails, it tries to read '../lsm/fldfile.000'.
        Last step is trying '../vol/fldfile.000'.
        This means that the TIFF-files must be in 
        the current directory, at '../vol/' or at '../lsm/'.



INPUTS
        none

PARAMETERS

        fieldfile (browser)

        report (toggle)

OUTPUTS
        vol_rgba - field 3D 3-space 1-vector uniform byte

EXAMPLE NETWORKS
                r_tifvol_ra
                   |
                orthogonal slicer
                   |
                image viewer

RELATED MODULES
        read field