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



NNAAMMEE
       CCEELLLL  ddrriivveerr  - driver to redirect graphical output into a
       raster map

       _(_d_r_i_v_e_r_s_)

DDEESSCCRRIIPPTTIIOONN
       The CELL driver can be used to redirect the output of  the
       GRASS monitor into a raster map. Features are:

		      storing  graphical  output into a file with
		     better resolution than through screen  grab-
		     bing.

		     saving  3-dimensional  output  from  d.3d or
		     other display programs to	a  _D___c_e_l_l  raster
		     map.

		     saving  display overlays (raster/raster/vec-
		     tor/...)  to  a  file  for  high  resolution
		     export with r.out.tiff or similar
       The  user will find a _D___c_e_l_l raster file in GRASS database
       after starting the driver and using  d.rast,  d.vect  etc.
       and  finally  stopping the driver again. The _D___c_e_l_l raster
       file is written during closing procedure (this may require
       some time according to the selected resolution).

       Then the user can export this file through r.out.tiff etc.
       for use in external mapping software.


       Be aware that _D___c_e_l_l map is in a xy-projection  which  may
       differ  to  the	current  location's  projection.   So the
       _D___c_e_l_l map cannot be directly displayed on a  GRASS  moni-
       tor.

UUssaaggee iinn ddeettaaiillss
		     Set the map size for the CELL driver:
		     export  GRASS_WIDTH=xxx	 (default is 640)
		     export GRASS_HEIGHT=yyy	(default is 480)

		     If "export" command is not accepted by  your
		     shell,    use   "setenv"	instead:   setenv
		     GRASS_WIDTH xxx setenv GRASS_HEIGHT yyy

		     Start  the  CELL  driver:	d.mon  start=CELL
		     Wait for "Ready" message (may take some time
		     due  to  the  file  size	selected)   d.mon
		     select=CELL

		     Now  the  user can work with the common dis-
		     play  modules:   d.zzzz   (d.rast,   d.vect,
		     d.3d,...)	  Note that an eventually started
		     GRASS monitor won't display anything as  the
		     output is redirected to _D___c_e_l_l file.

		     Stop  the	CELL  driver  (and  write  _D___c_e_l_l
		     file): d.mon stop=CELL   Note that this  may
		     require some time.

		     To export the_D___c_e_l_l file, re-set the region:
		     g.region  raster=D_cell  Use   the   r.out.*
		     export module.

NNOOTTEESS
       Note  that  the _D___c_e_l_l raster map is in xy-projection with
       simple xy-coordinates.


       The resolution of the _D___c_e_l_l 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  D_cell
       size.


       Note that the CELL driver is limited to 8bit colors.

SSEEEE AALLSSOO
       _d_._m_o_n_, _g_._r_e_g_i_o_n_, _h_t_m_l_m_a_p_d_r_i_v_e_r_, _p_n_g_d_r_i_v_e_r_, _X_D_R_I_V_E_R_, _t_c_l_t_k_-
       _g_r_a_s_s _c_e_l_l_-_t_i_f_f _s_c_r_i_p_t

AAUUTTHHOORR
       CERL

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_2 _$



GRASS 5.0					    celldriver(1)
