.TH CLUSTER 1 "Version 1.0" "Lessa GIS" "Lessa user manual"
.SH NAME
cluster \- fills each contour on raster map with its own color
.SH SYNOPSIS
.B cluster 
[-v] [-f] 
.I input_file 
[-o 
.I output_file
] [-c 
.I line_color
] [-T 
.I temp_dir]
.SH DESCRIPTION
Paints each area in 
.B epp
file, surrounded by color
.I line_color
by unique color from 1 to maximal contour number. Can handle up to 65535 contours in file.
.PP
Requires at least three time more space in temporary directore then input file occupies.
.PP 
By default assumes that line color is 0 and output file name
.I cluster.out.epp
.PP
Performs two passes on input file and between them prints to stdout information about
number of contours in output file and temporary numbers assigned when calculating 
contours. So, redirect standard output, if start cluster in background mode.
.SH OPTIONS
.TP 8
.B \-v
Verbose mode. Information about current line in processing is printed to stderr.
.TP 8
.BI \-c " line_color"
\- Set contour separation color to
.I " line_color".
.TP 8
.BI \-o " output_file"
\- overrides default name of output file.
.TP 8
.BI \-f " input_file"
\- Equivalent of simple command-line parameter without option prefix.
.TP 8
.I "-?" " -h"
\- Print brief help message and exit successifully.
.TP 8
.BI \-T " directory" 
\- Uses
.I directory 
instead of 
.I /tmp 
for storing temporary files

.SH "SEE ALSO"
.BR lessa (1),
.BR mappaint (1),
.BR mapcopy (1),
.BR eheader (1),
.BR epp (5),
.BR dgt (5)

.SH BUGS
For some unknown reason reports very strange errors (usially page faults) or
produces very strange results, when compilied under DOS. So use unix versions.
.PP
It seems obvouis, that same program must perform 
.B rasterize
operation, but this still not implemented.
.SH AUTHOR
Vitus Wagner,
.B SoftWeyr.