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 specified 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, incorporating  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 specifica-
       tion.


       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)
