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



NNAAMMEE
       rr..iinn..ppnngg  -  Converts  a  PNG image file to a GRASS raster
       file.
       _(_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..ppnngg  [--hhvv]	iinnppuutt==_n_a_m_e   oouuttppuutt==_n_a_m_e   [ttiittllee==_s_t_r_i_n_g]
       [ggaammmmaa==_v_a_l_u_e] [aallpphhaa==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       This  program converts a PNG raster file to a GRASS raster
       file.

OOPPTTIIOONNSS
   FFllaaggss::
       --ff     Create floating-point maps (range 0.0 - 1.0).

       --hh     Output image file header only; don't create map(s).

       --vv     Verbose mode.


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

       oouuttppuutt==_n_a_m_e
	      Name  to	be  assigned  to  resultant  raster   map
	      layer(s).

       ttiittllee==_s_t_r_i_n_g
	      Title  to  be  assigned  to  resultant  raster  map
	      layer(s).

       ggaammmmaa==_v_a_l_u_e
	      Perform gamma correction using this value  for  the
	      display gamma.

       aallpphhaa==_v_a_l_u_e
	      Pixels with an alpha (transparency) value less than
	      or equal to this	value  are  imported  as  no-data
	      cells.


NNOOTTEESS
       The output depends upon the format of the PNG image. Gray-
       scale and paletted  (indexed,  color-mapped)  images  will
       result  in a single output map, with the name specified by
       the oouuttppuutt option.


       True-color (RGB) images will result in three output  maps,
       whose names are formed by appending ".r", ".g" and ".b" to
       the name specified by the oouuttppuutt option.


       For both gray-scale and true-color images, if transparency
       information  is present, an additional map will be created
       whose name is formed by appending ".a" to the name  speci-
       fied by the oouuttppuutt option.


       For paletted images, the resulting cell values will be the
       color indices from the image, with the map's  color  table
       generated  from	the  image's  palette. For gray-scale and
       true-color images, the cell values will be  the	intensity
       values  from  the  image.  The  map's color table will map
       these values to the normalized intensity levels,  incorpo-
       rating any gamma correction.


       However,  when  the  --ff flag is used, any scaling or gamma
       correction is performed on the  actual  cell  values.  The
       map's  color  table  will  be  a  linear gray scale. Also,
       paletted images will first be expanded to true-color.


       The user should adjust boundary coordinates stored in  the
       cell header after import using _r_._s_u_p_p_o_r_t or _r_._r_e_g_i_o_n.


       The  ggaammmmaa  option  is  only  used if the image contains a
       gamma specification.


       The aallpphhaa option is only relevant if  the  image  contains
       transparency information.

SSEEEE AALLSSOO
       _r_._c_o_m_p_o_s_i_t_e

       _r_._s_u_p_p_o_r_t

       _r_._r_e_g_i_o_n

       _p_a_r_s_e_r

AAUUTTHHOORR
       Glynn Clements

       _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_:_2_0_:_2_2 _$



GRASS 5.0					      r.in.png(1)
