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 commands 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  poly-
       gons -> 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  dis-
       played, 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 com-
       mand, 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 auto-
       matically done, if the maps are chosen  with  the  raster-
       button) These raster maps can be used as overlays by acti-
       vating 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 second 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 colors for the maps with the next entry: Vector
       display colors.


       SSiittee mmaappss - Display site markers with the d.sites command.
       The  parameters	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 acti-
       vated,  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 created and the script terminates after	the  pre-
       view.

NNootteess
       Cell.out.tiff is a shell script, so it can easily be modi-
       fied 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)
