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 resolu-
		     tion than through screen grabbing.

		     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/vector/...)  to  a
		     file  for high resolution export with r.out.tiff or simi-
		     lar
       The user will find a _D___c_e_l_l raster file in GRASS database  after start-
       ing  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	proce-
       dure (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 monitor.

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  display  modules:
		     d.zzzz  (d.rast, d.vect, d.3d,...)   Note that an eventu-
		     ally 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 environ-
       ment 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)
