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 000000000000 (black).


		     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/) devel-
       oped 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 option-
       ally 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_6_/_1_6 _1_5_:_2_9_:_1_8 _$



GRASS 5.0							  pngdriver(1)
