## Name

cell.out.tiff - Plots maps with the Cell Driver and exports them as a tiff-image.

## Description

cell.out.tiff 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 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.

## Entries

Background color - 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.

Raster maps
Base raster map - A raster map put in the background with d.rast.

Additional raster maps - 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 overlays by activating the overlay-button. This option is similar to the overlay option of d.rast.

Vector maps
Vector polygon maps - 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.

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

Site maps - 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.

Legend - 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.

Cell size - 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.

Output tiff file - The name and path of the resulting tiff image.

Pause for additional commands - 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.

Preview only - If this check-box is activated, no export file is created and the script terminates after the preview.

## Notes

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

## Bugs

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

## See Also

d.erase,
d.rast,
d.area,
d.vect,
d.sites,
d.legend,
r.out.tiff

## Author

R. Brunzema, Germany

Last changed: $Date: 2002/01/25 05:45:32 $