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 current 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. Cur-
       rently	"TIFF/uncompressed",  "TIFF/PackBits-compression"
       and "TIFF/deflate" formats are supported.  Other  compres-
       sion  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  (unref-
       erenced)  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  differ-
       ent.  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 val-
       ues in the map increase from the origin upward.

NNOOTTEE
       This  module  only  supports TIFF's conforming to the base
       TIFF   6   specification.    These   include   monochrome,
       grayscale,  palette and RGB ("True Color"), with at most 8
       bits per "sample".  Other features, like larger	bits/sam-
       ple, floating point (or rational) samples, alpha blending,
       transparency masks, and multiband  images,  are	not  cur-
       rently 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  cur-
       rent 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)
