man/cluster.1

   1 .TH CLUSTER 1 "Version 1.0" "Lessa GIS" "Lessa user manual"
   2 .SH NAME
   3 cluster \- fills each contour on raster map with its own color
   4 .SH SYNOPSIS
   5 .B cluster
   6 [-v] [-f]
   7 .I input_file
   8 [-o
   9 .I output_file
  10 ] [-c
  11 .I line_color
  12 ] [-T
  13 .I temp_dir]
  14 .SH DESCRIPTION
  15 Paints each area in
  16 .B epp
  17 file, surrounded by color
  18 .I line_color
  19 by unique color from 1 to maximal contour number. Can handle up to 65535 contours in file.
  20 .PP
  21 Requires at least three time more space in temporary directore then input file occupies.
  22 .PP
  23 By default assumes that line color is 0 and output file name
  24 .I cluster.out.epp
  25 .PP
  26 Performs two passes on input file and between them prints to stdout information about
  27 number of contours in output file and temporary numbers assigned when calculating
  28 contours. So, redirect standard output, if start cluster in background mode.
  29 .SH OPTIONS
  30 .TP 8
  31 .B \-v
  32 Verbose mode. Information about current line in processing is printed to stderr.
  33 .TP 8
  34 .BI \-c " line_color"
  35 \- Set contour separation color to
  36 .I " line_color".
  37 .TP 8
  38 .BI \-o " output_file"
  39 \- overrides default name of output file.
  40 .TP 8
  41 .BI \-f " input_file"
  42 \- Equivalent of simple command-line parameter without option prefix.
  43 .TP 8
  44 .I "-?" " -h"
  45 \- Print brief help message and exit successifully.
  46 .TP 8
  47 .BI \-T " directory"
  48 \- Uses
  49 .I directory
  50 instead of
  51 .I /tmp
  52 for storing temporary files
  53
  54 .SH "SEE ALSO"
  55 .BR lessa (1),
  56 .BR mappaint (1),
  57 .BR mapcopy (1),
  58 .BR eheader (1),
  59 .BR epp (5),
  60 .BR dgt (5)
  61
  62 .SH BUGS
  63 For some unknown reason reports very strange errors (usially page faults) or
  64 produces very strange results, when compilied under DOS. So use unix versions.
  65 .PP
  66 It seems obvouis, that same program must perform
  67 .B rasterize
  68 operation, but this still not implemented.
  69 .SH AUTHOR
  70 Vitus Wagner,
  71 .B SoftWeyr.