pngdriver(1)	       Grass User's Manual	     pngdriver(1)



NNAAMMEE
	PPNNGG ddrriivveerr  - driver to create PNG images

       _(_d_r_i_v_e_r_s_)

DDEESSCCRRIIPPTTIIOONN
       The  PNG  driver generates PNG pictures from GRASS display
       commands.

UUSSAAGGEE
   EEnnvviirroonnmmeenntt vvaarriiaabblleessSSeevveerraall eennvviirroonnmmeenntt vvaarriiaabblleess eeffffeecctt  tthhee
       ooppeerraattiioonn
       of the PNG driver.

		     GGRRAASSSS__WWIIDDTTHH==xxxxxx
		     the width of the image map (default is 640).


		     GGRRAASSSS__HHEEIIGGHHTT==yyyyyy
		     the height of  the  image	map  (default  is
		     480).


		     GGRRAASSSS__PPNNGGFFIILLEE==ffiilleennaammee
		     the  filename to put the resulting image in,
		     default is mmaapp..ppnngg.

		     GGRRAASSSS__BBAACCKKGGRROOUUNNDDCCOOLLOORR==RRRRGGGGBBBB
		     specifies the background color to use in RGB
		     notation  (hex  values).  Default	is FFFFFFFFFFFF
		     (white).


		     GGRRAASSSS__TTRRAANNSSPPAARREENNTT==[[TTRRUUEE||FFAALLSSEE]]
		     sets transparent background on (TRUE) or off
		     (FALSE, default).

		     GGRRAASSSS__TTRRUUEECCOOLLOORR==[[TTRRUUEE||FFAALLSSEE]]
		     sets true-color support if built with GD-2.0

   EExxaammppllee
	      Start up the driver

	      d.mon start=PNG d.mon select=PNG


	      Display raster map and vector polygons


		       d.rast _s_o_m_e_r_a_s_t_e_r_m_a_p
		       d.vect map=_s_o_m_e_v_e_c_t_o_r_m_a_p color=red


	       Stop the driver subsequently. This  will  write	a
	      file  named  _m_a_p_._p_n_g  to be created in your current
	      directory:

		       d.mon stop=PNG



NNOOTTEESS
       The     PNG     driver	  uses	   the	   Gd	  library
       (http://www.boutell.com/gd/)   developed  by  Boutell.Com,
       Inc. The Gd library in turn  relies  on	libpng	(see  the
       libpng  home  page) and zlib (see the info-zip home page),
       all which needs to be installed for the PNG driver to work
       (it's worth it).


       Note  that  the	PNG driver is limited to 8bit colors when
       compiled against libgd1.x.   From  libgd2.x  onwards  true
       color support is optionally provided.


       The resolution of the _P_N_G raster map is defined by the map
       extents. Use _g_._r_e_g_i_o_n _-_p to get the  number  of	rows  and
       cols  and  use  the  environment  variables to set the PNG
       size.



SSEEEE AALLSSOO
       _H_T_M_L_M_A_P _d_r_i_v_e_r_, _c_e_l_l_d_r_i_v_e_r_, _X_D_R_I_V_E_R_, _d_._a_r_e_a_, _d_._m_o_n_, _d_._v_e_c_t


AAUUTTHHOORR
       Per Henrik Johansen

       _p_h_j_@_n_o_r_g_i_t_._n_o

       _N_O_R_G_I_T _A_S

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_3_/_0_1 _0_0_:_0_8_:_3_1 _$



GRASS 5.0					     pngdriver(1)
