cell.out.tiff(1)	      Grass User's Manual	      cell.out.tiff(1)



NNaammee
       cceellll..oouutt..ttiiffff  -  Plots maps with the Cell Driver and exports them as a
       tiff-image.

DDeessccrriippttiioonn
       cceellll..oouutt..ttiiffff consists of a TCLTK-Module and a shell script.  With  the
       TCLTK-Module you can choose various maps (raster, vector and sites) and
       some parameters. The script creates a set of display commands and plots
       the  chosen  maps as a preview in the selected monitor. Then the script
       initializes the cell driver and	plots  all  the  maps  to  D_Cell  and
       exports	the D_Cell-map as a tiff-file. Finally the script restores the
       previous settings.


       It is the attempt to collect as many of the most  common  display  com-
       mands as possible in a single command and to hide some awkward commands
       (e.g. changing projections for the export) from the user.


       The maps will be displayed in the following order:


       Base raster map -> additional raster maps -> vector polygons ->	vector
       maps -> site maps ->; legend.


       You can see all the commands as they are created from the shell script,
       so if the result doesn't look like what you've expected, you  can  see,
       what  parameters might be wrong. All messages from the display commands
       are displayed, too. The user can use additional	display  commands,  if
       the  pause  option  was set. The script waits until the xterm window is
       closed, so you can use any display command, you might need.

EEnnttrriieess
       BBaacckkggrroouunndd ccoolloorr - Sets the background color with d.erase.  The default
       is  set	to  white, as the exported files are probably used for printed
       maps. This is different to the default behavior of d.erase.


       RRaasstteerr mmaappss

       BBaassee rraasstteerr mmaapp - A raster map put in the background with d.rast.


       AAddddiittiioonnaall rraasstteerr mmaappss - To display more than one raster maps. The maps
       must be separated by comma (this is automatically done, if the maps are
       chosen with the raster-button) These raster maps can be used  as  over-
       lays  by  activating the overlay-button.  This option is similar to the
       overlay option of d.rast.


       VVeeccttoorr mmaappss

       VVeeccttoorr ppoollyyggoonn mmaappss - displays vector polygon maps with d.area. You can
       select  border  colors  and  fill colors for each map with the next two
       entries. The first map will be plotted with the first colors, the  sec-
       ond  with  the second and so on. All maps with no color will be plotted
       with the default colors.


       VVeeccttoorr mmaappss - displays vector maps with d.vect. You can choose the col-
       ors for the maps with the next entry: Vector display colors.


       SSiittee mmaappss - Display site markers with the d.sites command.  The parame-
       ters color, size and type can be selected with the appropriate entries.
       As  usual,  the	first entry of the parameter belongs to the first site
       map and so on.


       LLeeggeenndd - Displays a legend in the map with d.legend. You can choose the
       size with the lines entry and the font color with the color entry.


       CCeellll  ssiizzee  -  The  size  of the resulting map in pixels. This entry is
       required and cell.out.tiff will exit with an  error  message,  if  this
       field is empty.


       OOuuttppuutt ttiiffff ffiillee - The name and path of the resulting tiff image.


       PPaauussee  ffoorr  aaddddiittiioonnaall  ccoommmmaannddss  - If this check-box is activated, the
       scripts waits for additional display commands  after  the  preview  has
       been created and before the D_Cell map is exported.


       PPrreevviieeww	oonnllyy  - If this check-box is activated, no export file is cre-
       ated and the script terminates after the preview.

NNootteess
       Cell.out.tiff is a shell script, so it can easily be modified  to  suit
       your needs.

BBuuggss
       The script doesn't terminate proper, when the kill button is used.

SSeeee AAllssoo
       _d_._a_r_e_a_,

       _r_._o_u_t_._t_i_f_f

AAuutthhoorr
       R. Brunzema, Germany



       _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						      cell.out.tiff(1)
