r.in.tiff(1)		      Grass User's Manual		  r.in.tiff(1)



NNAAMMEE
       rr..iinn..ttiiffff  - Imports a TIFF (8 or 24 bit) raster file into GRASS raster
       file(s).
       _(_G_R_A_S_S _R_a_s_t_e_r _D_a_t_a _I_m_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..iinn..ttiiffff [--vv] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       This program imports a TIFF raster file (8 or 24 bit) to  GRASS	raster
       file(s).  Output is placed in the _/_c_e_l_l directory under the user's cur-
       rent GRASS mapset.



   FFllaagg::
       --vv     Verbose mode

   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of an existing TIFF raster file to be imported.

       oouuttppuutt==_n_a_m_e
	      Name to be assigned to resultant binary raster map layer.



       The program prompts the user to enter the name of the TIFF raster  file
       to be converted and the name to be assigned to the GRASS raster file to
       contain the resultant image. Currently "TIFF/uncompressed", "TIFF/Pack-
       Bits-compression" and "TIFF/deflate" formats are supported.  Other com-
       pression schemes may not be read correctly.   LZW  compression  is  not
       supported due to UNISYS patent.


       If  the	image is a 24-bit RGB TIFF, then the output will be split into
       respective red, green and blue band files; each having the _o_u_t_p_u_t  name
       as its prefix followed by _._r, _._g or _._b, respectively.  Color composites
       can be displayed with d.rgb.


       If a TIFF World file exists with an extension of "tfw", "tifw",	"TFW",
       or  "TIFW",  it	will  be used to set the boundary coordinates and cell
       size.  Rotation in the TIFF World file is  not  supported  (second  and
       third  numbers),  and  if  present  the	TIFF will be imported as an XY
       (unreferenced) image.  If no TIFF World file exists,  the  user	should
       adjust  boundary  coordinates  stored  in  the cell header after import
       using _r_._s_u_p_p_o_r_t .


       A sample TFW file opened up would look like:
			      6.00
			      0.00
			      0.00
			     -6.00
			1709053.00
			 807714.00

		Line 1 - Cell size in the "X" direction
		Line 2 - "Rotation" term for the row
		Line 3 - "Rotation" term for the column
		Line 4 - Cell size in the "Y" direction
		Line 5 - Easting value of insertion point "X"
		Line 6 - Northing value of insertion point "Y"
	Note: The y-scale (4) is negative because the origins of an image  and
       a  geographic  coordinates system are different. The origin of an image
       is located in the upper-left corner, whereas  the  origin  of  the  map
       coordinate  system  is  located in the lower-left corner. Row values in
       the image increase from the origin downward, while y-coordinate	values
       in the map increase from the origin upward.

NNOOTTEE
       This module only supports TIFF's conforming to the base TIFF 6 specifi-
       cation.	These include monochrome, grayscale, palette  and  RGB	("True
       Color"), with at most 8 bits per "sample".  Other features, like larger
       bits/sample, floating point  (or  rational)  samples,  alpha  blending,
       transparency masks, and multiband images, are not currently handled.


       This  module  also doesn't handle true GeoTIFF's (those with coordinate
       reference information actually embedded in  the	TIFF  file).   So  the
       assumption  with  the TIFF world file is that it make sense in whatever
       coordinate system the current region settings return.

SSEEEE AALLSSOO
	_r_._s_u_p_p_o_r_t _p_a_r_s_e_r and _r_._o_u_t_._t_i_f_f, _r_._i_n_._g_d_a_l

AAUUTTHHOORR
       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory


       GRASS 5.0 team

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_5_/_1_0 _0_8_:_0_6_:_0_7 _$



GRASS 5.0							  r.in.tiff(1)
